Hide

Migration Guide (v201502)

See the sunsets page for details on deprecation timeline.

Service Name Component Replacement Service / Changes
AdGroupService, MutateJobService AdGroupServiceError The adGroupId field has been removed.
CampaignCriterionService ContentLabelType enum The JACKASS enum value has been renamed to JUVENILE.
FeedItemService FeedItem The validationDetails field has been removed; use policyData, which has more information, instead.
Criterion Services CriterionUserInterest Interest criteria of type CriterionUserInterest with ID between 1 and 10000, inclusive, can no longer be ADDed. For user interest targeting, use affinity or in-market categories instead.
Various services N/A Objects with a Status of REMOVED will now be omitted by default if no predicate explicitly includes them.
Various services ManualCpmBiddingScheme The activeViewCpmEnabled field is now required when creating a ManualCpmBiddingScheme.
CustomerSyncService CampaignChangeData The campaignTargetingChanged field has been removed from the CampaignChangeData.
LocationCriterionService canonicalName The canonicalName field now uniquely identifies a location. As a result, the value of this field for some existing Location IDs has changed.
AdGroupCriterionService QualityInfo The isLandingPageLatencyAcceptable field has been removed from QualityInfo. This value is no longer used in AdWords.
DataService marginalCpc Bid landscapes from the DataService will no longer include marginalCpc.
AdwordsUserListService ExternalRemarketingUserList ExternalRemarketingUserList has been removed.
CampaignAdExtensionService N/A CampaignAdExtensionService has been removed. Use extension services instead.
Reporting AD_EXTENSION_PERFORMANCE_REPORT The ad extension performance report has been removed. Use the PLACEHOLDER_FEED_ITEM_REPORT instead.
Reporting ProductTarget field in criteria reports The ProductTarget field has been removed. This is in line with the PLA deprecation.
Reporting Various fields

Removed various duplicate fields in favor of more specific or correct names (see Table 1).

Additionally, when using the Id, Name, and Status fields in ad group or campaign performance reports, you must now use one of these more specific names:

  • AdGroupId
  • AdGroupName
  • AdGroupStatus
  • CampaignId
  • CampaignName
  • CampaignStatus
Reporting Conversion-related fields Conversion columns that indicate ConvertedClicks have been renamed to match with AdWords column names (see Table 2).
Reports Various reports The AssistClicks, AssistImpressions, and AssistImpressionsOverLastClicks fields have been removed.
Reports Location criteria ID fields The CountryCriteriaId, CityCriteriaId, MetroCriteriaId, RegionCriteriaId, and MostSpecificCriteriaId fields now correctly return the criterion ID instead of a name.
Reports GEO_PERFORMANCE_REPORT When a report request's predicate selects both true and false for IsTargetingLocation (e.g., IsTargetingLocation IN [true, false]), total rows will be omitted.
Reports Google Analytics columns Google Analytics column titles have been updated to match the Adwords user interface. This affects the displayed column name only; field names are unchanged.

Table 1: Reporting field name changes

Name changes for some reporting fields:

Old nameNew name
PromotionLineHeadline
UrlCreativeDestinationUrl
DestinationUrlCriteriaDestinationUrl

Table 2: Conversion column name changes

Name changes for some ConvertedClicks columns:

Old nameNew name
ConversionRateClickConversionRate
ConversionRateSignificanceClickConversionRateSignificance
ConversionsConvertedClicks
ConversionSignificanceConvertedClicksSignificance
CostPerConversionCostPerConvertedClick
CostPerConversionSignificanceCostPerConvertedClickSignificance
ValuePerConversionValuePerConvertedClick

Send feedback about...

AdWords API