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 country
If 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