Search
Clear search
Close search
Google apps
Main menu
true

Add structured data attributes

This article lists all of the structured data attributes that 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 that you submit must match information in your promotion's long_title [long_title]. During the review process, Google validates your data. If information does not match the long_title [long_title], Google will edit the structured fields to match the information in the long_title [long_title]. If you don't submit the structured data for your promotion, Google attempts to structure your promotion based on the long_title [long_title].

Promotion benefit types and attributes

The promotion benefit type determines the specific kind of offering that your promotion will provide and the corresponding structured data attribute that you include in your feed.

Promotion benefit type Attribute
Percent off (e.g. 10% off) percent_off [percent_off]

Money off (e.g. £200 off)

money_off_amount [money_off_amount]

Buy M get money off (e.g. £60 off 

purchase of 5+ summer tops)

buy_this_quantity [buy_this_quantity]

money_off_amount [money_off_amount]

Buy M get percent off (e.g. buy 2

beauty items, save 15%)

buy_this_quantity [buy_this_quantity]

percent_off [percent_off]

Buy M get B money off (e.g. buy 4

shirts, get 5th shirt £10 off)

buy_this_quantity [buy_this_quantity]

get_this_quantity_discounted [get_this_quantity_discounted]

money_off_amount [money_off_amount]

Buy M get N percent off (e.g. buy one, get one

free; or buy 2 books, get 3rd 20% off)

buy_this_quantity [buy_this_quantity]

get_this_quantity_discounted [get_this_quantity_discounted]

percent_off [percent_off]

Free standard, overnight or 2-day shipping free_shipping [free_delivery]

Free gift (e.g. free beach tote bag and blanket

(£30 value)

Provide one of the following, depending

on the details of your free gift promotion:

free_gift_value [free_gift_value]

free_gift_description [free_gift_description]

free_gift_item_id [free_gift_item_id]

 

Attribute details

percent_off [percent_off]

The percent discounted for percentage-based promotions (e.g.10 % off).

Important: Do not include the percent symbol.

money_off_amount [money_off_amount]

The monetary value discounted for fixed discount promotions (e.g. £200 off)

Important: Do not include the currency. 

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 two, get one free
    • buy_this_quantity [buy_this_quantity]: 2
    • get_this_quantity_discounted [get_this_quantity_discounted]:1
    • percent_off [percent_off]: 100
       
  • Example promotion: Buy 4, get £100 off
    • buy_this_quantity [buy_this_quantity]: 4
    •  money_off [money_off]: 10
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 two, get third one £5 off
    • get_this_quantity_discounted[get_this_quantity_discounted]: 1
    • buy_this_quantity [buy_this_quantity]: 2
    • percent_off [percent_off]: 100

                             

free_shipping [free_delivery]

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

  • Valid values
    • FREE_DELIVERY_STANDARD
    • FREE_DELIVERY_OVERNIGHT

FREE_DELIVERY_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 cannot contain more than 100 characters. 

free_gift_item_id [free_gift_item_id]

The item id [item id] of any free gift offered in the promotion.

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

Was this article helpful?
How can we improve it?
false