On August 10, 2022, we announced a change to country targeting for shopping products with the introduction of the feedLabel field. We’d like to update you on the progress of this change. Here are our previous announcements:
What’s already changed Google Ads: Any Google Ads account can set the
feed_label field in
ShoppingSetting for Shopping and Performance Max campaigns. You can set
feed_label in the Google Ads UI and the Google Ads API.
Merchant Center & Content API: As of September 14th, 2022 we‘ve started the gradual rollout of feed labels in the Merchant Center UI. When this feature is enabled in the UI, merchants will be able to create a new feed with
feed label set to any valid string. See
Use feed labels to advertise products from specific feeds for more information.
In the Content API, you might see the following:
- Products that have only
feedLabel, and not targetCountry, if they were added in the Merchant Center UI. - Products with feed labels that aren’t two-letter country codes.
You can now use
Products.update to update products by
feedLabel. For example, if you had a product with
offerId of “111111111” and a
feedLabel set to “WINTERPRODUCTS”, you can now update attributes such as
salePrice for that product by making the following call:
HTTP request:
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/online:en:WINTERPRODUCTS:1111111111
Example request body:
{
"salePrice": {
"value": "17.99",
"currency": "USD"
}
}
Behavior summary: Here’s a clarification of the current API behavior for
feedLabel:
- Insertion: You can only call
Products.insert on products with a matching feedLabel and targetCountry. Currently, Products.insert might return an error if you don’t provide a matching targetCountry. This behavior hasn’t changed if you continue to use only targetCountry. - Targeting: If you set
feedLabel to a valid 2-letter CLDR territory code, you must still set the shipping attribute of the products resource to the same country in order to target that country. For example, if you set a new feedLabel to “US”, you must also set the country field in the shipping attribute to “US”. If you don’t set both fields, the product might not be eligible to serve in that country. You can configure targeting for an entire feed in the Merchant Center UI. - Get/List: When you use
Products.list or Products.get, you might see products that only have feedLabel (and not targetCountry) set if they were added in the Merchant Center UI. - Product IDs: Once a
feedLabel is set for a product it becomes part of the product Id. This means you can’t modify the feedLabel for that product (this is similar to how language works). If you wish to change the feedLabel you will need to create a new product with a different product Id.
What’s coming next Products:Once the gradual rollout of feed labels in the Merchant Center UI is complete, we will accept
Products.insert calls with
feedLabel set to any string. At this point, including
targetCountry will become optional.
Datafeeds:In late September, we will also update the
datafeeds resource to include feedLabel in the Content API for Shopping.
Opt out of receiving products and datafeeds without a countryIf you’re concerned your codebase cannot handle products and datafeeds without a country, and you want to opt out of receiving them via the Content API for Shopping, fill out the following form:
Feed label replaces target country in the Content API for Shopping - temporary exemption. When you’re ready to support
feedLabel, you can opt back in to receiving these offers.
If you have any questions about this change, please visit the
Content API for Shopping forum.
Ian Ballantyne, Content API for Shopping Team
- Trevor Mulchay, Display & Video 360 API Team
Thanet Knack Praneenararat, on behalf of the Google Ads API Team
- Devin Chasanoff, on behalf of the Google Ads API Team
- Jonathon Imperiosi, Google Publisher Tags Team
- David Stevens, Google Ads API Product Manager
- Eric Leichtenschlag, Mobile Ads Developer Relations