Notas da versão

Versões desativadas

v201609

Campanhas universais para apps

Gerenciamento de contas

  • O campo companyName foi removido de ManagedCustomer pois continha informações desatualizadas. Como alternativa, use o descriptiveName em Customer.
  • Com o BudgetOrderService apenas para lista de permissões, agora é possível recuperar ajustes por meio do novo totalAdjustments. Certifique-se de analisar a documentação de serviço para informações sobre o comportamento dos campos de orçamento.
  • Com os novos métodos do CustomerService, getServiceLinks() e mutateServiceLinks() apenas para lista de permissões, você pode aceitar um convite para vincular sua conta do Google AdWords a uma conta do Merchant Center.

Conversões

Segmentação

  • Com o novo campo removeAll do MutateMembersOperand, agora você pode indicar se a operação REMOVE removerá todos os membros de uma CrmBasedUserList ou apenas os membros listados no operando.
  • Com o intuito de evitar a adição do critério "Apenas da Rede de Display" às campanhas da Rede de Pesquisa, se você tentar adicionar qualquer um dos critérios a seguir a uma campanha da Rede de Pesquisa ou aos grupos de anúncios dessa campanha, o erro OperationAccessDenied.OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE ocorrerá, e a solicitação falhará:
    • AppPaymentModel
    • Carrier
    • MobileDevice
    • OperatingSystemVersion
    Para detalhar a disponibilidade de cada tipo de critério por tipo de campanha, confira a documentação de referência sobre o uso dos critérios.
  • Se você também tentar adicionar um critério Webpage a uma campanha da Rede de Display, o erro OperationAccessDenied.OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE ocorrerá, pois o critério Webpage funciona especificamente para anúncios dinâmicos da Rede de Pesquisa.
  • O motivo do erro CAN_NOT_MUTATE_SENSITIVE_USERLIST foi adicionado a UserListError para indicar se uma lista de usuários em uma operação mutate foi definida como imutável devido a privacidade ou motivos legais.

Experiências de campanha do Google AdWords

Relatórios

Segmentação por origem da conversão

  • O campo ExternalConversionSource foi adicionado a vários relatórios. Use esse campo para segmentar suas conversões por origem, por exemplo: Website, Analytics, Import from calls.

Colunas de quartil de vídeo e tipo de clique

  • As colunas de quartil de vídeo (VideoQuartile25, VideoQuartile50, VideoQuartile75 e VideoQuartile100) não são mais compatíveis com a coluna ClickType. Se você incluir uma coluna de quartil de vídeo em uma solicitação de relatório que também inclui a coluna ClickType, o erro ReportDefinitionError.INVALID_FIELD_NAME_FOR_REPORT ocorrerá.

Exclusões no Relatório de público-alvo

Novos campos de relatório

  • Os campos a seguir foram adicionados a CLICK_PERFORMANCE_REPORT para fornecer detalhes adicionais aos critérios "Área de interesse" (AOI, na sigla em inglês) e "Local de presença" (LOP, na sigla em inglês) de cada clique:
    • AoiCountryCriteriaId
    • AoiRegionCriteriaId
    • AoiMetroCriteriaId
    • AoiCityCriteriaId
    • LopCountryCriteriaId
    • LopRegionCriteriaId
    • LopMetroCriteriaId
    • LopCityCriteriaId
  • Os campos EnhancedDisplayCreativeLogoImageMediaId e EnhancedDisplayCreativeMarketingImageMediaId correspondentes a logoImage e a marketingImage de ResponsiveDisplayAd foram adicionados a AD_PERFORMANCE_REPORT.

Campos removidos de relatórios

Os campos a seguir relacionados ao ExperimentService removido foram excluídos de todos os relatórios:

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

Guia de migração

As principais alterações introduzidas nesta versão estão resumidas no guia de migração da v201609.

Alterações na 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

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.