Примечания к выпуску

Предыдущие версии

Версия 201609

Универсальные кампании для приложений

Управление аккаунтами

  • Поле companyName объекта ManagedCustomer удалено, поскольку содержащиеся в нем данные более не применяются. Вместо него следует использовать поле descriptiveName объекта Customer.
  • Теперь сервис BudgetOrderService поддерживает внесение корректировок только через поле totalAdjustments. Подробнее о работе с полями, содержащими сведения о бюджете, см. в документации этого сервиса.
  • Новые методы getServiceLinks() и mutateServiceLinks() объекта CustomerService позволяют принять предложение о связывании аккаунтов AdWords и Merchant Center.

Конверсии

Таргетинг

  • Теперь с помощью нового поля removeAll операнда MutateMembersOperand можно указать, должна ли операция REMOVE удалить всех участников списка CrmBasedUserList или только указанных в поле members этого операнда.
  • Поскольку перечисленные ниже критерии действуют только в контекстно-медийной сети, при попытке их добавления в кампанию для поисковой сети теперь выдается ошибка OperationAccessDenied.OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE.
    • AppPaymentModel
    • Carrier
    • MobileDevice
    • OperatingSystemVersion
    Подробнее о том, какие типы критериев доступны в каждом типе кампаний, см. в этой таблице.
  • Также при попытке добавить критерий Webpage в кампанию для КМС выдается ошибка OperationAccessDenied.OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE, поскольку он применим только к динамическим поисковым объявлениям.
  • Объект UserListError теперь может содержать сообщение об ошибке CAN_NOT_MUTATE_SENSITIVE_USERLIST. Оно указывает о том, что список пользователей, к которому применена операция mutate, отмечен как неизменяемый из соображений конфиденциальности или по юридическим причинам.

Эксперименты в кампаниях AdWords

Отчеты

Сегментация по источникам конверсий

  • В некоторые отчеты добавлено поле ExternalConversionSource. С его помощью можно сегментировать конверсии по источникам, например: Веб-сайт, Google Analytics, Импорт: звонки.

Квартили просмотра видео и тип клика

  • Столбцы квартилей просмотра видео (VideoQuartile25, VideoQuartile50, VideoQuartile75, VideoQuartile100) теперь несовместимы со столбцом ClickType. Если включить в запрос отчета любой из столбцов квартилей и столбец ClickType, будет возвращена ошибка ReportDefinitionError.INVALID_FIELD_NAME_FOR_REPORT.

Исключения в отчете об аудиториях

  • Теперь отчет AUDIENCE_PERFORMANCE_REPORT не возвращает строки исключенных критериев (т. е. строки, для которых IsNegative = true).

Новые поля отчетов

  • В отчет CLICK_PERFORMANCE_REPORT добавлены перечисленные ниже поля. В них приводятся данные для каждого клика, характеризующие место, которым интересуется пользователь (AOI), и место, где он находится (LOP).
    • AoiCountryCriteriaId
    • AoiRegionCriteriaId
    • AoiMetroCriteriaId
    • AoiCityCriteriaId
    • LopCountryCriteriaId
    • LopRegionCriteriaId
    • LopMetroCriteriaId
    • LopCityCriteriaId
  • В отчет AD_PERFORMANCE_REPORT добавлены поля EnhancedDisplayCreativeLogoImageMediaId и EnhancedDisplayCreativeMarketingImageMediaId, соответствующие полям logoImage и marketingImage объекта ResponsiveDisplayAd.

Удаленные поля отчетов

В связи с удалением сервиса 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

Оставить отзыв о...

Текущей странице
Нужна помощь? Обратитесь в службу поддержки.