Google Ads Developer Blog

Announcing v1_3 of the Google Ads API

Wednesday, May 22, 2019

Today we’re announcing the v1_3 release of the Google Ads API. With this version, you’ll continue pointing to v1 as your endpoint; however, you'll need to update your client libraries in order to use v1_3 features.

Here are the highlights:

Added support for campaign drafts and experiments with the CampaignDraft and CampaignExperiment resources (equivalent to Campaign Drafts and Experiments in the AdWords API).
Added the ability to retrieve all label resource names associated with the Campaign resource using Campaign.labels.

What resources are available?
The following resources should help you get going with v1_3 of the Google Ads API:

The updated client libraries and code examples will be published by May 24, 2019. If you have any questions or need help, please contact us via the forum.

Nadine Sundquist, on behalf of the Google Ads API Team

Announcing v201905 of the Google Ad Manager API

Tuesday, May 21, 2019

We're happy to announce that v201905 of the Google Ad Manager API is available starting today. This version introduces a long-requested feature: Targeting Presets. The new TargetingPresetService allows you to read your network's targeting presets in a familiar Targeting object that can be applied to line items, forecasts, and proposal line items.

This release also introduces support for configuring and reporting on custom dimensions, and new Programmatic features such as Pause and Resume actions for Proposals.

For a full list of API changes in v201905, see the release notes.

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

- Chris Seeley, Ad Manager API Team

Expanding your Shopping ads to additional Google platforms

Tuesday, May 14, 2019

YouTube and Google Discover power visually rich experiences and play a part of millions of users’ shopping journeys. Soon your Standard Shopping campaigns will be able to reach users who discover and continue their shopping journey on these additional Google platforms.

We’re excited to announce that Shopping ads (both Product Shopping ads and Showcase Shopping ads) in your standard Shopping campaigns will be eligible to appear on YouTube and Google Discover beginning the week of July 15th, 2019. Shopping ads served on YouTube and Google Discover will be reported under the Google Display Network.

In preparation for this change, standard Shopping campaigns that are enabled for Search Network will be automatically enabled for YouTube and Discover, beginning the week of June 17th, 2019. This means that any standard Shopping campaigns that target the Search Network will automatically enabled to target the Content Network. After this process, developers using the Google Ads API or the AdWords API can give users the ability to opt-in/opt-out. They can do this by changing the campaign target network as follows:

Google Ads API - Modify the NetworkSettings of the standard Shopping campaign to set target_content_network to true or false.
AdWords API - Modify the NetworkSetting of the standard Shopping campaign to set targetContentNetwork to true or false.

Ads with these settings will only be eligible to appear on YouTube and Google Discover from the week of July 15th, 2019. During that week, you may start seeing new metrics as part of your reporting data. Depending on which API you are using you can access the metrics by doing the following:

Google Ads API - Use GoogleAdsService.Search to request reporting data and check the segment field ad_network_type for type CONTENT.
AdWords API - Download the SHOPPING_PERFORMANCE_REPORT and check either of the two segment fields AdNetworkType1, AdNetworkType2 for type CONTENT.

Note: If you would like to upgrade to the Google Ads API from the AdWords API, please see more information our blog.

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

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

Upcoming breaking changes to the Google Ad Manager API

Friday, May 3, 2019

On Monday July 8, 2019 the Ad Manager API's ReportService will stop supporting reports that mix Ad Exchange historical reporting fields with Historical reporting fields. This change will impact all API versions.

After July 8, any API reports that use both an Ad Exchange historical Dimension or Column and a Historical Dimension or Column will fail with the following error: ReportError.REPORT_CONSTRAINT_VIOLATION

Why are we making this change?

This change is being made to ensure all API reports return accurate data. The Query Tool has never supported creating reports that mix Ad Exchange historical and Historical data, and in some cases this may lead to unexpected results. This change brings the API in line with the Query Tool.

How can I tell if I am impacted?

This change impacts approximately 2% of all reports run with the Ad Manager API. If you only run saved queries that were created with the Query Tool, this change does not impact you.

If you use any of the following columns, your report will be considered an Ad Exchange historical report, and you may only use either Dimensions prefixed with AD_EXCHANGE or date Dimensions including DATE, WEEK, DAY, HOUR or MONTH_AND_YEAR:

Column.AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS
Column.AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS
Column.AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS
Column.AD_EXCHANGE_AD_CTR
Column.AD_EXCHANGE_AD_ECPM
Column.AD_EXCHANGE_AD_REQUEST_CTR
Column.AD_EXCHANGE_AD_REQUEST_ECPM
Column.AD_EXCHANGE_AD_REQUESTS
Column.AD_EXCHANGE_AVERAGE_VIEWABLE_TIME
Column.AD_EXCHANGE_CLICKS
Column.AD_EXCHANGE_COVERAGE
Column.AD_EXCHANGE_CPC
Column.AD_EXCHANGE_CTR
Column.AD_EXCHANGE_DEALS_AD_REQUESTS
Column.AD_EXCHANGE_DEALS_BID_RESPONSES
Column.AD_EXCHANGE_DEALS_MATCH_RATE
Column.AD_EXCHANGE_DEALS_MATCHED_REQUESTS
Column.AD_EXCHANGE_ESTIMATED_REVENUE
Column.AD_EXCHANGE_IMPRESSIONS
Column.AD_EXCHANGE_LIFT
Column.AD_EXCHANGE_MATCHED_ECPM
Column.AD_EXCHANGE_MATCHED_REQUESTS
Column.AD_EXCHANGE_VIDEO_ABANDONMENT_RATE
Column.AD_EXCHANGE_VIDEO_DROPOFF_RATE
Column.AD_EXCHANGE_VIDEO_QUARTILE_1
Column.AD_EXCHANGE_VIDEO_QUARTILE_3
Column.AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE
Column.AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS
Column.AD_EXCHANGE_VIDEO_TRUEVIEW_VTR

What changes do I need to make?

To prevent your reports from failing, you must convert your report to be either an Ad Exchange historical report or a Historical report.

To convert the report to an Ad Exchange historical report:

Remove any Columns not in the list above.
Remove any Dimensions that are not prefixed with AD_EXCHANGE, with the exception of the following Dimensions:

DATE
WEEK
DAY
HOUR
MONTH_AND_YEAR

Remove any DimensionAttributes for dimensions you removed.
Remove any PQL filters that applied to fields you removed.

To convert the report to a Historical report:

Remove any of the Columns in the list above.
Remove any Dimensions that are prefixed with AD_EXCHANGE.
Remove any PQL filters that applied to fields you removed.

If you have questions about this change or are unsure if it impacts you, reach out to us on the Ad Manager API forums. We'll be happy to check if you're impacted and work with you to update your applications.

- Chris Seeley, Ad Manager API Team

Reporting issues April 30 and May 1, 2019

Thursday, May 2, 2019

Update 5, May 17 2019, 12:00pm PDT: Latest and all future updates on this issue are available here.

Update 4, May 10 2019, 10:00am PDT: We have edited this post to confirm that store sales and store visits data has been fixed for April 28 and 29, as well as May 3 to present. We are actively working on correcting the data for April 30, May 1 and May 2 (all dates in PDT).

Update 3, May 8 2019, 6:30pm PDT: We are actively working on correcting the data from 12:01am on May 1 to 4:00am May 2 (PDT). All other data is now accurate, with the exception of store visits and store sales data which is impacted from 12:01am (PDT) on April 28 onwards, and which we are also working to correct. Google Ads bid strategy & Local campaign users do not need to take any action, as our bidding models are not impacted by the incorrect data.

Update 2, May 3 2019, 8PM PDT: We are actively working on correcting the data from 12:01am on May 1 to 4:00am May 2 (PDT). All other data is now accurate.

Update: We have edited this post to confirm the accuracy of data after 4am on May 2 PST and beyond and provide guidance for when fixed data is expected to be available.

On May 1, at approximately 5pm PST, a bug caused Google Ads reporting for April 30 and May 1 (Pacific Time) to be incorrect. This bug impacts reports in all Google Ads interfaces, including any report data downloaded via the AdWords API, Google Ads API and Google Ads Scripts.

We are actively working to correct the data from 12:01am on May 1 to 4:00am on May 2 (PDT), as well as the store visits and store sales data, which is inaccurate from 12:01am on April 30 to end of day May 2 (PDT). All other data is now accurate. Google Ads bid strategy & Local campaign users do not need to take any action, as our bidding models are not impacted by the incorrect data.

We appreciate your patience as we work to resolve this issue as quickly as possible.

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

Adam Ohren, Google Ads API Team

Announcing v1_2 of the Google Ads API

Tuesday, April 30, 2019

Today we’re announcing the v1_2 release of the Google Ads API. With this version, you’ll continue pointing to v1 as your endpoint; however, you'll need to update your client libraries in order to use v1_2 features.

Here are the highlights:

Simulations. Added simulations (equivalent to Bid Landscapes in the AdWords API) for campaign criteria, ad group criteria, and ad groups.
Reporting.
- Added metrics for Local Campaigns equivalent to the Per Store Report in the Locations tab of the UI.
- Added new LandingPageView and ExpandedLandingPageView resources (enhanced version of Landing Page Report in the AdWords API).
- Added a new PaidOrganicSearchTermView resource (equivalent to Paid Organic Query Report in the AdWords API).
Ads. Added AppEngagementAdInfo for managing App Campaigns for Engagement and DisplayUploadAdInfo for managing various HTML5 ads.
Recommendations. Added three new recommendations: CallExtensionRecommendation, CalloutExtensionRecommendation, and SitelinkExtensionRecommendation.

What resources are available?
The following resources should help you get going with v1_2 of the Google Ads API:

Release Notes
Guides
Migration Guides
Reference

The updated client libraries and code examples will be published by May 2, 2019. If you have any questions or need help, please contact us via the forum.

Nadine Sundquist, on behalf of the Google Ads API Team

Announcing Google Ads API Doctor

Monday, April 22, 2019

We have heard from users that correctly configuring a client library and provisioning OAuth2 credentials can be challenging, so today we are introducing Google Ads API Doctor, a new tool that will analyze your client library environment. The program will:

Verify that your OAuth2 credentials are correctly configured and ready to make API calls.
Guide you through fixing any OAuth2 problems it detects and verify the corrected configuration.

The initial version of this tool will help you analyze and fix issues related to OAuth2 configuration, including the following common issues:

Invalid refresh token: The program will identify this and guide you through the process to obtain a valid token, back up your configuration file, and write the new value to your active configuration file.
Permission denied: There are several OAuth errors that sound similar, such as user permission denied and permission denied. The program identifies that in the first case it is caused by an invalid refresh token and in the second it’s because the Google Ads API is disabled in the Google API Console.

If you want to send the output to support, you can run your scenario with the PII flag to hide your Personally Identifiable Information (PII) and copy the screen output. To gather even more information, you can use the verbose flag to see the low-level JSON that is returned.

We are releasing this project as open source per Google’s open source initiative, and we encourage contributions. See contributing to Google open source to learn more about how to contribute to this project. As always, share your feedback on the Google Ads API forum.

Bob Hancock and

Poki Chui, Google Ads API Team

Ads Developer Blog

Announcing v1_3 of the Google Ads API

Announcing v201905 of the Google Ad Manager API

Expanding your Shopping ads to additional Google platforms

Upcoming breaking changes to the Google Ad Manager API

Reporting issues April 30 and May 1, 2019

Announcing v1_2 of the Google Ads API

Announcing Google Ads API Doctor

Labels

Archive

Feeds

Google Ads API [+]

AdWords API [+]

Google Ads scripts [+]

Content API for Shopping [+]

Google Ad Manager API [+]

DCM API [+]

Mobile Ads [+]

IMA SDK [+]

More Google blogs