Google Ads

Release Notes for v201809  |  AdWords API  |  Google Developers

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 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

Leave a Reply

Your email address will not be published. Required fields are marked *

Back to top button
Close