This article provides answers to common questions about creating, submitting, and updating your Promotions feed.
Your Promotions feed tells Google which promotions to distribute on Product Shopping ads on Google.com and Shopping ads.
What fields of the Promotions feed (feed attributes) are required?
Listed below are the required feed attributes:
Visit our Promotions feed specification for more details and guidelines.
Why am I getting a "server error" message when I'm uploading my Promotions feed?
How do I create a promotion?
Create a promotion with the promotion builder in the Promotions dashboard of your Merchant Center or with a Promotions feed. For more information, see how to create and submit promotions. Your Promotions feed must follow the Promotions feed specification, Editorial requirements, and Program policies.
If your promotion policy status is still under review or has been disapproved for policy, edit your promotion using one of these methods:
- Use the promotion builder: Fill in the promotion form with the same
promotion_idand the corrected promotion information, and then submit the form.
- Use your existing Promotions feed: Update your existing Promotions feed and re-upload the Promotions feed to your registered Promotions data feed in Merchant Center. Another option is to submit an additional Promotions feed with only the new promotions. There is no need to change the
If your promotion policy status is already approved: You can't edit a promotion that has already been approved during policy review and/or validation review. You must submit a new promotion with a new
How do I add a budget and/or order limit to a promotion?
How does Google use the attributes in the feed?
Some attributes, like the
generic_redemption_code, are directly reflected in the display of your promotion. Other attributes work in the background to determine where your promotion should be displayed, like the
product_applicability attributes. When you create a feed, submit the required attributes, plus any conditional attributes that apply to your promotions. See the Merchant Promotions feed specifications for the specific functions of each attribute.
Can I include multiple promotions for the same product in my products feed?
Yes, you may submit multiple promotions for each product in your products feed. Submit the values separated by commas in a tab-delimited file or as unique rows within your XML file. See examples in the table below:
|.txt||To add multiple
|XML||To add multiple promotion_id's to an item, insert multiple lines. See example. Replace "PROMO1" and "PROMO2" with the actual promotion_id's.||
|API||To add multiple promotion_id's to an item, insert multiple lines. See example. Replace "PROMO1" and "PROMO2" with the actual promotion_id's.||
How many promotions are displayed at one time?
promotion_ids can be mapped to one item in the products feed.
product_applicability: promotions with
SPECIFIC_PRODUCTS product_applicabilityare prioritized before promotions with
Can I reuse a
promotion_id. If the promotion is already approved for policy or is stopped, you can’t reuse the
When do I need to add a
promotion_id to the products feed?
SPECIFIC_PRODUCTS, add the
promotion_idcolumn in the products feed for each product to which the promotion applies. The promotion will be rejected if the
promotion_idis not mapped in the products feed.
promotion_display_datesattributes and why is it beneficial to use both?
promotion_display_dates:when the promotion is available to the public
promotion_effective_dates:when the promotion can be tested on your website
Use both attributes to allow your promotion to go through the validation review in advance of its public display date.
To use this method, specify a start time for the
promotion_effective_dates attribute that’s earlier than the
promotion_display_dates attribute. Google will start the test process on the date you specify in your
promotion_effective_dates. The end date of
promotion_effective_date should match the end date of the
promotion_display_date. If your promotion is approved, it will go live when the
promotion_display_dates start time begins.
Make sure your promotion can be tested and works on your website as described.
promotion_display_dates attribute can only be used for the Promotions feed. The promotion builder can only use