Release Notes for v201809

What's new

Ads and ad formats

• The description2 and headlinePart3 fields were added to ExpandedTextAd.

• The description2 field was added to ExpandedDynamicSearchAd.

• The maximum character count was increased from 80 to 90 for description1 and description2 of ExpandedTextAd, ExpandedDynamicSearchAd, and CallOnlyAd.

• The adStrengthInfo field was added to AdGroupAd to indicate the strength of each ad and the actions you can take to improve it.

• Attempts to add a CallOnlyAd or CALL extension will fail with the error reason CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED if the Call & Messaging Ads Terms are released for your account, but you have not yet acknowledged the terms.

• Mutate requests for AdGroupAdService and AdService will now fail with a CertificateDomainMismatchConstraint if a certificate does not include the correct domain. Previously, these requests failed with an InternalApiError.

• The youTubeVideos field was added to support video assets hosted on YouTube for MultiAssetResponsiveDisplayAds. This feature is only available to whitelisted users.

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