Google Ads Developer Blog

Display & Video 360 API Annual Developer Survey 2022 is closing soon

Wednesday, 17 August 2022

Annual Display & Video 360 API Developer Survey for 2022 Here is our original blog post for reference.

- Trevor Mulchay, Display & Video 360 API Team

Announcing v202208 of the Google Ad Manager API

Tuesday, 16 August 2022

We're pleased to announce that v202208 of the Google Ad Manager API is available starting today, August 16th. This release adds support for AMP URLs in ThirdPartyCreatives, InventorySizeTargeting in traffic forecasts, and Real-time video reporting. For the full list of changes, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Country targeting in Shopping Ads campaigns is changing in August 2022

Wednesday, 10 August 2022

Feed label replaces target country in Content API for ShoppingContent API for Shoppingfeed_labelShoppingSettingfeed_labelsfeed_label not set to a 2-letter CLDR territory code can serve ads in any country as long as the campaign has the appropriate geoTargeting and the appropriate target countries are set in Merchant Center.

This change doesn’t impact the countries targeted by existing shopping feeds. You don’t need to update existing shopping feeds or campaigns.

What’s changing in Merchant Center
Today, Google Merchant Center feeds require you to select a primary country of sale target (sales_country in Google Ads API), with the option to provide additional target countries once the feed has been created. Starting in August 23, 2022, we will make the following changes to how target countries are organized in the Merchant Center UI:

The primary country of sale option will be removed in Google Merchant Center. Country of sale will be replaced by the more generic feed_label that can accept any string, including any existing 2 letter CDLR country code.
The current additional countries field will be renamed target countries, and will include all countries you want the feed to target.

What’s changing in Google Ads UI and API
The current sales_country field for all available Shopping campaign types, including Performance Max, will eventually be replaced by feed_label. Note that we will keep the sales_country field for backwards compatibility until at least Q2 2023. Right now, you can continue to use sales_country in your campaigns.

You can create a feed_label in Google Merchant Center or the Content API. Feed labels let you group different offers according to a common trait, like language (or a country, as you’ve currently been doing). You can also use feed_labels in Google Ads campaigns to target the relevant offers (all products with the same Merchant Center feed label).

The ads for the offers that match the feed_label will show based on the following:

The countries you selected as target countries in Merchant Center.
Your campaign’s geo targeting. Note: The default campaign targeting behavior (if you do not geo target) is that your products will serve in all your Merchant Center target countries.

How you’re impacted
The phased rollout to enable this feature in Google Ads UI and API has already started, and is expected to be complete by the end of September 2022. For existing feeds, feed_label will automatically be set to the two-letter territory code of the existing sales_country field to avoid interrupting existing targeting.

However, if you want to support new users or new feeds that only have a feed_label and not a sales_country field, we recommend you update your code by August 23, 2022 to accommodate customers who will use campaigns that only have a feed_label (without a sales_country).

If you have any questions or concerns, please don't hesitate to contact us via the forum.

Benji Rothman, Content API for Shopping Team

Feed label replaces target country in Content API for Shopping

Wednesday, 10 August 2022

On August 23, 2022 we will gradually start updating the way country targeting works for shopping products.targetCountrycountryContent API for ShoppingtargetCountrycountryfeedLabelshippingIf you're accessing accounts whose product data you don’t have total control over and you are unsure whether the products or datafeeds will have ONLY a feedLabel field beginning in late August, we recommend you update your code to support the feedLabel field.productstargetCountrydatafeedscountryCountry targeting in Shopping Ads campaigns is changing in August 2022What’s already changedAugust 8, 2022Content API for ShoppingfeedLabelfeedLabelCLDR territory codestargetCountryfeedLabelfeedLabeltargetCountrythe idREST IDfeedLabeltargetCountryhereThis change to product identifier is backwards compatible, so existing REST IDs for existing products will continue to work without change.ImportantfeedLabelfeedLabeltargetCountryshippingWhat’s coming nextAugust 23, 2022feedLabeltargetCountryfeedLabeltargetCountrycountryfeedLabeltargetCountrycountryHow you’re impactedProductstargetCountryfeedLabelproductstargetCountryfeedLabelfeedLabelstargetCountryAll products inserted with a feedLabel instead of targetCountry, even if the feedLabel is a CLDR territory code, will not automatically target that country. You must explicitly set the countries you want to target via the shipping field.Datafeedsfeed labelcountry of salefeedLabelcountryfeedLabelfeedLabelscountryRecommendation for third party integrationstargetCountrycountryfeedLabelproducts.listtargetCountryfeedLabelcountrydatafeeds.listcountry

Make a request to products.list.

Filter your products to search for products where the targetCountry field does not exist on the product.

If any products appear, you have offers without a country in your Merchant Center.

Detailed ChangeshereDatafeeds ServicedatafeedsfeedLabelcountrydatafeeddatafeedscountryfeedLabelOpt out of receiving products and datafeeds without a countryFeed label replaces target country in the Content API for Shopping - temporary exemptionforum

Benji Rothman, Content API for Shopping Team

Google Ads Scripts migration office hours

Tuesday, 2 August 2022

migration guideoffice hours information pageAs a reminderforumgoogleadsscripts-support@google.com - Mike Cloonan, Google Ads Scripts Team

Performance Max upgrade has started

Friday, 22 July 2022

As we announced in January and again in March, existing and future Smart Shopping campaigns (SSC) will automatically upgrade to Performance Max campaigns between July and September 2022. The self-upgrade started in April 2022. The automatic upgrade has commenced (related blog post) and should complete by September 30, 2022. This blog post adds details for our API developers. Starting July 25, 2022, accounts without active or paused SSCs (including new accounts) will no longer be able to create SSCs. Once an account with active or paused SSCs has been automatically upgraded from SSC to Performance Max, no new SSC creation will be permitted in any surface including the UI, the API, Google Ads Scripts or Google Ads Editor. The Google Ads API v11 included a new UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation recommendation type to allow developers to upgrade a given SSC to a Performance Max campaign. This can still be applied to an account that has not yet automatically upgraded. As mentioned in the January blog post, Local campaigns will also be automatically upgraded to Performance Max. An upcoming release of the Google Ads API will include a new recommendation type to allow developers to upgrade an eligible Local campaign to a Performance Max campaign. Additional information If you have any questions or need additional help, contact us via the forum.

David Wihl, Google Ads API Team

Display & Video 360 API Annual Developer Survey 2022

Wednesday, 20 July 2022

As we continue to regularly update the Display & Video 360 API, we’re always looking for how we can improve the developer experience. With this in mind, we are asking for your feedback on our first Display & Video 360 API annual developer survey. Please take 15-20 minutes to share your feedback about the Display & Video 360 API on our Annual Display & Video 360 API Developer Survey for 2022. Through this survey, we are especially interested in understanding how you are using the API, what features you’d like added, and what we can do to make onboarding to the API easier. Your feedback will help shape the product roadmap for the next year.