Edit

Share via

PromotionOccasion Value Set - Campaign Management

  • Article

Defines the possible types of promotion occasions.

Both the PromotionOccasion and Scheduling elements determine when the promotion is eligible to be shown in ads.

The PromotionOccasion determines the time period or seasonality e.g., WomensDay from February 15 through March 31 each year. The promotion will only run within the dates corresponding to the occasion that you set. See PromotionOccasion for details about the defined date range for each occasion.

The Scheduling can limit the promotion to a shorter timeframe within the occasion's date range e.g., limit the promotion to run from February 20 through March 8. The Scheduling can also be used to run the same promotion multiple years e.g., run the WomensDay promotion every year from February 15 through March 31.

Syntax

<xs:simpleType name="PromotionOccasion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="Unknown" />
    <xs:enumeration value="NewYears" />
    <xs:enumeration value="ValentinesDay" />
    <xs:enumeration value="Easter" />
    <xs:enumeration value="MothersDay" />
    <xs:enumeration value="FathersDay" />
    <xs:enumeration value="LaborDay" />
    <xs:enumeration value="BackToSchool" />
    <xs:enumeration value="Halloween" />
    <xs:enumeration value="BlackFriday" />
    <xs:enumeration value="CyberMonday" />
    <xs:enumeration value="Christmas" />
    <xs:enumeration value="BoxingDay" />
    <xs:enumeration value="None" />
    <xs:enumeration value="IndependenceDay" />
    <xs:enumeration value="NationalDay" />
    <xs:enumeration value="EndOfSeason" />
    <xs:enumeration value="WinterSale" />
    <xs:enumeration value="SummerSale" />
    <xs:enumeration value="FallSale" />
    <xs:enumeration value="SpringSale" />
    <xs:enumeration value="Ramadan" />
    <xs:enumeration value="EidAlFitr" />
    <xs:enumeration value="EidAlAdha" />
    <xs:enumeration value="SinglesDay" />
    <xs:enumeration value="WomensDay" />
    <xs:enumeration value="Holi" />
    <xs:enumeration value="ParentsDay" />
    <xs:enumeration value="StNicholasDay" />
    <xs:enumeration value="ChineseNewYear" />
    <xs:enumeration value="Carnival" />
    <xs:enumeration value="Epiphany" />
    <xs:enumeration value="RoshHashanah" />
    <xs:enumeration value="Passover" />
    <xs:enumeration value="Hanukkah" />
    <xs:enumeration value="Diwali" />
    <xs:enumeration value="Navratri" />
    <xs:enumeration value="Songkran" />
    <xs:enumeration value="YearEndGift" />
  </xs:restriction>
</xs:simpleType>

Values

The PromotionOccasion value set has the following values: BackToSchool, BlackFriday, BoxingDay, Carnival, ChineseNewYear, Christmas, CyberMonday, Diwali, Easter, EidAlAdha, EidAlFitr, EndOfSeason, Epiphany, FallSale, FathersDay, Halloween, Hanukkah, Holi, IndependenceDay, LaborDay, MothersDay, NationalDay, Navratri, NewYears, None, ParentsDay, Passover, Ramadan, RoshHashanah, SinglesDay, Songkran, SpringSale, StNicholasDay, SummerSale, Unknown, ValentinesDay, WinterSale, WomensDay, YearEndGift.

Value Description
BackToSchool The "Back to School" promotion can run anytime according to your ad extension scheduling.
BlackFriday The "Black Friday" promotion can run from October 15 through December 15.
BoxingDay The "Boxing Day" promotion can run from December 15 through January 15.
Carnival The "Carnival" promotion can run from February 1 through March 31.
ChineseNewYear The "Chinese New Year" promotion can run from January 15 through March 1.
Christmas The "Christmas" promotion can run from November 1 through January 15.
CyberMonday The "Cyber Monday" promotion can run from October 15 through December 15.
Diwali The "Diwali" promotion can run from September 1 through December 1.
Easter The "Easter" promotion can run from March 1 through April 30.
EidAlAdha The "Eid al-Adha" promotion can run anytime according to your ad extension scheduling.
EidAlFitr The "Eid al-Fitr" promotion can run anytime according to your ad extension scheduling.
EndOfSeason The "End of Season" promotion can run anytime according to your ad extension scheduling.
Epiphany The "Epiphany" promotion can run from December 15 through January 31.
FallSale The "Fall Sale" promotion can run anytime according to your ad extension scheduling.
FathersDay The "Father's Day" promotion can run anytime according to your ad extension scheduling.
Halloween The "Halloween" promotion can run from October 1 through November 15.
Hanukkah The "Hanukkah" promotion can run from November 15 through January 31.
Holi The "Holi" promotion can run from February 1 through March 31.
IndependenceDay The "Independence Day" promotion can run anytime according to your ad extension scheduling.
LaborDay The "Labor Day" promotion can run from April 15 through September 15.
MothersDay The "Mother's Day" promotion can run anytime according to your ad extension scheduling.
NationalDay The "National Day" promotion can run anytime according to your ad extension scheduling.
Navratri The "Navratri" promotion can run from September 15 through October 31.
NewYears The "New Year's" promotion can run from December 1 through February 28.
None The promotion can run anytime according to your ad extension scheduling.
ParentsDay The "Parent's Day" promotion can run from April 15 through August 1.
Passover The "Passover" promotion can run from February 15 through May 1.
Ramadan The "Ramadan" promotion can run anytime according to your ad extension scheduling.
RoshHashanah The "Rosh Hashanah" promotion can run from August 15 through November 1.
SinglesDay The "Single's Day" promotion can run from October 15 through November 30.
Songkran The "Songkran" promotion can run anytime according to your ad extension scheduling.
SpringSale The "Spring Sale" promotion can run anytime according to your ad extension scheduling.
StNicholasDay The "St. Nicholas Day" promotion can run from November 1 through December 31.
SummerSale The "Summer Sale" promotion can run anytime according to your ad extension scheduling.
Unknown Reserved for future use.
ValentinesDay The "Valentine's Day" promotion can run from January 15 through February 28.
WinterSale The "Winter Sale" promotion can run anytime according to your ad extension scheduling.
WomensDay The "Women's Day" promotion can run from February 15 through March 31.
YearEndGift The "Year-End Gift" promotion can run anytime according to your ad extension scheduling.

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Used By

PromotionAdExtension