subscription_cost: Definition

Use the subscription_cost [subscription_cost] attribute to tell users the details of a monthly or annual payment plan that bundles a communications service contract with your mobile product.

This attribute is available only in Germany, France, the United Kingdom and the Republic of Ireland.

When to use

Optional for each product

The subscription_cost [subscription_cost] attribute uses 3 sub-attributes:
  • period [period] (required)
    The duration of a single subscription period. Either 'month' or 'year'.
  • period_length [period_length] (required) 
    Integer, the number of subscription periods (months or years) that the buyer must pay.
  • amount [amount] (required)
    ISO 4217, the amount that the buyer must pay per month. When displaying this amount, we may round up to the nearest whole unit of local currency to save space. The provided value must still exactly match the amount as shown on your site.

Format

Follow these formatting guidelines to make sure that we understand the data that you're submitting. 

Type Unicode characters (Recommended: ASCII only)
Repeated field No
 
File format Example entry
Text feeds

 

Format the value by submitting period, period_length and amount separated by colons ( : ). Don't use quotation marks. For example, for 12 monthly payments of GBP 50 each, submit:


month:12:50 GBP

 

XML feeds

<g:subscription_cost>

  <g:period>month</g:period>

     <g:period_length>12</g:period_length>

  <g:amount>GBP 50</g:amount>

</g:subscription_cost>


For format API information, please see Content API for Shopping.

Guidelines

Follow these guidelines to make sure that you submit high-quality data for your products.

Minimum requirements

These are the requirements that you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know on the Diagnostics page of your Merchant Center account. 

  • Submit the price [price] attribute with the total amount due at checkout (including down payment and activation fee) for the product.
  • Match the communications payment plan that you display on your landing page. You can also display other communication options on your landing page, but the plan that you submit must be easy to find on the landing page.
  • Don't require that users have a loyalty card to choose the service plan that you submit. 
  • Don't use the subscription_cost [subscription_cost] attribute for software subscriptions. Software subscriptions must be prepaid, and submitted using the yearly prepaid cost as the price [price] attribute.

Best practices

These are best practices that can help you go beyond the basic requirements to optimise your product data for performance. 

  • Submit exact values for your subscription costs according to ISO 4217. For example, submit GBP 1.01 instead of GBP 1.0012, otherwise we will round the submitted value. Use the same currency for subscription_cost [subscription_cost], installment [instalment] and price [price].
  • If the product is also paid for in monthly instalments, use the same number of months for the subscription_cost [subscription_cost] as for the instalments. To simplify the customer experience, it is recommended that you use the same number of months for both your repayment instalments and your subscription agreements.

Examples

Example of a mobile phone sold as a stand-alone product

Follow the same standard as other product types to submit a mobile phone offer without a service contract, sold at a fixed price. Leave the installment [instalment] and subscription_cost [subscription_cost] attributes empty, and submit the fixed price (greater than 0) of the mobile device in the price attribute.

Product data for Google Pixel 5" 32 GB Very Silver
Attribute Product Data
id [id] _pixel_phone_silver_32gb
title [title] Google Pixel 5" 32 GB Very Silver
link [link] https://store.google.com/product/pixel_phone?sku=_pixel_phone_silver_32gb
image_link [image_link] https://store.google.com/product/pixel_phone/silver.png
availability [availability]     In Stock
price [price] 649.00 USD
installment [instalment] (Must be empty because there are no instalment payments)
subscription_cost [subscription_cost] (Must be empty because the is no service contract)
google_product_category [google_product_category] Electronics > Communications > Telephony > Mobile phones
brand [brand] Google
gtin [gtin] 00821793049157
mpn [mpn] G-2PW4100-021-B
condition [condition] New
color [colour] Very Silver
shipping [shipping] 0.00 USD

Example of a mobile phone sold with a service contract

Submit a total value for the down payment in the price [price] attribute (as low as 0) and include any activation fees and/or once-off charges. Specify in your title that your mobile product requires a contract of a certain duration. Leave the installment [instalment] attribute empty.

Product data for Google Pixel 5" 32 GB Very Silver, with a 12-month service contract of 35 USD per month and a down payment of 649 USD
Attribute Product Data
id [id] _pixel_phone_silver_32gb_12month_contract
title [title] Google Pixel 5" 32 GB Very Silver (with contract)
link [link] https://store.google.com/product/pixel_phone?sku=_pixel_phone_silver_32gb_12month_contract_newsim&contract=yes
image_link [image_link] https://store.google.com/product/pixel_phone/silver.png
availability [availability] In Stock
price [price] 649.00 USD
installment [instalment] (Must be empty because there are no instalment payments)
subscription_cost [subscription_cost] month:12:35.00 USD
google_product_category [google_product_category] Electronics > Communications > Telephony > Mobile phones
brand [brand] Google
gtin [gtin] 00821793049157
mpn [mpn] G-2PW4100-021-B
condition [condition] New
color [colour] Very Silver
shipping [shipping] 0.00 USD

Example of a mobile phone sold as a stand-alone product in instalments

Submit a total value for the down payment (as low as 0) in the price [price] attribute and include any activation fees and/or once-off charges. Specify in your title that your mobile product is sold with an instalment plan. 

Product data for Google Pixel 5" 32 GB Very Silver, with 12-month instalment plan of 60 USD per month
Attribute Product Data
id [id] _pixel_phone_silver_32gb_instalments
title [title] Google Pixel 5" 32 GB Very Silver (with instalments)
link [link] https://store.google.com/product/pixel_phone?sku=_pixel_phone_silver_32gb_12month_installments&contract=no
image_link [image_link] https://store.google.com/product/pixel_phone/silver.png
availability [availability]     In Stock
price [price] 0.00 USD
installment [instalment] 12:60.00 USD
subscription_cost [subscription_cost] (Must be empty because there is no service contract)
google_product_category [google_product_category] Electronics > Communications > Telephony > Mobile phones
brand [brand] Google
gtin [gtin] 00821793049157
mpn [mpn] G-2PW4100-021-B
condition [condition] New
color [colour] Very Silver
shipping [shipping] 0.00 USD

Example of a mobile phone sold in instalments and bundled with a service contract

Submit a total value for the down payment (as low as 0) in the price attribute and include any activation fees and/or one-time charges. Submit zero in the price [price] attribute if there are no up-front costs. Specify in your title that your mobile product requires a contract of a certain duration and an instalment plan. 

Product data for Google Pixel 5" 32 GB Very Silver with a 12-month contract and paid in 12 monthly instalments
Attribute Product Data
id [id] _pixel_phone_silver_32gb_contract_and_instalments
title [title] Google Pixel 5" 32 GB Very Silver (with contract & SIM, 12 monthly payments)
link [link] https://store.google.com/product/pixel_phone?sku=_pixel_phone_silver_32gb_12month_contract_newsim&contract=yes
image_link [image_link] https://store.google.com/product/pixel_phone/silver.png
availability [availability]     In Stock
price [price] 0.00 USD
installment [instalment] 12:60.00 USD
subscription_cost [subscription_cost] month:12:30.00 USD
google_product_category [google_product_category] Electronics > Communications > Telephony > Mobile phones
brand [brand] Google
gtin [gtin] 00821793049157
mpn [mpn] G-2PW4100-021-B
condition [condition] New
color [colour] Very Silver
shipping [shipping] 0.00 USD

 

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue