Release Notes for v201708

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

What's new

Bidding

  • The new MAXIMIZE_CONVERSIONS bidding strategy type and corresponding scheme are now supported. The updated bidding guide has additional details.
  • Responses for getCampaignCriterionBidLandscape DataService requests will now return bid modifiers for tablet and desktop Platform criteria. Previously, responses only contained bid modifiers for the mobile Platform criterion.
  • The query() method was added to CampaignBidModifierService for users who prefer to use AWQL-based requests.

Remarketing

  • The new CombinedRuleUserList type was added to
    AdwordsUserListService to support user lists based on the following conditions:
    • Visitors of a page who did not visit another page.
    • Visitors of a page who visited another page.
  • The new read-only uploadKeyType field was added to CrmBasedUserList to indicate the type of member data contained in each list.
  • The userId field was added to the Member type in AdwordsUserListService to allow whitelisted users to upload members based on an externally generated user ID.
  • The dataSourceType field was added to CrmBasedUserList to allow users who are whitelisted for third-party member data uploads to indicate the source of the third-party data.

Responsive ads for display

  • Several fields were added to ResponsiveDisplayAd to allow you to set call to action text and add various images to your Display ads. Check out the updated guide for more details.

Dynamic Search Ads

Conversions

  • The isExternallyAttributed field was added to UploadConversion to allow you to create conversion actions where you can indicate the portion of each conversion that is attributed to AdWords clicks. Check out the updated conversion tracking guide and AdWords Help Center article for details.
  • The externalAttributionCredit and externalAttributionModel fields were added to OfflineConversionFeed for conversion actions where isExternallyAttributed = true.

Targeting

  • The new IncomeRange criterion type allows you to target, exclude, and bid based on income range. This is a more straightforward replacement for the IncomeOperand matching function operand removed in v201702, since you can use IncomeRange without setting up a matching function.
  • Requests that attempt to create a SharedSet in a manager account will now fail with SharedSetError.MANAGER_CUSTOMER_CANNOT_CREATE_SHARED_SET_OF_THIS_TYPE if the type is NEGATIVE_KEYWORDS.

Billing

  • When setting or changing the billing account for a client account via BudgetOrderService, the primaryBillingId field is now required. If such a request does not specify this value, it will fail with a BudgetOrderError with reason INVALID_BILLING_ACCOUNT.

Reporting

New report fields

  • The ProductTitle field was added to the SHOPPING_PERFORMANCE_REPORT. Use this field to retrieve the current title for each OfferId.
  • The QueryTargetingStatus field was added to the KEYWORDLESS_QUERY_REPORT and the SEARCH_QUERY_PERFORMANCE_REPORT. Use this field to determine if a search term in your report matches one of your targeted or excluded keywords.
  • The following fields were added to the AD_PERFORMANCE_REPORT to allow you to include additional attributes for
    ResponsiveDisplayAds in your reports.
    • AllowFlexibleColor
    • CallToActionText
    • EnhancedDisplayCreativeLandscapeLogoImageMediaId
    • EnhancedDisplayCreativeMarketingImageSquareMediaId
    • FormatSetting
    • MainColor
    • PricePrefix
    • PromoText

Field value changes

The TABLE_EXTENSION enum value of ClickType was renamed to PRICE_EXTENSION in all reports.

Migration guide

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

API changes

  1. = AccountLabelService (no changes)
  2. = AdCustomizerFeedService (no changes)
  3. AdGroupAdService (2 new, 4 changed, 0 removed)
    1. + enum DisplayAdFormatSetting
    2. + type DynamicSettings
    3. enum Ad.Type
      1. + value EXPANDED_DYNAMIC_SEARCH_AD
    4. enum AdError.Reason
      1. + value CANNOT_SET_ALLOW_FLEXIBLE_COLOR_FALSE
      2. + value CANNOT_SET_COLOR_CONTROL_WHEN_NATIVE_FORMAT_SETTING
      3. + value INVALID_CALL_TO_ACTION_TEXT
    5. enum PolicyTopicEvidenceType
      1. + value LANGUAGE
    6. type ResponsiveDisplayAd
      1. + field accentColor
      2. + field allowFlexibleColor
      3. + field callToActionText
      4. + field dynamicDisplayAdSettings
      5. + field formatSetting
      6. + field mainColor
      7. + field squareMarketingImage
  4. AdGroupBidModifierService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  5. AdGroupCriterionService (2 new, 2 changed, 0 removed)
    1. + type IncomeRange
    2. + type MaximizeConversionsBiddingScheme
    3. enum BiddingStrategyType
      1. + value MAXIMIZE_CONVERSIONS
    4. enum Criterion.Type
      1. + value INCOME_RANGE
  6. AdGroupExtensionSettingService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  7. = AdGroupFeedService (no changes)
  8. AdGroupService (1 new, 1 changed, 0 removed)
    1. + type MaximizeConversionsBiddingScheme
    2. enum BiddingStrategyType
      1. + value MAXIMIZE_CONVERSIONS
  9. = AdParamService (no changes)
  10. AdwordsUserListService (1 new, 3 changed, 0 removed)
    1. + type CombinedRuleUserList
    2. type CrmBasedUserList
      1. + field dataSourceType
      2. + field uploadKeyType
    3. type Member
      1. + field userId
    4. enum MutateMembersError.Reason
      1. + value INCOMPATIBLE_UPLOAD_KEY_TYPE
  11. = BatchJobService (no changes)
  12. BiddingStrategyService (1 new, 1 changed, 0 removed)
    1. + type MaximizeConversionsBiddingScheme
    2. enum BiddingStrategyType
      1. + value MAXIMIZE_CONVERSIONS
  13. BudgetOrderService (0 new, 1 changed, 0 removed)
    1. enum CustomerOrderLineError.Reason
      1. value NEGATIVE_SPEND
      2. value CANCEL_ACTIVE
      3. value COS_CHANGE
      4. value NON_ADWORDS
      5. value START_DATE_AFTER_ACTUAL
      6. value CANNOT_CANCEL_NEW
      7. value CANNOT_PROMOTE_NON_PENDING_ORDERLINE
      8. value UPDATE_ORDERLINE_WILL_SHIFT_CURRENT
      9. value INVALID_STATUS_CHANGE
  14. = BudgetService (no changes)
  15. CampaignBidModifierService (1 new, 2 changed, 0 removed)
    1. + operation query
    2. enum Criterion.Type
      1. + value INCOME_RANGE
    3. operation query
      1. + parameter query
      2. + response rval
  16. CampaignCriterionService (1 new, 1 changed, 0 removed)
    1. + type IncomeRange
    2. enum Criterion.Type
      1. + value INCOME_RANGE
  17. CampaignExtensionSettingService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  18. = CampaignFeedService (no changes)
  19. = CampaignGroupPerformanceTargetService (no changes)
  20. = CampaignGroupService (no changes)
  21. CampaignService (1 new, 2 changed, 0 removed)
    1. + type MaximizeConversionsBiddingScheme
    2. enum BiddingStrategyType
      1. + value MAXIMIZE_CONVERSIONS
    3. enum PolicyTopicEvidenceType
      1. + value LANGUAGE
  22. = CampaignSharedSetService (no changes)
  23. ConstantDataService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  24. ConversionTrackerService (0 new, 2 changed, 0 removed)
    1. enum ConversionTrackingError.Reason
      1. + value CANNOT_ADD_EXTERNALLY_ATTRIBUTED_SALESFORCE_CONVERSION
      2. + value ATTRIBUTION_MODEL_CANNOT_BE_UNKNOWN
    2. type UploadConversion
      1. + field isExternallyAttributed
  25. CustomerExtensionSettingService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  26. = CustomerFeedService (no changes)
  27. = CustomerService (no changes)
  28. = CustomerSyncService (no changes)
  29. = DataService (no changes)
  30. DraftAsyncErrorService (0 new, 1 changed, 0 removed)
    1. enum AdError.Reason
      1. + value CANNOT_SET_ALLOW_FLEXIBLE_COLOR_FALSE
      2. + value CANNOT_SET_COLOR_CONTROL_WHEN_NATIVE_FORMAT_SETTING
      3. + value INVALID_CALL_TO_ACTION_TEXT
  31. = DraftService (no changes)
  32. FeedItemService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  33. = FeedMappingService (no changes)
  34. = FeedService (no changes)
  35. = LabelService (no changes)
  36. LocationCriterionService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  37. = ManagedCustomerService (no changes)
  38. = MediaService (no changes)
  39. = OfflineCallConversionFeedService (no changes)
  40. = OfflineConversionFeedService (no changes)
  41. = ReportDefinitionService (no changes)
  42. SharedCriterionService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  43. SharedSetService (0 new, 1 changed, 0 removed)
    1. enum SharedSetError.Reason
      1. + value MANAGER_CUSTOMER_CANNOT_CREATE_SHARED_SET_OF_THIS_TYPE
  44. TargetingIdeaService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  45. TrafficEstimatorService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. + value INCOME_RANGE
  46. TrialAsyncErrorService (0 new, 1 changed, 0 removed)
    1. enum AdError.Reason
      1. + value CANNOT_SET_ALLOW_FLEXIBLE_COLOR_FALSE
      2. + value CANNOT_SET_COLOR_CONTROL_WHEN_NATIVE_FORMAT_SETTING
      3. + value INVALID_CALL_TO_ACTION_TEXT
  47. = TrialService (no changes)

Send feedback about...

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