Promotions data source formatting and attributes FAQs

Your promotions data source contains the details about the promotions you want to show on Google. This article provides answers to common questions about creating, submitting, and updating your promotions data source.

What fields of the promotions data source (attributes) are required?

The following data source attributes are required:

  • Promotion ID [promotion_id]
  • Products eligible for promotion [product_applicability]
  • Coupon code required [offer_type]
  • Promotion title [long_title]
  • Promotion start date [promotion_effective_dates]
  • Online eligibility for promotion [redemption_channel]

Visit our Promotions data source specification article for more details and guidelines.

Why am I getting a "server error" message when I'm uploading my promotions data source?

There are 2 main reasons for “server error” messages:

How do I create a promotion?

Make sure that you’ve enabled the Promotions add-on in your Merchant Center account. Then, create a promotion from the Promotions dashboard or by uploading a promotions data source to your Merchant Center. For more information, view how to create and submit promotions. Your promotions data source must follow the promotions data source specification, editorial requirements, and program policies.

How do I change a promotion?

Promotions that haven't yet been approved can be edited in the promotion builder or by uploading an updated promotions data source. After a promotion has been approved, it's still possible to edit certain information using promotion builder. This article explains how to edit a promotion or change promotion status.

Why am I getting the quota limit error?

You’ve reached the limit on the total number of active promotions in your account.

To ensure a positive user experience and timely reviews for all merchants, Google imposes a quota on the number of active promotions at any given amount of time, and also a quota on the number of promotions that can be submitted in a day.

Learn more about the quota limits on Promotions.

How does Google use the attributes in the data source?

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 start date [promotion_effective_dates] and products eligible for promotion [product_applicability] attributes. When you create and submit a product data source, include the required attributes, plus any conditional attributes that apply to your promotions.

The optional coupon value type [coupon_value_type] attribute signals the type of promotion you’re running, allowing Google to perform a more automated review process, which can expedite promotion approval.

Read the Promotions data source specification for the specific functions of each attribute.

Can I include multiple promotions for the same product in my product data source?

Yes, you may submit multiple promotions for each product in your product data source. Submit the values separated by commas in a tab-delimited file or as unique rows within your XML file. View examples in the table below:

Data source type Instructions Example
.txt

To add multiple promotion ID [promotion_id] attributes to an item, submit the values separated by commas in the "promotion ID" column.

Example:
Replace "PROMO1," "PROMO2," and "PROMO3" with the actual promotion ID [promotion_id] attributes.

PROMO1,PROMO2,PROMO3
XML

To add multiple promotion ID [promotion_id] attributes to an item, insert multiple lines.

Example:
Replace "PROMO1" and "PROMO2" with the actual promotion ID [promotion_id] attributes.

<g:promotion_id>PROMO1</g:promotion_id>
<g:promotion_id>PROMO2</g:promotion_id>
API

To add multiple promotion ID [promotion_id] attributes to an item, insert multiple lines.

Example:
Replace "PROMO1" and "PROMO2" with the actual promotion ID [promotion_id] attributes.

<sc:attribute name="promotion_id">PROMO1</sc:attribute>
<sc:attribute name="promotion_id">PROMO2</sc:attribute>

How many promotions are displayed at one time?

Up to 10 promotion ID [promotion_id] attributes can be mapped to one item in the product data source. Ads and free listings show one promotion per product.

When there are multiple promotions mapped, promotions with the "Specific_products" value for the products available for promotion [product_applicability] attribute are prioritized before promotions with the "All_products" value for the products available for promotion [product_applicability] attribute.

Can I reuse a promotion ID?

If a promotion was rejected during policy review and not stopped, you can reuse the promotion ID [promotion_id]. If the promotion is already approved for policy or is stopped, you can’t reuse the promotion ID.

When do I need to add a promotion ID to the product data source?

If the promotion applies to "Specific products", add the promotion ID [promotion_id] to the "promotion ID" column in the product data source for each product to which the promotion applies. The promotion will be rejected if the promotion ID [promotion_id] isn't mapped in the product data source.

What is the difference between the promotion start date and display dates for promotion attributes and why is it beneficial to use both?

  • Display dates for promotion [promotion_display_dates]: when the promotion is available to the public
  • Promotion start date [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 data source. The promotion start date [promotion_effective_dates] attribute isn't available when using Promotion Builder.

To use this method, specify a start time for the promotion start date [promotion_effective_dates] attribute that’s earlier than the display dates for promotion [promotion_display_dates] attribute. Google will start the test process on the date you specify in your promotion start date [promotion_effective_dates].

The end date of promotion start date [promotion_effective_dates] should match the end date of the display dates for promotion [promotion_display_dates]. If your promotion is approved, it will go live when the display dates for promotion [promotion_display_dates] start time begins.

Make sure your promotion can be tested and works on your website as described.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Main menu
7339918400837944043
true
Search Help Center
true
true
true
true
true
71525
false
false