Google Ads Developer Blog: adwords_api

Reporting changes in AdWords API v201509

Tuesday, October 27, 2015

v201506

v201509

Clicks

Text ads: clickthrough to a landing page

Lightbox ads: hover to expanded ad format

Text ads: clickthrough to a landing page or clicks to call

Lightbox ads: clickthrough to a landing page

Video ads: clickthrough to a landing page

Engagements

N/A

Lightbox ads: hover to expanded ad format

VideoViews

N/A

Video ads: view

Interactions

N/A

Text ads: clickthrough to a landing page or clicks to call

Lightbox ads: hover to expanded ad format

Video ads: views

Please note that reporting in v201506 and previous versions is unaffected; they return the same data that they always have, represented the same way. This means that when comparing the data you receive from older versions of the API to user interface reports, or to v201509 reports, the numbers will not directly match up. Video-related stats will still be excluded from v201506. The Clicks column in v201506 will match the Interactions column from v201509 if you subtract out video interactions.

For ease of reporting, it’s recommended to migrate to v201509 as soon as possible.

Keep in mind these aren’t the only reporting changes in v201509 — for more details on conversion-related reporting changes, please see the release notes.

If you have any questions about this or other aspects of the AdWords API, please contact us via the forum or the Ads Developers Plus Page.

- Michael Cloonan, AdWords API Team

Support for v201506 reports in AdWords Scripts

Monday, September 21, 2015

Reports

AdGroupStatus

PLACEHOLDER_FEED_ITEM_REPORT

CampaignName

CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT
CAMPAIGN_NEGATIVE_LOCATIONS_REPORT
CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT

CampaignStatus

CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT
CAMPAIGN_NEGATIVE_LOCATIONS_REPORT
CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT
CAMPAIGN_SHARED_SET_REPORT
PLACEHOLDER_FEED_ITEM_REPORT

EndDate

CAMPAIGN_PERFORMANCE_REPORT

FinalUrl

SEARCH_QUERY_PERFORMANCE_REPORT

StartDate

CAMPAIGN_PERFORMANCE_REPORT

If you use API versioning in your reports, then you need to modify your code to use v201506 as shown below. If you don’t use API versioning, no code changes are required.

var report = AdWordsApp.report(query, {
   apiVersion: 'v201506'
});

If you have any questions about this feature or AdWords scripts in general, you can post them on our developer forum.

Anash P. Oommen, AdWords Scripts Team

More features now available in the AdWords API

Tuesday, September 1, 2015

Following the release of AdWords API v201506, we've added a few additional features that are available immediately:

Android App ‘first open’ conversion tracking. Recently available in AdWords, this new conversion tracking solution measures when a user first opens an app after clicking on an ad and completing an Android app install. Check out the new FIRST_OPEN conversion type in the AppConversion tracker that also supports Postback URLs for Android.
A new report specific to final URLs: FINAL_URL_REPORT. The report replaces the deprecated DESTINATION_URL_REPORT and provides statistics aggregated at the final URL level.

We also launched account hiding support recently—see this announcement if you missed it. If you have any questions, feel free to reach us on the forum or via the Ads Developers Plus Page.

- Danial Klimkin, on behalf of AdWords API Team.

Announcing v201506 of the AdWords API

Monday, June 29, 2015

Today we're announcing the release of AdWords API v201506. Here are the highlights:

Location extensions within a geographic area is now configurable through the API, which in previous versions was a read-only feature. LocationGroups provides a feedId that is now required when specifying a LocationExtensionOperand in the matching function.
Updates to reporting. Gmail Sponsored Promotion stats are now available in reporting. We’ve added new columns to existing reports, including the Final Url column to the Search Query report and start and end dates to Campaign Performance report. See the release notes for the complete list.
Improved ConstantDataService. CriterionUserInterest objects now have a new parent ID attribute that allows for navigation of the user interest taxonomy hierarchy.
AWQL improvements. You can now explicitly include or exclude zero impression rows when requesting reports using AWQL. Also, the DURING clause became optional when defining ALL_TIME reports. Shared set services were extended with the AWQL query() method.
Improvement to labels. You can now programmatically set label descriptions and colors using the API.

If you're using v201409 of the AdWords API, please note that it's being sunset on July 28th, 2015. We encourage you to skip v201502 and migrate straight to v201506. If you're using v201502, be aware it's now marked deprecated and will be sunset on November 5th, 2015.

As with every new version of the AdWords API, we encourage you to carefully review all changes in the release notes and the v201506 migration guide. The updated client libraries and code examples will be published shortly. With this release, we've also updated the Required Minimum Functionality document to include some of the newly added features. If you have any questions or need help with migration, please post on the forum or the Ads Developers Plus Page.

- Danial Klimkin, on behalf of AdWords API Team.

Ads Developer Blog

AdWords API v201506 sunset reminder

Reporting changes in AdWords API v201509

Support for v201506 reports in AdWords Scripts

More features now available in the AdWords API

Announcing v201506 of the AdWords API

Labels

Archive