PromotionOccasion Value Set - Campaign Management

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