This article provides details about the two ways in which you can create a promotion.
You must create promotions to provide details about offers that you want to share with customers on Google. When you add promotions to products that you sell on Google, customers view a 'special offer' link (e.g. 15% off, free delivery and more).
Learn more about promotions best practices.
Option 1: Use the promotion builder
The promotion builder is located in the Promotions Dashboard of your Merchant Center account. It allows you to manually enter individual promotions. Use the promotion builder if you have a small number of promotions to submit.
To add promotions manually, follow the steps below:
- In your Merchant Center account, click Marketing in the navigation menu, then click Promotions.
- Click the plus button
.
- Select the country and language for the promotion. The country that you select determines the currency for the prices shown in the promotion.
- Select the destination for which you want to show the promotion: Shopping ads, free listings or local inventory ads. You can select more than one destination.
- Select the promotion categories that best fit your promotion.
- Follow the prompts, then click Save.
The promotion builder supports the following promotion categories:
- Amount off: Offer a monetary discount for your items
- Percent off: Offer a percentage discount for your items
- Free gift: Offer a free gift based on an item purchase or amount spent
- Free delivery: Offer free delivery based on an item purchase or amount spent (not available for local inventory ads).
The promotion builder allows you to specify spend thresholds, discount amounts, gift descriptions and more. After you've selected your promotion category, the tool will display all of the applicable options for your promotion. Follow the prompts and guides to create your promotion.
If you choose to apply your promotions to specific products in your products feed, choose Create custom filters based on product attributes in the promotion builder. This option allows you to select specific collections of offers from your product feed to either exclude or include in your promotions. You can specify the items that should have a promotion applied through any of the following attributes:
- ID
[id]or item ID[item_id] - Product type
[product_type] - Brand
[brand] - Item group ID
[item_group_id]
If local inventory ads are the destination for your promotion:
- Provide a link to your promotion detail page during setup. The promotion link is used to verify the redeemability and validity of the local promotion.
- Select your Google Business Profiles during setup to determine which Business Profiles are eligible for the promotion. You can choose all Business Profiles or limit it to specific shop codes.
Follow the steps above for the promotions that you want to create in the promotion builder. If you create promotions using the promotion builder, you can still upload promotions using a promotions feed (view Option 2 below).
All promotions will appear in your dashboard.
Option 2: Create a promotions feed
A promotions feed is a spreadsheet that contains all the promotions that you use online. Use a promotions feed if you have a high volume of promotions to submit.
To get started, you'll need to create a spreadsheet (e.g. .txt file, .xml file or Google Sheets). To learn more, click Promotions feeds in the top right-hand corner of your Promotions Dashboard. For complete details, refer to the promotions feed specification. To make changes to an existing promotion, refer to edit a promotion or change promotion status.
To express interest in the promotions programme, fill in the Merchant Center promotions form. If you already have promotions feeds for other providers, you can set up rules to transform existing data to match our Product Feed Specification requirements. Learn more about how to set up feed rules.
Review feed processing results
You're able to review the results of all feed processing for file-based or Google Sheets-based feeds. To find the results:
- In your Merchant Center account, click Marketing in the navigation menu, then click Promotions.
- Click on Promotions feeds in the top right-hand corner of your Promotions Dashboard.
- Click the promotions feed name that you'd like to review.
- Review the results:
- Properties: This includes key feed properties, which vary depending on the input method of the feed. Here, you can find attributes such as input method, time zone, file size, detected delimiter (if applicable) and more.
- Attributes: Depending on which Merchant Center programme your feed is opted into, we require attributes to adhere to the product data specification. In this section, you can review all of the attributes we found in your feed, including those attributes which are recognised and map to the feed specification, as well as unrecognised attributes which don't match any of those listed in the product data specification. You may review the list and use tools, such as feed rules, to tell Merchant Center which unrecognised attribute you'd like to use to populate a Google attribute. For example, you may want to use the value that you've submitted for the product name
[product_name]in the title[title]attribute. - Processing data: In this section, you can review the amount of items found in your feed and those with any detected item issues. Review the list of item issues to understand how many items in your feed are impacted, including examples and links to documentation to address the issue.
Option 3: Use the Content API for promotions
You can share and manage your promotions data with Google using the Content API.
The Content API is available to merchants in the following countries. The table below shows the mapping of the target country in which the promotion can be made available to the languages that are supported in that country.
| Country | Supported languages |
|---|---|
| Australia | English |
| Brazil | Portuguese and English |
| Canada | English and French |
| France | French and English |
| Germany | German and English |
| India | English |
| Italy | Italian and English |
| Japan | Japanese and English |
| Netherlands | Dutch and English |
| South Korea | Korean and English |
| Spain | Spanish and English |
| United Kingdom | English |
| United States | English |
Learn more about getting started with the Content API for Shopping.
Option 4: Use promotions from third-party partners (the US only)
If you have a Shopify or WooCommerce account, you can connect your product discounts from these platforms to your Merchant Center account to show your promotions for your products on Google. You don't have to create your promotions through your Merchant Center account if you use this feature. Learn more about creating and managing promotions with third-party partners.