Data source specifications for local promotions

• The promotion ID is case sensitive. If you're mapping a specific promotion to a set of products in your products data source, it must match exactly in both data sources.
• The promotion ID should not contain spaces or symbols (for example, %, !, etc.).
• To add multiple promotion ID values to an item (you can add up to 10 per item), submit them separated by commas in the “promotion id” column in your products data source.
• A promotion ID cannot be longer than 60 characters.

• All products [all_products]
• Specific products [specific_products]

• If the value is set to specific_products, then product targeting attributes will be used to determine to which products the promotion applies (check Optional attributes below to learn about product targeting).
• If the value is set to all_products, then product targeting filters will be ignored.

• No code [no_code]
• Generic code [generic_code]

• It is required if the coupon code required [offer_type] attribute is set to generic_code.
• The value submitted for the generic redemption code [generic_redemption_code] attribute should not exceed 20 characters.

• The promotion title [long_title] should describe the promotion completely and accurately.
• It should not exceed 60 characters.

• Date format: YYYY-MM-DD
• Time format: HH:MM:SS, not including the adjustment relevant to GMT (check below).
  • Times are based on GMT (Greenwich Mean Time). Therefore, you also have to include the number of hours and minutes (+HH:MM or -HH:MM) your time differs from GMT, immediately afterwards.
    • For example, if your promotion time is in PST (Pacific Standard Time), you would add “-08:00” since PST is 8 hours earlier than GMT.
• Dates and times should be separated by the letter “T”.
• List the start date + time first, followed by the end date + time, separating them by a forward slash (/).

• If your promotion was valid from 3:00 a.m. on July 19th, 2019 to 9:00 p.m. on July 26th, 2019 EST (Eastern Standard Time) you would submit:
  • 2019-07-19T03:00:00-05:00/2019-07-26T21:00:00-05:00
• If your promotion was valid from 3:00 a.m. on July 19th, 2019 to 9:00 p.m. on July 26th, 2019 GMT (Greenwich Mean Time) you would submit:
  • 2019-07-19T03:00:00+00:00/2019-07-26T21:00:00+00:00

• Remember to adjust for Daylight Savings when applicable:
  • In Standard time, “-05:00” represents EST while “-08:00” represents PST.
  • During Daylight Savings, “-04:00” represents EDT while “-07:00” represents PDT.

• in_store
• online
• online_and_in_store

• If you have an omnichannel promotion (available both in store and online), submit the value as “online_and_in_store”.
• If this value is left empty, your promotion will default to online.
  • Online promotions will not be restricted to the region store radius, and will appear on your online Shopping ads.

• all_stores
• specific_stores

• If specific_stores is selected, you must also use either the store codes inclusion [store_codes_inclusion] attribute or the store codes exclusion [store_codes_exclusion] attribute.
• If all_stores is selected, the attributes store codes inclusion and store codes exclusion (check below) will be ignored.

• promotion_destination: local_inventory_ads
• promotion_destination: Shopping_ads
• promotion_destination: Buy_on_Google_listings
• promotion_destination: Free_listings

• If your promotion applies to specific_stores, list those store codes as submitted to your Business Profiles.
• You may use either the store codes inclusion [store_codes_inclusion] or store codes exclusion [store_codes_exclusion] attribute, but not both simultaneously.

• If your promotion excludes specific_stores, list those store codes as submitted to your Business Profiles.
• You may use either the store codes exclusion [store_codes_exclusion] or store codes inclusion [store_codes_inclusion] attribute, but not both simultaneously.

If the products eligible for promotion [product_applicability] attribute for your promotions is set to specific_products, setting this item ID attribute will map your promotion to the items represented by the associated IDs in your products data source.

• Up to 20 product item IDs can be mapped to a single promotion in your promotions source.
• Don't use the product ID for promotion [item_id] attribute if you want to assign your promotion to more than 20 items. Instead, add the promotion ID directly to the items in your products data source.

• Do not set this attribute if there are any exclusions within the category. If that is the case, you will need to manually map the promotion ID [promotion_id] to the eligible items in your products data source, or use the product ID for promotion [item_id] attribute (check above) to map the eligible items in your promotions source. For additional mapping details visit the Choose products for your promotion article in our promotions implementation guide.
• The highest level categories, like Apparel & Accessories (166) or Media (783), are not supported. If your products fall under one of these, you’ll need to provide a category that’s more granular. For example: Apparel & Accessories > Clothing > Activewear > Bicycle Activewear (5697).

• Do not set this attribute if there are any exclusions within the product type(s). If that is the case, you will need to manually map the promotion ID [promotion_id] to the eligible items in your products data source, or use the product ID for promotion [item_id] attribute (check above) to map the eligible items in your promotions source (for up to 20 items). For additional mapping details visit the Choose products for your promotion article in our promotions implementation guide.

• Do not set this attribute if there are any eligible items within the category. If that is the case, you will need to manually map the promotion ID [promotion_id] to the eligible items in your products data source, or use the product ID for promotion [item_id] attribute (check above) to map the eligible items in your promotions source (for up to 20 items). For additional mapping details visit the Choose products for your promotion article in our promotions implementation guide.

• Up to 10 product types can be specified. Separate each product type listed with a comma.
• Do not set this attribute if there are any eligible items within the product type(s). If that is the case, you will need to manually map the promotion ID [promotion_id] to the eligible items in your products data source, or use the product ID for promotion [item_id] attribute (check above) to map the eligible items in your promotions source (for up to 20 items). For additional mapping details visit the Choose products for your promotion article in our promotions implementation guide.

• Up to 10 brands can be specified. Separate each brand listed with a comma.
• Brands are space and case sensitive, and must match the exact spelling in your products data source.
• Do not set this attribute if there are any eligible items within the brand(s). If that is the case, you will need to manually map the promotion ID [promotion_id] to the eligible items in your products data source, or use the product ID for promotion [item_id] attribute (check above) to map the eligible items in your promotions source (for up to 20 items). For additional mapping details visit the Choose products for your promotion article in our promotions implementation guide.

• Acceptable keys: google_product_category, product_type, brand
• Format: {attribute1: “valueA”, attribute2: “valueB”}
• Maximum length is 500 characters.

• {brand: “Nike”, google_product_category: “Apparel & Accessories > Shoes”}

Important:

• The promotion tags [promotion_tags] attribute should be used when the promotion applies to a subset (but not all) of the items in a category, type, or brand, and the specific item IDs are not known.