This article provides answers to common questions about creating, submitting and updating your promotions feed.
Your promotions feed contains the details about the promotions that you want to show on Google.
What fields of the promotions feed (feed attributes) are required?
Visit our promotions feed specifications article for more details and guidelines.
Why am I getting a 'server error' message when I upload my promotions feed?
There are two main reasons for 'server error' messages:
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 programme policies.
Promotions that have not yet been approved can be edited in promotion builder or by uploading an updated promotions feed. Once a promotion has been approved, it is still possible to edit certain information using promotion builder. This article explains how to edit a promotion or change promotion status.
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
generic_redemption_code [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
promotion_effective_dates [promotion_effective_dates] and
product_applicability [product_applicability] attributes. When you create and submit a feed, include the required attributes, plus any conditional attributes that apply to your promotions. See 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
|API||To add multiple
How many promotions are displayed at one time?
promotion_id [promotion_id]codes can be mapped to one item in the products feed.
product_applicability [product_applicability]: promotions with
SPECIFIC_PRODUCTS product_applicability [SPECIFIC_PRODUCTS product_applicability]are prioritised before promotions with
ALL_PRODUCTS product_applicability [ALL_PRODUCTS product_applicability].
Can I reuse a
promotion_id [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 [promotion_id] to the products feed?
SPECIFIC_PRODUCTS [SPECIFIC_PRODUCTS], add the
promotion_id [promotion_id]to the
promotion_id [promotion_id]column in the products feed for each product to which the promotion applies. The promotion will be rejected if the
promotion_id [promotion_id]is not mapped in the products feed.
promotion_display_dates [promotion_display_dates]attributes and why is it beneficial to use both?
promotion_display_dates [promotion_display_dates]:when the promotion is available to the public
promotion_effective_dates [promotion_effective_dates]:when the promotion can be tested on your website
Use both attributes to allow your promotion to go through validation review in advance of its public display date.
Note: This is only possible when uploading your promotion using a promotions feed. The
promotion_effective_dates [promotion_effective_dates] attribute is not available when using promotion builder.
To use this method, specify a start time for the
promotion_effective_dates [promotion_effective_dates] attribute that's earlier than the
promotion_display_dates [promotion_display_dates] attribute. Google will start the test process on the date that you specify in your
promotion_effective_dates [promotion_effective_dates]. The end date of
promotion_effective_dates [promotion_effective_dates] should match the end date of the
promotion_display_dates [promotion_display_dates]. If your promotion is approved, it will go live when the
promotion_display_dates [promotion_display_dates] start time begins.
Make sure that your promotion can be tested and works on your website as described.