Use the coupon value type [coupon_value_type] attribute to signal the type of promotion that you are running. This allows Google to perform a more automated review process, which can expedite the approval of your promotion.
When to use
Optional for all promotions.
Format
Follow these formatting guidelines to ensure that we understand the data that you're submitting.
| Type | Unicode characters (recommended: ASCII only) |
| Repeated field | No |
| File format | Example entry |
| Text feeds | Supported values:
|
| XML feeds | <g:coupon_value_type>no_structured_data</g:coupon_value_type> |
When you use the coupon value type [coupon_value_type] attribute, you may also need to add additional attributes depending on the value you submit. For example, if you submit the value 'money_off', you must also use the monetary discount amount of a promotion [money_off_amount] attribute.
The following list of supported values shows the required and optional attributes for each:
No structured data [no_structured_data]
- Required attributes: None
- Optional attributes: Minimum purchase amount
[minimum_purchase_amount], minimum purchase quantity for promotion[buy_this_quantity], maximum purchase quantity for promotion[limit_quantity], maximum product price for promotion[limit_value], price for promotion[promotion_price], monetary discount amount of a promotion[money_off_amount], percentage discount amount[percent_off], quantity eligible for promotion[get_this_quantity_discounted], free gift monetary value[free_gift_value], free gift item ID[free_gift_item_id], free gift description[free_gift_description]
Money off [money_off]
- Required attributes: Monetary discount amount of a promotion
[money_off_amount] - Optional attributes: Minimum purchase amount
[minimum_purchase_amount]
Percentage discount amount [percent_off]
- Required attributes: Percentage discount amount
[percent_off] - Optional attributes: Minimum purchase amount
[minimum_purchase_amount]
Buy M get N money off [buy_m_get_n_money_off]
- Required attributes: Monetary discount amount of a promotion
[money_off_amount], minimum purchase quantity for promotion[buy_this_quantity], quantity eligible for promotion[get_this_quantity_discounted] - Optional attributes: None
Buy M get N percent off [buy_m_get_n_percent_off]
- Required attributes: Percentage discount amount
[percent_off], minimum purchase quantity for promotion[buy_this_quantity], quantity eligible for promotion[get_this_quantity_discounted] - Optional attributes: None
Buy M get money off [buy_m_get_money_off]
- Required attributes: Monetary discount amount of a promotion
[money_off_amount], minimum purchase quantity for promotion[buy_this_quantity] - Optional attributes: None
Buy M get percent off [buy_m_get_percent_off]
- Required attributes: Percentage discount amount
[percent_off], minimum purchase quantity for promotion[buy_this_quantity] - Optional attributes: None
Free gift [free_gift]
- Required attributes: Free gift description
[free_gift_description] - Optional attributes: Minimum purchase amount
[minimum_purchase_amount], minimum purchase quantity for promotion[buy_this_quantity]
Free gift monetary value [free_gift_with_value]
- Required attributes: Free gift monetary value
[free_gift_value] - Optional attributes: Minimum purchase amount [minimum_purchase_amount], minimum purchase quantity for promotion
[buy_this_quantity]
Free gift item ID [free_gift_with_item_id]
- Required attributes: Free gift item ID
[free_gift_item_id] - Optional attributes: Minimum purchase amount
[minimum_purchase_amount], minimum purchase quantity for promotion[buy_this_quantity]
Free delivery standard [free_shipping_standard]
- Required attributes: None
- Optional attributes: Free delivery type
[free_shipping_type], minimum purchase amount[minimum_purchase_amount], minimum purchase quantity for promotion[buy_this_quantity]
Free delivery overnight [free_shipping_overnight]
- Required attributes: None
- Optional attributes: Free delivery type
[free_shipping_type], minimum purchase amount[minimum_purchase_amount], minimum purchase quantity for promotion[buy_this_quantity]
Free delivery two-day [free_shipping_two_day]
- Required attributes: None
- Optional attributes: Free delivery type
[free_shipping_type], minimum purchase amount[minimum_purchase_amount], minimum purchase quantity for promotion[buy_this_quantity]
Free delivery with delivery config [free_shipping_with_shipping_config]
- Required attributes: None
- Optional attributes: None
To format your data for Content API, refer to the Content API for Shopping resource.
Examples
| A promotion that takes £5 off of your orders | |
| Attribute | Value |
Promotion ID [promotion_id] |
five_dollar_off_friday |
Promotion title [long_title] |
£5 off Friday |
Coupon value type [coupon_value_type] |
money_off |
Monetary discount amount of a promotion [money_off_amount] |
5.00 GBP |