Release Notes for v201809

Remember to keep your contact email up-to-date.

What's new

Ads and ad formats

General

  • The trafficSplitType field was added to Trial to give you greater control over how traffic is split between base and trial campaigns.

  • AdGroupService validation was modified and the UniversalAppAd ad type was added to allow whitelisted users to create ad groups and ads in Universal App campaigns.

  • Any CampaignService request that attempts to add a Campaign with a shared budget to a CampaignGroup will now fail with the error CampaignError and reason CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP. Previously, such a request would fail but with a less informative error.

Shopping

  • The validation for salesCountry and campaignPriority of ShoppingSetting was simplified as follows:

    • Smart Shopping campaigns no longer require campaignPriority. Previously, these campaigns required a campaignPriority of 3.

    • Campaigns that are not SHOPPING campaigns no longer require salesCountry. Previously, these campaigns required a salesCountry of ZZ.

    In each of the above cases, the AdWords API now applies the appropriate value instead of requiring the user to specify the one permitted value for each case.

  • The error reasons SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE and PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY were removed from CampaignError since they can no longer be thrown.

Targeting

  • The read-only destinationUrl field was removed from BiddableAdGroupCriterion. This field was deprecated with the introduction of upgraded URLs.

  • The following ContentLabelType enum values were removed:

    • AFE
    • ALLOWED_GAMBLING_CONTENT
    • CONFLICT
    • SIRENS
    • UGC_FORUMS
    • UGC_IMAGES
    • UGC_SOCIAL
    • UGC_VIDEOS
  • Attempts to target placements on Search campaigns will now fail with the error CriterionError and reason CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS.

  • The error reason PLACEMENT_LIST_TYPE_ONLY_ALLOWED_FOR_XBID was removed from CustomerNegativeCriterionError since it can no longer be thrown.

  • Any request that attempts to exclude a Placement target with a url equal to adsenseformobileapps.com will now fail with the error reason ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED. Previously, such requests failed with error reason INVALID_PLACEMENT_URL. Check out the related blog post for more details.

Reporting

Removed reports

The DESTINATION_URL_REPORT was removed. The FINAL_URL_REPORT replaced this report when upgraded URLs were added to the AdWords API.

New report fields

  • ConversionAttributionEventType field was added to the CAMPAIGN_PERFORMANCE_REPORT. This field allows you to segment AllConversions and related metrics by event type (impression or interaction).

  • The ConversionAdjustment and ConversionAdjustmentLagBucket fields were added to multiple reports. The ConversionAdjustment indicates whether a conversion was adjusted, and the ConversionAdjustmentLagBucket segments report results according to the number of days between the impression and either a conversion or an adjustment.

  • The AdStrengthInfo field was added to the AD_PERFORMANCE_REPORT so you can retrieve the ad strength information mentioned above in reports as well.

  • The following fields were added to the CLICK_PERFORMANCE_REPORT to allow you to monitor the performance of your ad variations:

    • AdVariationControlTrialArmId
    • AdVariationTreatmentTrialArmId
    • AdVariationTrialId

Migration guide

Breaking changes introduced in this version are summarized in the v201809 migration guide.

API changes

  1. = AccountLabelService (no changes)
  2. = AdCustomizerFeedService (no changes)
  3. AdGroupAdService (4 new, 7 changed, 0 removed)
    1. + type CertificateDomainMismatchConstraint
    2. + type MediaBundleAsset
    3. + type UniversalAppAd
    4. + type YoutubeVideoAsset
    5. enum Ad.Type
      1. + value UNIVERSAL_APP_AD
    6. enum AdError.Reason
      1. + value CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
    7. type AdGroupAd
      1. + field adStrengthInfo
    8. enum Asset.Type
      1. + value YOUTUBE_VIDEO
      2. + value MEDIA_BUNDLE
    9. type ExpandedDynamicSearchAd
      1. + field description2
    10. type ExpandedTextAd
      1. + field description2
      2. + field headlinePart3
    11. type MultiAssetResponsiveDisplayAd
      1. + field youtubeVideos
  4. AdGroupBidModifierService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  5. AdGroupCriterionService (0 new, 3 changed, 0 removed)
    1. type BiddableAdGroupCriterion
      1. field destinationUrl
    2. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE
    3. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  6. AdGroupExtensionSettingService (1 new, 2 changed, 0 removed)
    1. + type CertificateDomainMismatchConstraint
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
    3. enum ExtensionSettingError.Reason
      1. + value CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
  7. = AdGroupFeedService (no changes)
  8. AdGroupService (0 new, 1 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE
  9. = AdParamService (no changes)
  10. AdService (4 new, 6 changed, 0 removed)
    1. + type CertificateDomainMismatchConstraint
    2. + type MediaBundleAsset
    3. + type UniversalAppAd
    4. + type YoutubeVideoAsset
    5. enum Ad.Type
      1. + value UNIVERSAL_APP_AD
    6. enum AdError.Reason
      1. + value CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
    7. enum Asset.Type
      1. + value YOUTUBE_VIDEO
      2. + value MEDIA_BUNDLE
    8. type ExpandedDynamicSearchAd
      1. + field description2
    9. type ExpandedTextAd
      1. + field description2
      2. + field headlinePart3
    10. type MultiAssetResponsiveDisplayAd
      1. + field youtubeVideos
  11. = AdwordsUserListService (no changes)
  12. AssetService (3 new, 1 changed, 0 removed)
    1. + type MediaBundleAsset
    2. + type YoutubeAdVideoRegistrationError
    3. + type YoutubeVideoAsset
    4. enum Asset.Type
      1. + value YOUTUBE_VIDEO
      2. + value MEDIA_BUNDLE
  13. = BatchJobService (no changes)
  14. BiddingStrategyService (0 new, 1 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE
  15. = BudgetOrderService (no changes)
  16. BudgetService (0 new, 1 changed, 0 removed)
    1. enum BudgetError.Reason
      1. + value BUDGET_CANNOT_BE_EXPLICITLY_SHARED
  17. CampaignBidModifierService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  18. CampaignCriterionService (0 new, 2 changed, 0 removed)
    1. enum ContentLabelType
      1. value AFE
      2. value CONFLICT
      3. value UGC_FORUMS
      4. value UGC_IMAGES
      5. value UGC_SOCIAL
      6. value UGC_VIDEOS
      7. value SIRENS
      8. value ALLOWED_GAMBLING_CONTENT
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  19. CampaignExtensionSettingService (1 new, 2 changed, 0 removed)
    1. + type CertificateDomainMismatchConstraint
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
    3. enum ExtensionSettingError.Reason
      1. + value CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
  20. = CampaignFeedService (no changes)
  21. = CampaignGroupPerformanceTargetService (no changes)
  22. = CampaignGroupService (no changes)
  23. CampaignService (2 new, 4 changed, 0 removed)
    1. + type CertificateDomainMismatchConstraint
    2. + type UniversalAppCampaignInfo
    3. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE
    4. enum BudgetError.Reason
      1. + value BUDGET_CANNOT_BE_EXPLICITLY_SHARED
    5. type Campaign
      1. + field universalAppCampaignInfo
    6. enum CampaignError.Reason
      1. + value CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP
      2. value SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE
      3. value PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
  24. = CampaignSharedSetService (no changes)
  25. = ConstantDataService (no changes)
  26. = ConversionTrackerService (no changes)
  27. CustomAffinityService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  28. CustomerExtensionSettingService (1 new, 2 changed, 0 removed)
    1. + type CertificateDomainMismatchConstraint
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
    3. enum ExtensionSettingError.Reason
      1. + value CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
  29. = CustomerFeedService (no changes)
  30. CustomerNegativeCriterionService (0 new, 3 changed, 0 removed)
    1. enum ContentLabelType
      1. value AFE
      2. value CONFLICT
      3. value UGC_FORUMS
      4. value UGC_IMAGES
      5. value UGC_SOCIAL
      6. value UGC_VIDEOS
      7. value SIRENS
      8. value ALLOWED_GAMBLING_CONTENT
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
    3. enum CustomerNegativeCriterionError.Reason
      1. value PLACEMENT_LIST_TYPE_ONLY_ALLOWED_FOR_XBID
  31. = CustomerService (no changes)
  32. = CustomerSyncService (no changes)
  33. = DataService (no changes)
  34. DraftAsyncErrorService (0 new, 4 changed, 0 removed)
    1. enum AdError.Reason
      1. + value CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
    2. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE
    3. enum CampaignError.Reason
      1. + value CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP
      2. value SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE
      3. value PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
    4. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  35. DraftService (0 new, 1 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE
  36. FeedItemService (1 new, 1 changed, 0 removed)
    1. + type CertificateDomainMismatchConstraint
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  37. FeedItemTargetService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  38. = FeedMappingService (no changes)
  39. = FeedService (no changes)
  40. = LabelService (no changes)
  41. = LocationCriterionService (no changes)
  42. = ManagedCustomerService (no changes)
  43. = MediaService (no changes)
  44. = OfflineCallConversionFeedService (no changes)
  45. OfflineConversionAdjustmentFeedService (0 new, 1 changed, 0 removed)
    1. enum OfflineConversionAdjustmentError.Reason
      1. value ATTRIBUTED_CONVERSION_NOT_SUPPORTED
  46. = OfflineConversionFeedService (no changes)
  47. OfflineDataUploadService (0 new, 1 changed, 0 removed)
    1. enum AdError.Reason
      1. + value CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
  48. ReportDefinitionService (0 new, 1 changed, 0 removed)
    1. enum ReportDefinition.ReportType
      1. value DESTINATION_URL_REPORT
  49. SharedCriterionService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  50. = SharedSetService (no changes)
  51. TargetingIdeaService (0 new, 3 changed, 0 removed)
    1. enum BudgetError.Reason
      1. + value BUDGET_CANNOT_BE_EXPLICITLY_SHARED
    2. enum ContentLabelType
      1. value AFE
      2. value CONFLICT
      3. value UGC_FORUMS
      4. value UGC_IMAGES
      5. value UGC_SOCIAL
      6. value UGC_VIDEOS
      7. value SIRENS
      8. value ALLOWED_GAMBLING_CONTENT
    3. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  52. TrafficEstimatorService (0 new, 1 changed, 0 removed)
    1. enum ContentLabelType
      1. value AFE
      2. value CONFLICT
      3. value UGC_FORUMS
      4. value UGC_IMAGES
      5. value UGC_SOCIAL
      6. value UGC_VIDEOS
      7. value SIRENS
      8. value ALLOWED_GAMBLING_CONTENT
  53. TrialAsyncErrorService (0 new, 4 changed, 0 removed)
    1. enum AdError.Reason
      1. + value CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
    2. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE
    3. enum CampaignError.Reason
      1. + value CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP
      2. value SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE
      3. value PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
    4. enum CriterionError.Reason
      1. + value CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
      2. + value ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
  54. TrialService (0 new, 4 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE
    2. enum BudgetError.Reason
      1. + value BUDGET_CANNOT_BE_EXPLICITLY_SHARED
    3. enum CampaignError.Reason
      1. + value CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP
      2. value SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE
      3. value PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
    4. type Trial
      1. + field trafficSplitType

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.