Google Ads Developer Blog: adwords_api

Support for v201406 reports in AdWords scripts

Thursday, July 31, 2014

Change

Comments

ValuePerConvManyPerClick

Removed

Use ValuePerConversionManyPerClick instead.

ValuePerConv

Removed

Use ValuePerConversion instead.

TotalConvValue

Removed

Use ConversionValue instead.

PrimaryUserLogin

Removed

AccountId

Removed

Use ExternalCustomerId as unique account ID instead.

TargetingSetting

Removed

This column is now called IsRestrict and returns a proper boolean value.

NonDeletedAdGroupCount

Removed

New column name is NonRemovedAdGroupCount.

NonDeletedAdGroupCriteriaCount

Removed

New column name is NonRemovedAdGroupCriteriaCount.

NonDeletedCampaignCount

Removed

New column name is NonRemovedCampaignCount.

We also made changes to some enumerations for relevance and consistency:

Status value for an enabled object is now ENABLED across all reports. Before, it was ACTIVE for some objects.
Removed objects now have a status of REMOVED instead of DELETED.
The PRODUCT_LISTING_AD_CLICKS display name has changed from Offer to Product listing ad.

If your scripts use these fields in reports, make sure you fix the AWQL when migrating to the new version of the reporting API. Keep in mind that if you don’t use API versioning in your reports, then your code will now be using reports API version v201406 by default.

New report fields

Several new report fields were introduced:

Report Name	New columns
Campaign Performance Report	ServingStatus
Click Performance Report	UserListId
Product Partition Report	date fields, CampaignName, AdGroupName
Multiple reports	ExternalCustomerId, IsRestrict, BiddingStrategyType
Campaign, AdGroup, Ad, and Keyword Performance Reports	Labels

You can refer to https://developers.google.com/adwords/api/docs/appendix/reports for the list of supported reports and columns.

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

Anash P. Oommen, AdWords Scripts Team

AdWords API Workshops: Feedback in Action!

Tuesday, July 29, 2014

If you’ve attended one of our AdWords API Workshops, you will know how important we think your feedback is to the growth of the API. We also have surveys you can fill in to let us know what you think. Many of the changes brought about in AdWords API v201406 were influenced by your requests, including:

Labels have been introduced to the API, for filtering and in reporting, which has been our most asked for feature for over a year now.
Destination URL customization has been improved, which along with greater Analytics functionality, improves your ability to track and manage actions from your Ads.
The Status fields of all the entities have been made more consistent. This has meant changing some enumeration fields, for instance, but the result should cause less confusion going forward.
Shared Sets are back - currently for whitelisted customers only.
Managed Customer Service can now move whole subMCC trees between MCCs.

We want to thank you again for your feedback, and ask that you continue to let us know what you need to use the API more effectively. Your input really does matter, and makes things happen.

Finally, if you want to see the content of our last AdWords API Workshops round, we’ve recorded a series of videos of the presentations we gave. We hope you find them useful and interesting.

- Mark R. Bowyer, AdWords API Team

AdWords - Meaningful Return Values

Tuesday, July 15, 2014

We are always striving to make sure the data you fetch from the AdWords API is as meaningful as possible, and in v201406 we've made a few changes to some return values that should be more intuitive.

First, in the TrafficEstimatorService, we used to return 0 for values which we couldn't calculate, for example if a field requires division by zero. However, this could’ve given the false impression that the actual value was 0, rather than that it couldn't be calculated. For this reason, we’ve changed the logic to return null in cases where the value couldn't be calculated at all. This affects the averageCpc and averagePosition fields in StatsEstimate, as these values will not be returned in SOAP responses when they can’t be calculated.

Second, when using the Keyword Performance Report, we formerly returned all negative keywords as having a "pending review" approval status. Since negative keywords don't need to go through the same process as normal keywords, we will now return a null value instead for the ApprovalStatus field for all negative keywords.

This change only affects version v201406 going forward, and doesn’t affect existing versions v201402 or v201309.

As always, we are constantly looking to improve the API. If you have any questions about this or other API features, please feel free to ask on the forum or on our Google+ page.

- Michael Cloonan, AdWords API Team

New labels features in AdWords API v201406

Thursday, July 10, 2014

Many developers in the AdWords API community have mentioned that being able to create, modify, assign, and report on labels through the API would be extremely helpful. Well, we're excited to report that the v201406 release of the AdWords API includes all of these requested features!

Summary of label services and features

New LabelService for creating, modifying, and retrieving labels.
A new mutateLabels method in CampaignService, AdGroupService, AdGroupAdService, and AdGroupCriterionService for assigning and removing labels on your campaigns, ad groups, ads, and keywords.
New Predicate operators that allow you to select objects by one or more label IDs.
A new Labels field in multiple reports so you can retrieve labels for your objects and filter your report results by one or more label IDs.

End-to-end example
So how do these new features work together? Check out our labels guide to get you on the road to AdWords label expertise!

Next steps
If you've never used labels in your account or need a refresher course, check out the Help Center labels guide. Once you're ready to dive in, try out the label examples in your client library of choice.

Still have questions? Feel free to visit us on the AdWords API Forum or our Google+ page.

- Josh Radcliff, AdWords API Team

Announcing v201406 of the AdWords API

Wednesday, July 9, 2014

If you're still using v201309 of the AdWords API, please note that it's being sunset on July 21st, 2014. We encourage you to skip v201402 and migrate straight to v201406. If you're using v201402, be aware it's now marked deprecated and will be sunset on November 6th, 2014.

As with every new version of the AdWords API, we encourage you to carefully review all changes in the release notes and the v201406 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 that are now required in third-party tools. 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 v201406 Sunset Reminder

Support for v201406 reports in AdWords scripts

AdWords API Workshops: Feedback in Action!

AdWords - Meaningful Return Values

New labels features in AdWords API v201406

Announcing v201406 of the AdWords API

Labels

Archive