Search
Clear search
Close search
Google apps
Main menu

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.

Promotion benefit types and attributes

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

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

Money off (e.g. $200 off)

money_off_amount

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

purchase of 5+ summer tops)

buy_this_quantity

money_off_amount

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

beauty items, save 15%)

buy_this_quantity

percent_off

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

shirts, get 5th shirt $10 off)

buy_this_quantity

get_this_quantity_discounted

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

get_this_quantity_discounted

percent_off

Free standard, overnight, or 2-day shipping free_shipping

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_description

free_gift_item_id

 

Attribute details

percent_off

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

Important: Do not include the percent symbol.

money_off_amount

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

Important: Do not include the currency. 

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
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                     
free_shipping

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

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

The description of any free gift offered in the promotion.

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

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. 

Was this article helpful?
How can we improve it?