Google Ads Developer Blog: February 2020

Announcing v3_0 of the Google Ads API beta

Thursday, February 27, 2020

Today we’re announcing the v3_0 release of the Google Ads API beta. To use the v3_0 features via the new endpoint, please update your client libraries. If you are upgrading from v1 or v2, some of your code may require changes when you switch to the new v3 endpoint. Please see the migration guide for more information on breaking changes.

Here are the highlights:

Added the ability to stream results from GoogleAdsService.SearchStream(). This is the recommended way for retrieving large scale data from GoogleAdsSearch. Please see this guide for more details.
Added support for moving a client customer to a new manager customer with CustomerManagerLinkService.MoveManagerLink().
Added PaymentMode.GUEST_STAY to enable the pay per stay mode of Hotels Commissions campaigns. This payment mode can only be used in conjunction with campaigns with AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION, and BudgetType.HOTEL_ADS_COMMISSION.

Where can I learn more?
The following resources can help you get going with the Google Ads API:

The updated client libraries and code examples will be published next week. If you have any questions or need additional help, please contact us via the forum.

Nadine Wang, on behalf of the Google Ads API Team

Responsive Display Ads in Google Ads Scripts

Monday, February 24, 2020

Today we are adding support for new responsive display ads in Google Ads scripts. Starting last year, you could no longer create legacy responsive display ads, but you could still fetch your existing ads.

These new responsive display ads have added support for multiple text, image, and video assets in the same ad. The ResponsiveDisplayAd object gained new methods to support the new associated fields, and you can begin adding new responsive display ads in your scripts.

The new and legacy responsive display ads are both represented via the same ResponsiveDisplayAd object. Make sure to read the full object documentation to check which methods are relevant for legacy ads or new ads. We also have a short guide demonstrating some of the key changes.

If you have any questions or concerns, please don't hesitate to contact us via the forum.
- Mike Cloonan, Google Ads scripts Team

Announcing v202002 of the Google Ad Manager API

Tuesday, February 11, 2020

We're happy to announce that v202002 of the Google Ad Manager API is available starting today. This version includes several new features around video ads.

For “Ad Exchange historical” reports, there are several new video Columns available beginning with “AD_EXCHANGE_VIDEO_”. Here are a few of the new metrics:

AD_EXCHANGE_VIDEO_START – the number of impressions where the video was played for video ads by Ad Exchange properties
AD_EXCHANGE_VIDEO_SKIPS – The number of times a skippable video is skipped
AD_EXCHANGE_VIDEO_UNMUTE – The number of times a user unmutes the video ad

You can now associate a video Creative with an ad registry, such as Ad-ID or Clearcast. Video metadata is also getting enhanced with the addition of Content.contentBundleIds to show which ContentBundles a Content object belongs to and Content.cmsMetadataValueIds to show which CmsMetadataValues are associated with a Content object.

The release notes contain the full list of API changes for v202002 and all other active API versions.

Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

- Donovan McMurray, Ad Manager API Team

Gmail on standard Shopping campaigns

Thursday, February 6, 2020

Beginning the week of Mar 4th, 2020, Shopping ads (both Product Shopping ads and Showcase Shopping ads) in your standard Shopping campaigns that target the Google Display Network will be eligible to appear on Gmail in addition to YouTube and Google Discover. This means that reporting information will include Gmail in addition to YouTube and Google Discover for the following configurations:

Google Ads API - Where the standard Shopping campaign advertising_channel_type is SHOPPING and the NetworkSettings for target_content_network is true, the reporting metrics for segment field ad_network_type of CONTENT will include Gmail in addition to YouTube and Google Discover.
AdWords API - Where the standard Shopping campaign AdvertisingChannelType is SHOPPING and the NetworkSetting for targetContentNetwork is true, the SHOPPING_PERFORMANCE_REPORT metrics for segment fields AdNetworkType1 and AdNetworkType2 of type CONTENT will include Gmail in addition to YouTube and Google Discover.

To allow your advertisers to opt-in/opt-out of Gmail, YouTube and Google Discover for standard Shopping campaigns, you will need to enable or disable the following setting:

Google Ads API - Modify the NetworkSettings of the standard Shopping campaign and set target_content_network to true (opt-in) or false (opt-out).
AdWords API - Modify the NetworkSetting of the standard Shopping campaign and set targetContentNetwork to true or false.

If you have any questions or need help, please contact us via the forum.

- Ian Ballantyne, on behalf of the Google Ads API Team

Ads Developer Blog

Announcing v3_0 of the Google Ads API beta

Responsive Display Ads in Google Ads Scripts

Announcing v202002 of the Google Ad Manager API

Gmail on standard Shopping campaigns

Labels

Archive

Subscribe to our feeds

Google Ads API [+]

Google Ads scripts [+]

Content API for Shopping [+]

DCM API [+]

DV360 API [+]

DBM API [+]

Mobile Ads [+]

IMA SDK [+]