Release Notes for v201809

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 campaignPriority of ShoppingSetting was simplified as follows:

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

      In this case, 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