This article lists all of the structured data attributes you can provide in your promotions source.
Optional structured data fields are attributes that provide additional information about your promotion type (for example, 10% off and buy one, get one free). Structured data allows Google to display more detailed information about your shopping ad promotions to customers on mobile devices.
Note: All structured data attributes you submit must match information in your promotion's promotion title [long_title]
. During the review process, Google validates your data. If information does not match the promotion title, Google will edit the structured fields to match the information in the promotion title. If you don't submit the structured data for your promotion, Google attempts to structure your promotion based on the promotion title.
On this page
The coupon value type structured attribute
When included in your promotions source, 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 customers on mobile devices.
When you use the optional coupon value type [coupon_value_type]
attribute, this may require the use of additional attributes, depending on the value you submit. For example, if you want to submit the money off [money_off]
attribute as the value for the coupon value type [coupon_value_type]
, you must also provide the monetary discount amount of a promotion [money_off_amount]
attribute.
This article and the following table show which attributes are required or optional to include in your promotions source depending on the value you submit for the coupon value type [coupon_value_type]
.
Value for the coupon value type | Attributes |
No structured data
|
Optional
|
Money off
|
Required Monetary discount amount of a promotion Optional Minimum purchase amount |
Percentage discount amount
|
Required Percentage discount amount Optional Minimum purchase amount |
Buy M get N money off
|
Required
|
Buy M get N percent off
|
Required Percentage discount amount |
Buy M get money off
|
Required Monetary discount amount of a promotion |
Buy M get percent off
|
Required Percentage discount amount |
Free gift
|
Required Free gift description Optional Minimum purchase amount |
Free gift monetary value
|
Required Free gift monetary value Optional Minimum purchase amount |
Free gift item ID
|
Required Free gift item ID Optional Minimum purchase amount |
Free standard shipping |
Optional Free shipping type |
Free overnight shipping |
Optional Free shipping type |
Free 2-day shipping |
Optional Free shipping type |
Free shipping for shipping services defined in Merchant Center |
No required or optional attributes |