v13 Release Notes

What's New

This release of AdWords API introduces the following new features:

• New geotargeting options: AdWords API now supports the following geographical targeting features:
  • Negative targeting of a geographic region (for example, target the United States except Alaska)
  • Targeting of multiple granularity levels (countries, regions, metros, cities) in a single campaign
  • Targeting of regions of different countries in a single campaign

  Some of these new targeting options are also available in v12. For details, see the GeoTarget API reference.

• Active campaign and ad group retrieval: Use getActiveAdWordsCampaigns and getActiveAdGroups to return only active campaigns and ad groups.
• Campaign budget suggestions: Use getRecommendedBudgetList to retrieve budget suggestions for your campaigns.
• Quality-based bid and quality score support: Added two new fields to Keyword:
  • firstPageCpc (first page bid estimate)
  • qualityScore (quality score of the keyword)
• Mobile Image Ad support: Use the new MobileImageAd ad type to create graphical advertisements for the mobile content network.
• Easier MCC account hierarchy retrieval: Use AccountService.getClientAccountInfos (similar to getClientAccounts) to retrieve the primary email address and MCC status of each managed account.
• MCC Alerts support: Use AccountService.getMccAlerts to retrieve detailed MCC notifications. Each returned MccAlert object describes the client, priority, alert type, trigger time, and more.
• Search volume data returned in KeywordToolService: In SiteKeyword and KeywordVariation objects, the searchVolumeScale field has been replaced by two fields that provide actual search volume data:
  • avgSearchVolume (approximate number of searches in the past year)
  • lastMonthSearchVolume (approximate number of searches in the past month)
• New report types: You can now generate Search Query Performance and Geographic Performance reports with DefinedReportJob. These new report types are also available in v12.
• Minimum bids no longer supported: The Keyword.minCpc field and the related «InActive» status have been removed from v13. Also, the KeywordMinCPC report column is no longer supported and may return unexpected results. For more information, see What happened to minimum bids? in the AdWords Help Center.

API Differences

The following tables show changes between v13 and v12.

Legend

• + Added in v13
• − Removed in v13
• ≠ Changed in v13

AccountService

AdGroupService

AdService

CampaignService

CriterionService

KeywordToolService

v12 Release Notes

What's New

This release of AdWords API introduces the following new features:

• Added conversion optimizer support - you can now enable conversion optimizer and adjust cost-per-acquisition bids through the AdWords API. Using conversion optimizer requires conversion tracking to be enabled on an existing campaign with at least 200 conversions in the past 30 days. For more information, see the CampaignService overview.
• Added CPC bidding for placement-targeted campaigns - use Website.maxCpc or AdGroup.siteMaxCpc to pay only when a user clicks on your placement-targeted ad.
• New budget fields in Campaign - A limited test release of monthly budget required two fields—budgetAmount and budgetPeriod—to replace dailyBudget. To use an existing campaign's budget with the new structure, set budgetPeriod to Daily and budgetAmount to the existing campaign's budget.
• AdGroup.id type change - AdGroup.id has been changed from an int to a long.
• Read-only fields added to LocalBusinessAd - as a consequence of adding some internal features, three new read-only fields (fullBusinessName, latitude, and longitude) are now available.
• Expanded code sample library - available at http://code.google.com/apis/adwords/docs/samples.html

API Differences

The following tables show changes between v12 and v11.

Legend

• + Added in v12
• − Removed in v12
• ≠ Changed in v12

AdGroupService

CampaignService

AdService

CriterionService