Add structured data attributes

This article lists all of the structured data attributes you can provide in your promotions feed.

Optional structured data fields are attributes that provide additional information about your promotion type (e.g. 10% off and buy one, get one free). Structured data allows Google to display more detailed information about your Shopping ad promotions to shoppers on mobile devices.

Note: All structured data attributes you submit must match information in your promotion's long_title. During the review process, Google validates your data. If information does not match the long_title, Google will edit the structured fields to match the information in the long_title. If you don't submit the structured data for your promotion, Google attempts to structure your promotion based on the long_title.

The coupon_value_type structured attribute

When included in your promotions feed, this optional attribute signals the type of promotion benefit you’re offering, allowing Google to perform a more automated review process, which can expedite your promotion’s approval. Structured data also allows Google to display more detailed information about your Shopping ad promotions to shoppers on mobile devices.

When you use the optional coupon_value_type attribute, the value submitted may require the use of additional attributes (to provide the information needed for your promotion). For example, money_off requires that you also use the money_off_amount attribute.

The required and optional attributes to be included in your promotions feed, depending on the coupon_value_type value used, are shown in the following table and described in more detail further below.

Note: You can still submit structured data attributes without using the coupon_value_type attribute.
Promotion benefit type [coupon_value_type value] Attributes

No structured data [no structured data]

  • Indicates you are not submitting any of the promotion benefit types listed below.

Optional

minimum_purchase_amount, buy_this_quantity, limit_quantity, promotion_price, money_off_amount, percent_off, get_this_quantity_discounted, free_gift_value, free_gift_item_id, free_gift_description

Money off [money off]

  • Example: $200 off

Required

money_off_amount

Optional

minimum_purchase_amount

Percent off [percent off]

  • Example: 10% off

Required

percent_off

Optional

minimum_purchase_amount

Buy M get N money off [buy m get n money off]

  • Example: Buy 4 shirts, get 5th shirt $10 off

Required

money_off_amount, buy_this_quantity, get_this_quantity_discounted

Buy M get N percent off [buy m get n percent off]

  • Example: Buy one, get one free; or buy 2 books, get 3rd 20% off

Required

percent_off, buy_this_quantity, get_this_quantity_discounted

Buy M get money off [buy m get money off]

  • Example: $60 off purchase of 5+ summer tops

Required

money_off_amount, buy_this_quantity

Buy M get percent off [buy m get percent off]

  • Example: Buy 2 beauty items, save 15%

Required

percent_off, buy_this_quantity

Free gift [free gift]

  • Example: Free beach tote bag and blanket

Required

free_gift_description

Optional

minimum_purchase_amount, buy_this_quantity

Free gift with value [free gift with value]

  • Example: Free gift ($30 value)

Required

free_gift_value

Optional

minimum_purchase_amount, buy_this_quantity

Free gift with item ID [free gift with item id]

  • Example: Free gift when you buy battery charger

Required

free_gift_item_id

Optional

minimum_purchase_amount, buy_this_quantity

Free standard shipping [free shipping standard]

Optional

free_shipping_type, minimum_purchase_amount, buy_this_quantity

Free overnight shipping [free shipping overnight]

Optional

free_shipping_type, minimum_purchase_amount, buy_this_quantity

Free 2-day shipping [free shipping two day]

Optional

free_shipping_type, minimum_purchase_amount, buy_this_quantity

Free shipping for shipping services defined in Merchant Center [free shipping with shipping config]

Learn more about configuring shipping services in Set up shipping services

No required or optional attributes

Attribute details

Buy this quantity [buy_this_quantity]

The minimum purchase quantity required to redeem promotions offering "Buy M, get N." This field represents the "M" value for the offer.

  • Example promotion: Buy 2, get one free
    • buy_this_quantity: 2
    • get_this_quantity_discounted: 1
    • percent_off: 100
  • Example promotion: Buy 4, get $100 off
    • buy_this_quantity: 4
    • money_off_amount: 100
Free shipping type [free_shipping_type]

For promotions offering free shipping, this attribute indicates the type of free shipping offered.

  • Valid values
    • free shipping standard
    • free shipping overnight
    • free shipping two day
Free gift value [free_gift_value]

The monetary value of any free gift offered in the promotion.

  • Example (US): 50 USD
  • Example (IN): 600 INR
  • Example (AU): 20 AUD
  • Example (FR/DE): 10 EUR
  • Example (GB): 25 GBP

Important: include currency in this attribute. The price attribute must be formatted correctly. Learn more about price attribute requirements

Free gift description [free_gift_description]

The description of any free gift offered in the promotion.

Important: The description can not contain more than 100 characters.

Free gift item id [free_gift_item_id]

The item_id of any free gift offered in the promotion.

Important: The item_id will match to the targeting_channel specified. The id attribute must be formatted correctly. Learn more about price attribute requirements

Get this quantity discounted [get_this_quantity_discounted]

The quantity discounted once the minimum quantity required to purchase has been met in "Buy M, get N discounted" promotions. This field represents the "N" value of the offer.

  • Example promotion: Buy 2, get 3rd one $5 off
    • get_this_quantity_discounted: 1
    • buy_this_quantity: 2
    • percent_off: 100
Limit quantity [limit_quantity]

The maximum number of items that can be bought using the promotion.

  • Example: 5

Important: Must be an integer.

Limit value [limit_value]

The maximum item value allowed for the promotion.

  • Example (US): 50.00 USD

Important: Must be a number and specify currency.

Minimum purchase amount [minimum_purchase_amount]

The minimum purchase amount for the promotion to be redeemed.

  • Example (US): 20 USD

Important: Promotion feeds only support currencies of the specified locales.

Money off amount [money_off_amount]

The monetary value discounted for fixed discount promotions (for example: $200 off)

Important: Do not include the currency.

Percent off [percent_off]

The percent discounted for percentage-based promotions (for example: 10 % off).

Important: Do not include the percent symbol.

Promotion price [promotion_price]

The promotional sales price of an item or category.

  • Example (US): 75.00 USD

Important: Must be a number and specify currency.

Was this helpful?
How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
Search Help Center
true
71525
false