版本说明

已停用的版本

201609 版

通用应用广告系列

帐户管理

转化

定位

  • 利用 MutateMembersOperand 的全新 removeAll 字段,您现在可以指明您的 REMOVE 操作是要移除 CrmBasedUserList 的所有成员,还是仅移除操作数中所列的成员
  • 为了防止对搜索广告系列添加仅限展示广告网络条件,现在当您尝试对搜索广告系列或其广告组添加以下任何条件时,相关请求将失败,并发生 OperationAccessDenied.OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE 错误:
    • AppPaymentModel
    • Carrier
    • MobileDevice
    • OperatingSystemVersion
    有关按广告系列类型细分的每种条件类型的可用情况,请查看条件用法参考文档
  • 同样,如果您尝试对展示广告系列添加 Webpage 条件,也会遇到 OperationAccessDenied.OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE 错误,因为 Webpage 条件专门针对动态搜索广告
  • CAN_NOT_MUTATE_SENSITIVE_USERLIST 错误原因已添加到 UserListError,以指示 mutate 操作中的某个用户列表是否因隐私或法律方面的原因,而被标记为不可更改。

AdWords 广告系列实验

报告

按转化来源细分

  • 对多种报告添加了 ExternalConversionSource 字段。请使用该字段来按来源(例如:WebsiteAnalyticsImport from calls)细分转化数据。

视频四分值列和点击类型

  • 视频四分值列VideoQuartile25VideoQuartile50VideoQuartile75VideoQuartile100)不再与 ClickType 列相兼容。如果将任何视频四分值列纳入到还包含 ClickType 的报告请求中,您将收到 ReportDefinitionError.INVALID_FIELD_NAME_FOR_REPORT 错误。

受众群体报告的排除条件

新的报告字段

  • CLICK_PERFORMANCE_REPORT 添加了以下字段,针对每次点击的兴趣区域 (AOI) 和实际所在位置 (LOP) 条件提供更多详情:
    • AoiCountryCriteriaId
    • AoiRegionCriteriaId
    • AoiMetroCriteriaId
    • AoiCityCriteriaId
    • LopCountryCriteriaId
    • LopRegionCriteriaId
    • LopMetroCriteriaId
    • LopCityCriteriaId
  • AD_PERFORMANCE_REPORT 添加了对应于 ResponsiveDisplayAdlogoImagemarketingImageEnhancedDisplayCreativeLogoImageMediaIdEnhancedDisplayCreativeMarketingImageMediaId 字段。

已移除的报告字段

从所有报告中移除了与已移除的 ExperimentService 相关的以下字段:

  • AdvertiserExperimentSegmentationBin
  • ClickSignificance
  • CostSignificance
  • CpcSignificance
  • CpmSignificance
  • CtrSignificance
  • CtrSignificance
  • ImpressionSignificance
  • PositionSignificance
  • ViewThroughConversionsSignificance

迁移指南

201609 版迁移指南总结了此版本所做的重要更改。

API 更改

  1. - ExperimentService
  2. + OfflineCallConversionFeedService
  3. = AccountLabelService (no changes)
  4. = AdCustomizerFeedService (no changes)
  5. AdGroupAdService (0 new, 2 changed, 1 removed)
    1. type AdGroupAd
      1. field experimentData
    2. enum MediaError.Reason
      1. + value INVALID_MIME_TYPE
    3. type ExperimentError
  6. AdGroupBidModifierService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
  7. AdGroupCriterionService (0 new, 4 changed, 1 removed)
    1. type BiddableAdGroupCriterion
      1. field experimentData
    2. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    3. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    4. enum MultiplierError.Reason
      1. value MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
    5. type ExperimentError
  8. AdGroupExtensionSettingService (0 new, 3 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    2. enum ExtensionSettingError.Reason
      1. + value PRICE_EXTENSION_HAS_TOO_MANY_ITEMS
    3. enum FeedItemQualityDisapprovalReasons
      1. + value DESCRIPTION_HAS_PRICE_QUALIFIERS
      2. + value UNSUPPORTED_LANGUAGE
      3. + value HEADER_OR_DESCRIPTION_HAS_PRICE
  9. = AdGroupFeedService (no changes)
  10. AdGroupService (0 new, 4 changed, 1 removed)
    1. type AdGroup
      1. field experimentData
    2. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    3. enum MultiplierError.Reason
      1. value MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
    4. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
    5. type ExperimentError
  11. = AdParamService (no changes)
  12. AdwordsUserListService (0 new, 3 changed, 0 removed)
    1. enum MutateMembersError.Reason
      1. + value INVALID_REMOVEALL_OPERATION
      2. + value INVALID_OPERATION_ORDER
    2. type MutateMembersOperand
      1. + field removeAll
    3. enum UserListError.Reason
      1. + value CAN_NOT_MUTATE_SENSITIVE_USERLIST
      2. + value CANNOT_MODIFY_BILLABLE_RECORD_COUNT
  13. = BatchJobService (no changes)
  14. BiddingStrategyService (0 new, 1 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
  15. BudgetOrderService (0 new, 1 changed, 0 removed)
    1. type BudgetOrder
      1. + field totalAdjustments
  16. = BudgetService (no changes)
  17. CampaignCriterionService (0 new, 3 changed, 0 removed)
    1. type CampaignCriterion
      1. + field campaignCriterionStatus
    2. enum CampaignCriterionError.Reason
      1. + value CANNOT_SET_STATUS_FOR_CRITERIA_TYPE
      2. + value CANNOT_SET_STATUS_FOR_EXCLUDED_CRITERIA
    3. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
  18. CampaignExtensionSettingService (0 new, 3 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    2. enum ExtensionSettingError.Reason
      1. + value PRICE_EXTENSION_HAS_TOO_MANY_ITEMS
    3. enum FeedItemQualityDisapprovalReasons
      1. + value DESCRIPTION_HAS_PRICE_QUALIFIERS
      2. + value UNSUPPORTED_LANGUAGE
      3. + value HEADER_OR_DESCRIPTION_HAS_PRICE
  19. = CampaignFeedService (no changes)
  20. CampaignService (8 new, 12 changed, 0 removed)
    1. + type ListError
    2. + enum ListError.Reason
    3. + enum PolicyTopicEvidenceType
    4. + type TargetingSetting
    5. + type TargetingSettingDetail
    6. + enum UniversalAppBiddingStrategyGoalType
    7. + enum UniversalAppCampaignAsset
    8. + type UniversalAppCampaignSetting
    9. enum AdvertisingChannelSubType
      1. + value UNIVERSAL_APP_CAMPAIGN
    10. enum AdvertisingChannelType
      1. + value MULTI_CHANNEL
    11. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    12. type Campaign
      1. + field selectiveOptimization
    13. enum CampaignError.Reason
      1. + value MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
      2. + value AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
      3. value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
    14. type ListError
      1. + field reason
    15. enum PolicyTopicEntryType
      1. + value UNKNOWN
      2. + value PROHIBITED
      3. + value LIMITED
    16. type PolicyTopicEvidence
      1. + field policyTopicEvidenceType
    17. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
    18. type TargetingSetting
      1. + field details
    19. type UniversalAppCampaignAdsPolicyDecisions
      1. + field universalAppCampaignAsset
    20. type UniversalAppCampaignSetting
      1. + field universalAppBiddingStrategyGoalType
  21. = CampaignSharedSetService (no changes)
  22. = ConstantDataService (no changes)
  23. ConversionTrackerService (1 new, 2 changed, 0 removed)
    1. + type UploadCallConversion
    2. type ConversionTracker
      1. + field attributionModelType
      2. + field dataDrivenModelStatus
    3. enum ConversionTrackingError.Reason
      1. + value ATTRIBUTION_MODEL_IS_UNEDITABLE
      2. + value DATA_DRIVEN_MODEL_WAS_NEVER_GENERATED
      3. + value DATA_DRIVEN_MODEL_IS_EXPIRED
      4. + value DATA_DRIVEN_MODEL_IS_STALE
      5. + value DATA_DRIVEN_MODEL_IS_UNKNOWN
  24. CustomerExtensionSettingService (0 new, 3 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    2. enum ExtensionSettingError.Reason
      1. + value PRICE_EXTENSION_HAS_TOO_MANY_ITEMS
    3. enum FeedItemQualityDisapprovalReasons
      1. + value DESCRIPTION_HAS_PRICE_QUALIFIERS
      2. + value UNSUPPORTED_LANGUAGE
      3. + value HEADER_OR_DESCRIPTION_HAS_PRICE
  25. = CustomerFeedService (no changes)
  26. CustomerService (2 new, 5 changed, 0 removed)
    1. + operation getServiceLinks
    2. + operation mutateServiceLinks
    3. type ConversionTrackingSettings
      1. field conversionOptimizerMode
    4. enum CustomerError.Reason
      1. + value INVALID_SERVICE_LINK
      2. + value INVALID_STATUS
    5. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
    6. operation getServiceLinks
      1. + response rval
      2. + parameter selector
    7. operation mutateServiceLinks
      1. + parameter operations
      2. + response rval
  27. = CustomerSyncService (no changes)
  28. = DataService (no changes)
  29. DraftAsyncErrorService (0 new, 7 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    2. enum CampaignCriterionError.Reason
      1. + value CANNOT_SET_STATUS_FOR_CRITERIA_TYPE
      2. + value CANNOT_SET_STATUS_FOR_EXCLUDED_CRITERIA
    3. enum CampaignError.Reason
      1. + value MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
      2. + value AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
      3. value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
    4. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    5. enum MediaError.Reason
      1. + value INVALID_MIME_TYPE
    6. enum MultiplierError.Reason
      1. value MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
    7. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
  30. DraftService (0 new, 1 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
  31. FeedItemService (0 new, 2 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    2. enum FeedItemQualityDisapprovalReasons
      1. + value DESCRIPTION_HAS_PRICE_QUALIFIERS
      2. + value UNSUPPORTED_LANGUAGE
      3. + value HEADER_OR_DESCRIPTION_HAS_PRICE
  32. = FeedMappingService (no changes)
  33. = FeedService (no changes)
  34. = LabelService (no changes)
  35. = LocationCriterionService (no changes)
  36. ManagedCustomerService (0 new, 1 changed, 0 removed)
    1. type ManagedCustomer
      1. field companyName
  37. MediaService (0 new, 1 changed, 0 removed)
    1. enum MediaError.Reason
      1. + value INVALID_MIME_TYPE
  38. OfflineConversionFeedService (0 new, 1 changed, 0 removed)
    1. enum OfflineConversionError.Reason
      1. + value TOO_RECENT_CONVERSION_TYPE
  39. = ReportDefinitionService (no changes)
  40. SharedCriterionService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
  41. = SharedSetService (no changes)
  42. TargetingIdeaService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
  43. = TrafficEstimatorService (no changes)
  44. TrialAsyncErrorService (0 new, 7 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    2. enum CampaignCriterionError.Reason
      1. + value CANNOT_SET_STATUS_FOR_CRITERIA_TYPE
      2. + value CANNOT_SET_STATUS_FOR_EXCLUDED_CRITERIA
    3. enum CampaignError.Reason
      1. + value MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
      2. + value AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
      3. value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
    4. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    5. enum MediaError.Reason
      1. + value INVALID_MIME_TYPE
    6. enum MultiplierError.Reason
      1. value MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
    7. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
  45. TrialService (0 new, 2 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    2. enum CampaignError.Reason
      1. + value MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
      2. + value AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
      3. value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE

发送以下问题的反馈:

此网页
AdWords API
AdWords API
需要帮助?请访问我们的支持页面