Google Ads Developer Blog: ad_manager

Announcing v202102 of the Google Ad Manager API

Thursday, February 18, 2021

We're happy to announce that v202102 of the Google Ad Manager API is available starting today. Upgrade to this version to take advantage of new functionality, including CreativeSizeType.IGNORED for click-tracking entities, where size doesn't matter, or for entities that allow all requested sizes, where the size represents all sizes.

Additionally, there are several highly-requested report dimensions added in v202102.

Dimension name	Report data break down
BROWSER_NAME	Name and version number of the user's browser
VIDEO_PLACEMENT_NAME	Video placement (e.g., in-article, in-stream, and in-feed)
CLASSIFIED_YIELD_PARTNER_NAME	Detected yield partner name, as classified by Google
DOMAIN	Top private domain, such as "example.co.uk" (excludes subdomains)

Finally, if you use the Ad Manager API to create video LineItems, v202102 now requires that LineItem.videoMaxDuration is greater than 0. This new validation applies to newly created video LineItems as well as updates. If you think you might be affected, you should update any code that creates video LineItems to set videoMaxDuration to be greater than 0 and scan your network for existing video LineItems with videoMaxDuration set to 0.

For the full list of changes for v202102 and all other active API versions, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

- Donovan McMurray, Ad Manager API Team

Sunset of the Ad Manager API v202002

Thursday, January 28, 2021

deprecation schedulegetTrafficDataForecastServicerelease notesintActivityActivityGroupall later versions use type longthe developer forum

- Donovan McMurray, Ad Manager API Team

Sunset of the Ad Manager API v201911

Thursday, November 5, 2020

On Monday, November 30, 2020, in accordance with the deprecation schedule, v201911 of the Ad Manager API will sunset. At that time, any requests made to this version will return errors.

If you’re still using v201911, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v202002 we added a number of video and reporting features.

When you’re ready to upgrade, check the full release notes to identify any breaking changes, like Activity and ActivityGroup IDs changing from type int to type long in v202005. Then, grab the latest version of your client library and update your code.
As always, don't hesitate to reach out to us on the developer forum with any questions.

- Donovan McMurray, Ad Manager API Team

Announcing v202008 of the Google Ad Manager API

Monday, August 24, 2020

v202008Audio AdsViewability Provider CompaniesLineItem

We’ve added nielsenCtvPacingType for specifying the pacing computation method for impressions on connected devices for a Nielsen measured LineItem.

You can now call the performCmsMetadataKeyAction to activate and deactivate CmsMetadataKeys.

For the full list of changes for v202008 and all other active API versions, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

- Donovan McMurray, Ad Manager API Team

Sunset of the Ad Manager API v201908

Tuesday, August 11, 2020

deprecation schedulein v201911CMS Metadatarelease notesActivityActivityGroupchanging from type int to type longAs always, don't hesitate to reach out to us on the developer forum with any questions.

- Donovan McMurray, Ad Manager API Team

Share your feedback about the Ad Manager API

Tuesday, June 23, 2020

To learn more about what's working well and what could be improved, we're running a developer survey on the Ad Manager API. All questions are optional and your answers will be anonymous. We hope you'll take the opportunity to leave feedback on how we can make managing your network better.

Take the survey

The survey should take about 10 minutes to complete and will close on July 31, 2020. Thanks for helping us continue to improve developer experience for everyone.

- Chris Seeley, Ad Manager API Team

Sunset of the Ad Manager API v201905

Wednesday, May 20, 2020

On Monday, June 1, 2020, in accordance with the deprecation schedule, v201905 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new functionality like CustomPacingCurves on LineItem objects and performing actions on CMS Metadata Values.

When you’re ready to upgrade, check the release notes to identify any breaking changes, like Activity and ActivityGroup IDs changing from type int to type long in v202005.

Then, grab the latest version of your client library and update your code. As always, don't hesitate to reach out to us on the developer forum with any questions.

- Donovan McMurray, Ad Manager API Team

Announcing v202005 of the Google Ad Manager API

Thursday, May 14, 2020

We're happy to announce that v202005 of the Google Ad Manager API is available starting today. This version adds new functionality to several use cases, like managing video ads.

For video ads, v202005 allows you to set competitiveConstraintScope and thirdPartyMeasurementSettings on video LineItems. Also, you can now get the duration of video metadata Content for better targeting. Additionally, you can manage your CMS metadata values by marking them as active or inactive.

Another improvement that v202005 brings is that ActivityGroup.id, Activity.id, and Activity.activityGroupId fields have been changed from type int to type long. So if your API integration is strongly typed, be aware that you might need to make changes for this update.

This release also includes a number of Beta features, like reporting on Nielsen Digital Ad Ratings, creating Makegoods for ProposalLineItems, and managing child networks through Multiple Customer Management. For the full list of API changes for v202005 and all other active API versions, check the release notes.

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

- Donovan McMurray, Ad Manager API 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

Sunset of the Ad Manager API v201902

Thursday, January 9, 2020

On Friday, February 28, 2020, in accordance with the deprecation schedule, v201902 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new functionality like CmsMetadata reporting, the TargetingPresetService, and deal IDs on programmatic LineItems.

When you’re ready to upgrade, check the release notes to identify any breaking changes, such as the removal of the deprecated field ImageCreative.lockedOrientation.

Then, grab the latest version of your client library and update your code. As always, don't hesitate to reach out to us on the developer forum with any questions.

- Donovan McMurray, Ad Manager API Team

September 2019 Ad Manager Developer Workshop Materials

Friday, November 15, 2019

Thanks to everyone who was able to make it to the September 2019 Ad Manager Developer Workshop in London!

If you are interested in the content we covered, you can now access the presentation materials from the workshop talks. We have also posted videos of the talks on our Ads Developers YouTube channel.

As always, if you have general API questions or comments, please reach out to us on the Ad Manager API forums.

- Donovan McMurray, Ad Manager API Team

Announcing v201911 of the Google Ad Manager API

Tuesday, November 5, 2019

We're happy to announce that v201911 of the Google Ad Manager API is available starting today. This version brings new reporting and video features, unlocking new possibilities for automation in your Ad Manager network.

Reporting

Video

On video line items, you can now read and write customVastExtension, which provides access to XML extensions that are part of the VAST specification (both v3 and v4).
For further configurability of Dynamic Ad Insertion, you can now set the mediaPlaylistOriginForwardingType and mediaPlaylistOriginPathPrefix fields on CdnConfigurations.

If you’re on an older version of the Ad Manager API, now is a great time to upgrade to take advantage of these and other recent features like the TargetingPresetService, which was added in v201905. The release notes contain the full list of API changes for v201911 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

Sunset of the Ad Manager API v201811

Wednesday, October 16, 2019

On Monday, December 2, 2019, in accordance with the deprecation schedule, v201811 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new features like the TargetingPresetService and reporting on CustomTargetingKeys.

When you’re ready to upgrade, check the release notes to identify any breaking changes. Then, grab the latest version of your client library and update your code.

We now provide a machine-readable version of our deprecation schedule, giving you more flexibility to stay up to date with the latest Ad Manager API features. You can access this CSV file at https://developers.google.com/ad-manager/downloads/api-schedule.csv.

As always, don't hesitate to reach out to us on the developer forum with any questions.

- Donovan McMurray, Ad Manager API Team

Python 2 Deprecation in Google Ads API Client Library

Wednesday, October 9, 2019

On June 11, 2019 we deprecated support for Python 2 in the AdWords/Google Ad Manager client library for Python. As part of our previously announced plans, in mid-November 2019 we will be deprecating support in the Google Ads client library for Python as well.

When version 4.0.0 of the Google Ads client library for Python is released, we will officially end support for Python 2 and versions of Python 3 prior to 3.6.0.

If you use the Google Ads client library for Python, please take note of the following:

If you are already using Python version 3.6.0 or later, you can upgrade to Google Ads client library 4.0.0 and no other action is needed. If not, please do not upgrade to version 4.0.0 until you’ve upgraded to Python version 3.6.0 or later.
Version 4.0.0 will continue to support previous API versions such as v1_3 but we won't support client library issues related to Python 2 compatibility. For example, we won't release version 4.0.1 to fix a bug that only exists for Python 2 users.

If you have questions about the Python 3 migration, please submit an issue on the Google Ads client library repository’s Issues page, and for general API support please reach out to us on the Google Ads API forum.

Ben Karl, Google Ads API Team

Announcing the 2019 London Google Ad Manager Developer Workshop

Monday, August 26, 2019

The Ad Manager Developer Relations team is excited to hop across the pond and bring our Ad Manager Developer Workshop to London on September 26, 2019. If you’re a regular user of the Ad Manager API and Google Publisher Tags, then you’re sure to find something of interest at this event!

What is it?

A full-day event featuring technical talks by Google engineers and office hours with Google's Developer Relations team. We will have talks on a range of topics, including Ad Manager API tips and best practices and strategies for faster loading pages and ads.

Who is the target audience?

The event is targeted toward developers who use the Ad Manager API. The talks will be technical in nature, so a technical background is required for all attendees. You’ll get the most out of some sessions if you come prepared with an API user’s credentials for your network and a laptop. For the full list of sessions, see the event schedule.

Where and when?

This event will be at Google’s London office at 1 St Giles High St. Doors will open at 9:30 AM and we’ll kick things off at 10 o’clock.

How do I sign up?

To register, please visit our website for this event. Seating is limited, so after you register, we will reach back out to you to confirm your spot at the workshop.

- Donovan McMurray, Ad Manager API Team

Announcing v201908 of the Google Ad Manager API

Tuesday, August 13, 2019

We're happy to announce that v201908 of the Google Ad Manager API is available starting today. There are several highly requested features in this new version of the API.

Reporting

Programmatic

Programmatic LineItems and ProposalLineItems now have an allowedFormats field, which gives publishers more control over what types of creatives a buyer can add.

LiveStreamEvents

You can now use the slateCreativeId field to programmatically set live stream slates, which are shown during gaps in a live stream ad break that cannot be filled with a dynamically served ad.

The release notes contain the full list of API changes for v201908.

If you have questions about these or any other API changes, reach out to us on the Ad Manager API forums.

- Donovan McMurray, Ad Manager API Team

Ad Manager Content Ingest Migration

Thursday, July 25, 2019

In case you missed it, Google Ad Manager's video content ingestion is getting an upgrade, and the API has been updated to support the new Content Metadata features.

If you create video line items through the API, you'll need to update your application to target metadata for video line items using CmsMetadataCriteria instead of CustomCriteria keys and values. The values for CmsMetadataCriteria can be retrieved from the CmsMetadataService, available in v201902 and later.

Migration Steps

A significant part of this migration will be coordinating your changes - especially if you work with multiple Ad Manager networks. You'll need to wait until Google migrates each network, then change your application's behavior when creating line items.

The order of operations will be:

If you need help with this migration, or coordinating changes with your partners, don't hesitate to reach out to us on the Ad Manager API forums.

- Chris Seeley, Ad Manager API Team

Sunset of the Ad Manager API v201808

Thursday, July 11, 2019

On Friday, August 30, 2019, in accordance with the deprecation schedule, v201808 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new functionality like DateTimeRangeTargeting, the TargetingPresetService, and reporting on CustomTargetingKeys.

When you’re ready to upgrade, check the release notes to identify any breaking changes. Significant changes include:

A change to the capitalization of DateTime.timeZoneId, which was previously DateTime.timeZoneID.
Removal of the ContentMetadataKeyHierarchyService. You can continue to target video content with key‑values mapped from content metadata or content bundles.

Then, grab the latest version of your client library and update your code. As always, don't hesitate to reach out to us on the developer forum with any questions.

- Donovan McMurray, Ad Manager API Team

May 2019 Ad Manager API Workshop Slides

Monday, June 24, 2019

Thanks to everyone who was able to make it to the recent Ad Manager API Workshop in New York! If you are interested in the content we covered, you can now access the presentation materials from the workshop talks.

We are already planning future workshops, so be sure to check this blog for more updates. If you have general API questions or comments, please reach out to us on the Ad Manager API forums.

- Donovan McMurray, Ad Manager API Team

Announcing the 2019 NYC Google Ad Manager API Workshop

Thursday, April 11, 2019

We’re excited to announce another Google Ad Manager API Workshop in NYC on May 8, 2019. If you’re a regular user of the Ad Manager API and Google Publisher Tags, then you’re sure to find something of interest at this event.

What is it?

A half-day event featuring technical talks by Google engineers and office hours with Google's Developer Relations team. Doors will open at 12:45pm and our keynote presentation will kick off at 1 o’clock. We will have talks on the following topics:

Serverless API integrations using Google Cloud Functions
Strategies and hands-on demos of tools for faster loading pages and ads
Advanced techniques for extracting data that isn't available in the reporting API

Who is the target audience?

The event is targeted toward developers who use or are interested in using the Ad Manager API. The talks will be technical in nature, so a technical background is recommended for all attendees. This event is an opportunity for you to learn more about the API's capabilities and its newest features. This is also an opportunity for you to share feedback by talking directly with Googlers who work on the API.

Where is it?

Google’s Chelsea Market Office
75 Ninth Avenue,
New York, NY 10011

How do I sign up?

To register, please visit our website for this event. Seating is limited, so after you register, we will reach back out to you to confirm your spot at the workshop.

- Donovan McMurray, Ad Manager API Team

Ads Developer Blog

Announcing v202102 of the Google Ad Manager API

Sunset of the Ad Manager API v202002

Sunset of the Ad Manager API v201911

Announcing v202008 of the Google Ad Manager API

Sunset of the Ad Manager API v201908

Share your feedback about the Ad Manager API

Sunset of the Ad Manager API v201905

Announcing v202005 of the Google Ad Manager API

Announcing v202002 of the Google Ad Manager API

Sunset of the Ad Manager API v201902

September 2019 Ad Manager Developer Workshop Materials

Announcing v201911 of the Google Ad Manager API

Sunset of the Ad Manager API v201811

Python 2 Deprecation in Google Ads API Client Library

Announcing the 2019 London Google Ad Manager Developer Workshop

Announcing v201908 of the Google Ad Manager API

Ad Manager Content Ingest Migration

Sunset of the Ad Manager API v201808

May 2019 Ad Manager API Workshop Slides

Announcing the 2019 NYC Google Ad Manager API Workshop

Labels

Archive

Subscribe to our feeds

Google Ads API [+]

AdWords API [+]

Google Ads scripts [+]

Content API for Shopping [+]

Google Ad Manager API [+]

DCM API [+]

DV360 API [+]

DBM API [+]

Mobile Ads [+]

IMA SDK [+]