v17.1.0 (07/08/2024)
Os novos recursos e atualizações a seguir foram adicionados na v17_1.
Recursos
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
permite remover recursos automáticos especificados vinculados a anúncios responsivos de pesquisa.
Públicos-alvo
- Novos valores de tipo enumerado em
UserListCustomerTypeCategory
:LOYALTY_TIER_1_MEMBERS
LOYALTY_TIER_2_MEMBERS
LOYALTY_TIER_3_MEMBERS
LOYALTY_TIER_4_MEMBERS
LOYALTY_TIER_5_MEMBERS
LOYALTY_TIER_6_MEMBERS
LOYALTY_TIER_7_MEMBERS
Campanhas
ShareablePreviewService.GenerateShareablePreviews()
gera os URLs (shareable_preview_url
na resposta) das visualizações de anúncios compartilháveis de grupos de recursos ativados e pausados.- O campo
expiration_date_time
indica a data de validade dos URLs na resposta. - Se ocorrer um erro, o método retornará
partial_failure_error
em vez dos URLs.
- O campo
Histórico de alterações
- Novo tipo de recurso de status de mudança:
ASSET_GROUP
.
Conversões
- Novo campo de segmento para a versão SKAdNetwork:
segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary
, que exibe os diagnósticos do upload de conversões no nível da ação de conversão.- As métricas a seguir são adicionadas aos relatórios de diagnóstico off-line para transmitir o número de conversões enviadas que ainda estão sendo processadas:
Planejamento
AudienceInsights.GenerateAudienceOverlapInsights()
, que aceita um atributo principal de entrada e uma coleção de atributos de público-alvo, além de retornar as estimativas de sobreposição do alcance em potencial do YouTube entre o atributo principal e os atributos de público-alvo.
Relatórios
- Suporte à segmentação de
per_store_view
com base emsegments.date
Vídeos
- Suporte para recuperar informações relacionadas às seguintes estratégias de lances padrão para campanhas de vídeo usando relatórios, como
ad_group
ecampaign
:Campaign.fixed_cpm
(CPM fixo (custo por mil impressões))Campaign.target_cpv
(CPV (custo por visualização) desejado)
Campaign.video_campaign_settings
, que permite determinar em quais inventários os anúncios em vídeo podem ser exibidos usando os seguintes campos do relatório:segments.ad_format_type
, que permite segmentar os seguintes relatórios com base no tipo de formato do anúncio em vídeo:
v17 (05/06/2024)
Os recursos e alterações a seguir foram adicionados na v17.
Anúncios
AdService.getAd
foi removido. Isso trazAdService
de acordo com outros serviços da API Google Ads. Consulte Como recuperar objetos para a maneira recomendada de buscar anúncios e outros tipos de recursos.- Adicionadas mais validações para
ImageAdInfo.image_asset
referente a as dimensões e o formato. Os seguintes erros podem ser gerados se a imagem for inválido:
Recursos
- Um novo tipo enumerado foi adicionado:
ClickType.AD_IMAGE
- Os seguintes novos relatórios foram adicionados com novas métricas para campanhas Performance Max e de pesquisa:
Públicos-alvo
Jobs em lote
- Adicionada
BatchJobError.REQUEST_TOO_LARGE
, que será gerada quando oAddBatchJobOperationsRequest
enviado tiver mais de 10484504 bytes. - Foi adicionado suporte à configuração
MutateOperation.asset_group_operation
. ao usarBatchJobService
. Isso permite que você usar o processamento em lote para criar e gerenciar campanhas Performance Max inteiras. Confira nosso novo guia dedicado.
Campanhas
- Discovery renomeado para Geração de demanda em todos os campos, tipos enumerados e erros
recursos da API Google Ads, como campanhas, anúncios e recursos. Para
exemplo,
AdvertisingChannelType.DISCOVERY
agora estáAdvertisingChannelType.DEMAND_GEN
. - Adicionada
Campaign.keyword_match_type
para permitir que você defina o tipo de correspondência de palavra-chave para todas as palavras-chave em uma campanha.
Conversões
- Para SKAdNetwork
conversões
segments.sk_ad_network_conversion_value
foi renomeado comosegments.sk_ad_network_fine_conversion_value
.segments.sk_ad_network_redistributed_fine_conversion_value
foi adicionado.
- As métricas a seguir agora são retornadas com a resposta, mesmo quando eles são zero. Isso as torna consistentes com outras métricas.
Critérios
- Adicionado aos seguintes campos em
AdGroupCriterion
para mostrar se o critério do grupo de anúncios está sendo veiculado ou por que ele não está do modelo:primary_status
primary_status_reasons
- Foi adicionado suporte para
metrics.search_impression_share
. paragender_view
- Foi adicionado suporte para
metrics.phone_calls
. parakeyword_view
Serviços locais
LocalServicesLeadService.AppendLeadConversation()
adicionado usada para anexar um novoLocalServicesLeadConversation
paraLocalServicesLead
, que envia a mensagens aos usuários por meio de canais apropriados, como SMS, dependendo de como lead foi criado.- O tamanho de
AppendLeadConversationRequest.conversations
é limitado a 1.000. - Apenas
LocalServicesLead
comlead_type
definido comoLeadType.MESSAGE
pode ser especificadoConversation.local_services_lead
.
- O tamanho de
- Novos valores de tipo enumerado foram adicionados
ConversationType
WHATSAPP
para representar uma conversa iniciada pelo WhatsApp.ADS_API
para representar uma conversa iniciada usando o novoLocalServicesLeadService.AppendLeadConversation()
.
- Estes novos campos foram adicionados a
local_services_verification_artifact
:local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
Relatórios
- Agora é possível selecionar apenas campos relacionados a um produto vinculado
ao consultar
product_link
. Seleção de vários campos de vários produtos vinculados geraráQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
Por exemplo:product_link.advertising_partner.customer
eproduct_link.data_partner.data_partner_id
não podem ser selecionados na mesma consulta. - Como transmitir um
page_size
paraGoogleAdsService.Search
vai resultar em umaRequestError.PAGE_SIZE_NOT_SUPPORTED
erro.
Compras
- Adicionamos um novo relatório
shopping_product
, que corresponde à página Produtos da interface do Google Ads. Ele é compatível com o retorno dados relacionados ao estado atual dos produtos do Google Merchant Center contas vinculadas a uma conta do Google Ads.- É possível filtrar métricas
shopping_product
gera um relatório usandosegments.date
ao usarGoogleAdsService.Search
ouGoogleAdsService.SearchStream
A segmentação por data não é permitida e retornará umShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
erro.
- É possível filtrar métricas
Metas unificadas
UserListCustomerTypeService.MutateUserListCustomerTypes()
adicionado para configurar o público-alvo tipos.CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
foi removido. Para definir as configurações de público-alvo das metas de ciclo de vida do cliente, useUserListCustomerTypeService.MutateUserListCustomerTypes()
.- Anexar ou remover uma lista de usuários por configuração
UserListCustomerType.customer_type_category
paraUserListCustomerTypeCategory.PURCHASERS
para incluí-la ou excluí-la de uma definição de cliente existente. para as metas de ciclo de vida do cliente, respectivamente. Acesse segmente sua públicos-alvo para mais detalhes.
- Anexar ou remover uma lista de usuários por configuração
Vídeos
- Os seguintes valores foram adicionados ao
ContentLabelType
Você pode excluir estesContentLabelTypes
no nível do cliente:BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
AdVideoAsset.ad_video_asset_info
adicionado oferecer suporte às preferências de inventário para recursos de vídeo ao criarDemandGenVideoResponsiveAdInfo
- (Somente contas da lista de permissões) Criado
Campaign.video_brand_safety_suitability
mutável.
v16.1.0 (24/04/2024)
Os seguintes recursos e mudanças foram adicionados na v16.1.
Gerenciamento da conta
CustomerNegativeCriterion.ip_block
que permite adicionar um IP como critério negativo no nível do cliente.- Novo valor de tipo enumerado:
ProductLinkError.LINK_EXISTS
- Novo valor de tipo enumerado:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
Recursos
- Suporte a recursos relacionados a Geração de demanda para
ad_group_ad_asset_view
easset_field_type_view
- Novo valor de tipo enumerado:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
Públicos-alvo
- Novo valor de enumeração:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
o que limita o número de listas de usuários parecidos que um cliente pode ter a 1.000.
Campanhas
- Suporte para retornar Target
de ROAS desejado para
As campanhas para apps que usam
Relatório
campaign_simulation
. - Novo valor de tipo enumerado:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
- Novo valor de tipo enumerado:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
- Novo valor de tipo enumerado:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
Conversões
SkAdNetworkConversionValueSchema.postback_mappings
que oferece suporte à SKAdNetwork 4,0 atributos de machine learning.- Adicionado suporte para avisos para
CustomerSkAdNetworkConversionValueSchemaService
quandoMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
Quando definido comotrue
, todos os erros sem bloqueio relacionados a falhas de operação será retornado comoMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - Novos valores de tipo enumerado em
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Critérios
- Novos campos no
BrandInfo
:display_name
primary_url
rejection_reason
status
- Novo tipo enumerado:
BrandRequestRejectionReason
- Novo valor de tipo enumerado:
CriterionType.LIFE_EVENT
Experimentos
- Novo valor de enumeração:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
Serviços locais
local_services_lead.credit_details.credit_state
elocal_services_lead.credit_details.credit_state_last_update_date_time
que retorna o estado do crédito e o carimbo de data/hora em que o estado foi atualizada, respectivamente.local_services_lead_conversation.message_details.attachment_urls
que retorna os URLs que podem ser usados para fazer o download do conteúdo do anexo.
Vídeos
customer.video_brand_safety_suitability
eBrandSafetySuitability
que ajudam a recuperar a adequação de brand safety do vídeo para o cliente nível- Novo valor de enumeração:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
v16 (21/02/2024)
Os seguintes recursos e alterações foram adicionados na v16.
Gerenciamento da conta
advertising_partner
migrado deAccountLink
paraProductLink
eProductLinkInvitation
.data_partner
egoogle_ads
foram removidos deAccountLink
.- Adicionada
IdentityVerificationService
para gerenciar a verificação do anunciante.StartIdentityVerification()
é usada para iniciar uma sessão de verificação usando overification_program
Ele cria uma nova sessão de verificação e retorna uma resposta vazia para um verificação criada com sucesso.GetIdentityVerification()
pode ser usada para recuperar informações de verificação, que retorna vários objetos deIdentityVerification
. CadaIdentityVerification
inclui:verification_program
que é o tipo de programa de verificação de identidadeidentity_verification_requirement
que contém detalhes relacionados ao prazo em que o o anunciante deve concluir a verificaçãoverification_progress
que contém detalhes relacionados à sessão de verificação, incluindo:program_status
representa o status atual do item. sessão de verificaçãoaction_url
direciona o cliente a um URL para concluir o verificação.invitation_link_expiration_time
representa a data de validade. para oaction_url
- Enumerados:
- Erros:
- Adicionada
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
Recursos
- Mudanças no
asset_group
:- Adição de suporte para segmentos relacionados ao tempo, como
segments.year
esegments.month
- Transformou
campaign
em um recurso atribuído em vez de de segmentação de recursos.
- Adição de suporte para segmentos relacionados ao tempo, como
Campanhas
- Mudanças nas campanhas Geração de demanda:
- Agora é possível usar a configuração
Campaign.shopping_setting
para uma campanha Geração de demanda. - Adicionada
ShoppingSetting.disable_product_feed
para desativar o feed de produtos opcional das campanhas Geração de demanda. Ad.demand_gen_product_ad
adicionado e as respostasDemandGenProductAdInfo
, disponível para Campanhas Geração de demanda com valor não nuloCampaign.shopping_setting
.
- Agora é possível usar a configuração
- Adicionado aos campos a seguir a
AdGroup
para mostrar se o grupo de anúncios está sendo veiculado ou os motivos para isso não acontecer:primary_status
primary_status_reasons
- Adicionado aos campos a seguir a
AdGroupAd
para mostrar se o anúncio do grupo de anúncios está sendo veiculado ou por que ele não está sendo veiculado:primary_status
primary_status_reasons
- Os seguintes valores foram adicionados ao
AdGroupError
CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Experimento
Experiment.sync_enabled
foi adicionado a especificar se a sincronização deve ser ativada no experimento. Com sincronização ativado, as alterações feitas para a campanha original enquanto a experiência está sendo realizada, são automaticamente copiado para a campanha experimental.- Adicionada
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
- Adicionada
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
Hotel e Viagens
- Os seguintes campos foram adicionados ao
ListingDimensionInfo
em uma seção de Coisas legais para fazer para permitir a criação de grupos de produtos anunciados com base no estado e na cidade em que o atividades de viagem disponíveis: - Adicionado suporte para os seguintes segmentos a
travel_activity_performance_view
Serviços locais
- Adicionada
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
eBusinessRegistrationCheckArtifact
para permitir que os anunciantes monitorem o andamento do registro da empresa o processo de verificação. - Novo recurso adicionado
local_services_employee
para permitir anunciantes recuperem as informações de funcionários que eles adicionaram.
Planejamento
score
removido deAudienceInsightsAttributeMetadata
.
Recomendações
- Adicionada
RecommendationService.GenerateRecommendations()
que retorna recomendações com base nas configurações especificadas, como recomendações e tipos de canais de publicidade. Isso é especialmente útil durante a criação da campanha. - Adicionada
RecommendationMetrics.conversions_value
- As palavras-chave recomendadas com tipo de correspondência não definido agora têm
recommended_match_type
Defina comoUNSPECIFIED
em vez deUNKNOWN
. - Os seguintes tipos de recomendações foram adicionados:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
que recomenda ativar a estratégia de lances "Maximizar o valor da conversão". estratégiaIMPROVE_GOOGLE_TAG_COVERAGE
que recomenda a implantação da tag do Google em mais páginasPERFORMANCE_MAX_FINAL_URL_OPT_IN
que recomenda ativar a expansão de URL final nas campanhas Performance Max campanhasREFRESH_CUSTOMER_MATCH_LIST
que recomenda atualizar uma lista de clientes que não foi atualizada em nos últimos 90 diasCUSTOM_AUDIENCE_OPT_IN
que recomenda criar um público-alvo personalizadoLEAD_FORM_ASSET
que recomenda adicionar recursos de formulário de lead à campanha ou ao cliente nívelIMPROVE_DEMAND_GEN_AD_STRENGTH
que recomenda melhorar a qualidade do anúncio em campanhas Geração de demanda
Compras
- Adicionada
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
eCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
para fornecer erros mais detalhados às campanhas do Shopping vinculadas a uma Central de serviços de comparação de preços padrão. - Os seguintes valores foram adicionados ao
AssetGroupListingGroupFilterError
DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
Metas de ciclo de vida
update
foi adicionado aCustomerLifecycleGoalOperation
eCampaignLifecycleGoalOperation
para deixar esses tipos de operação consistentes com outros na API.
v15 (18-10-2023)
Os novos recursos e atualizações a seguir foram introduzidos na v15.
Gerenciamento da conta
- Se sua conta for suspensa devido a uma conta não autorizada,
atividade,
customer.status
ecustomer_client.status
agora são retornados comoSUSPENDED
. Antes, elas eram retornadas comoENABLED
- Agora é possível adicionar e remover um vínculo entre uma conta do Google Ads e
uma conta do Merchant Center:
- Adicionada
ProductLink.merchant_center
eMerchantCenterIdentifier
- Adicionada
LinkedProductType.MERCHANT_CENTER
- Adicionada
- Adicionada
ProductLinkInvitationService
eProductLinkInvitation
para oferecer suporte atualizando um convite de vinculação enviado por outros produtos, disponível para Hotel Merchant Center e Merchant do Google. MerchantCenterLinkService
foi removido.- Para vincular contas do Google Ads com contas do Merchant Center, use
ProductLinkInvitationService
eProductLinkService
.
- Para vincular contas do Google Ads com contas do Merchant Center, use
- Remoção de
AccountLink.hotel_center
e suporte para atualização de convites de links das contas da Central para Hotéis usandoAccountLinkService
.- Para atualizar um convite de vinculação de uma conta da Central para Hotéis, use
ProductLinkInvitationService
- Para atualizar um convite de vinculação de uma conta da Central para Hotéis, use
Recursos
ImageAdInfo.media_file
substituído porImageAdInfo.image_asset
para oferecer suporte adicionar e remover imagens usando os recursos. Como resultado, também removemosMediaFileService
, que não é mais necessário.- Adicionada
ListingGroupFilterDimension.webpage
oferecer suporte à criação de um filtro de grupo de fichas com base em rótulos e URLs personalizados substrings codificadas.AssetGroupListingGroupFilter.vertical
também foi substituído porAssetGroupListingGroupFilter.listing_source
eListingGroupFilterListingSource
asset_group_asset.source
foi adicionado para mostrar a origem do recurso do grupo de recursos.- Adicionada
ad_group_ad_asset_view.source
para mostrar a origem do recurso de anúncio do grupo de anúncios.
Públicos-alvo
- Para Segmentação por lista de clientes, adicionada
CustomerMatchUserListMetadata.consent
suporte ao consentimento. A partir de 6 de março de 2024, se o consentimento for ausente para usuários do EEE, o valor do consentimento será determinado como não consentido. Os dados de usuários do EEE sem consentimento de cookies não serão processados e não poderão ser usados para anúncios personalização usando a Segmentação por lista de clientes. Confira nossa Guia da Segmentação por lista de clientes para mais detalhes. - Para vendas na loja, adicionado
UserData.consent
a suporte para fornecer um consentimento. Confira nossa Guia de vendas na loja para mais detalhes. Se você usa a Segmentação por lista de clientes com vendas na loja, consulte Perguntas frequentes para informações imprecisas ou inadequadas. - Adicionada
UserList.lookalike_user_list
para oferecem suporte à criação de um parecido segmento, um público-alvo criado com base no público-alvo de origem informado. É possível usar segmentos semelhantes em uma campanha Geração de demanda .
Campanhas
Atualizações nas campanhas Performance Max:
- O
AssetGroupSignal
agora oferece suporte a duas que podem ser anexados a um grupo de recursos para aprimorar a segmentação:AssetGroupSignal.audience
- Adicionados
Audience.scope
eAudience.asset_group
para limitar uso do público-alvo a um grupo de recursos específico.Audience.asset_group
precisa ser definido somente seAudience.scope
forASSET_GROUP
.
- Adicionados
AssetGroupSignal.search_theme
- Adicionada
CriterionType.SEARCH_THEME
para oferecer suporte a esse novo tipo de critério. Esse novo tipo de critério só pode ser usados em campanhas Performance Max para criar umaAssetGroupSignal
preenchendo oAssetGroupSignal.search_theme
com um critérioSearchThemeInfo
.
- Adicionada
- Adicionada
AssetGroupSignalOperation.exempt_policy_violation_keys
para oferecer suporte à solicitação de isenção ao adicionar indicadores do grupo de recursos. - Um novo item foi adicionado
asset_group_top_combination_view
para informar os recursos com melhor performance no nível do grupo. - Agora é possível consultar
asset_group
com campos de métricas. para ajudar na recuperação da performance de uma campanha Performance Max. - Em
PerformanceMaxUpgradeStatus
,UPGRADE_ELIGIBLE
foi renomeado comoUPGRADE_ELIGIBLE
.
- O
Para Geração de demanda e Descoberta campanhas de CPA desejado, simulações de lances de CPA desejado no nível da campanha (
campaign_simulation.target_cpa_point_list.points
) agora retornaTargetCpaSimulationPoint.interactions
em vez deTargetCpaSimulationPoint.clicks
.Adição de
BrandSuggestionService
, que pode Sugerir marcas com base no prefixo de marca fornecido e na lista excluída de marcas. Essas marcas podem ser usadas para criar CritérioBRAND
adicionado a um conjunto compartilhado deBRANDS
, e anexados a uma campanha criando umCampaignCriterion
combrand_list
definido como o conjunto compartilhado. Os critérios da campanha podem ser segmentados em campanhas de pesquisa e excluídos em e Performance Max, respectivamente.Adicionada
Campaign.asset_automation_settings[]
para mostrar o status da automação de cada tipo de recurso.Adicionados os seguintes valores ao
CampaignPrimaryStatusReason
enumeração:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversões
- Adicionados
CallConversion.consent
eClickConversion.consent
para oferecer suporte dar consentimento. Confira nossa guia de conversões de chamada e no guia de conversões de clique para mais detalhes. - Adicionados os seguintes campos relacionados a
SKAdNetwork
disponíveis ao fazer consultas com
customer
oucampaign
: metrics.sk_ad_network_conversions
substituído pormetrics.sk_ad_network_installs
.- Agora é possível diagnosticar o upload de conversões off-line
- Moveu a
offline_conversion_upload_client_summary
de um campo no recursocustomer
para um relatório de nível superior. Usar para obter detalhes úteis do status de upload da conversão, como o contagem de eventos bem-sucedidos, taxa de sucesso e porcentagem de erros.- Advertência: uma conversão que é enviada, mas resulta em um
ConversionUploadError.CLICK_NOT_FOUND
ainda é contado como bem-sucedido, mas também é sinalizado como umOfflineConversionAlert
- Advertência: uma conversão que é enviada, mas resulta em um
job_id
foi adicionado como um parâmetro opcional para os seguintes tipos de solicitação para que é possível agrupar logicamente várias solicitações de upload em uma única trabalho:INVALID_JOB_ID
foi adicionado aos seguintes erros:INVALID_CONVERSION_ACTION
substituído porNO_CONVERSION_ACTION_FOUND
eINVALID_CONVERSION_ACTION_TYPE
nos seguintes erros:
- Moveu a
- Adicionamos três relatórios para dar suporte a várias redes do Sandbox de privacidade do Android.
atribuição sem
redirecionamentos:
android_privacy_shared_key_google_campaign
, que contémshared_campaign_key
e alguns campos que ajudam a codificar a chave.android_privacy_shared_key_google_ad_group
, que contémshared_ad_group_key
e alguns campos que ajudam a codificar a chave.android_privacy_shared_key_google_network_type
, que contémshared_network_type_key
e alguns campos que ajudam a codificar a chave.
- Adicionada
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
UmConversionActionOperation
que tenta usar um dos recursos de atribuição baseada em regras descontinuados modelos agora falha com este erro. Anteriormente, a operação falhava com umaUNKNOWN
erro.
Hotel e Viagens
- Foi adicionado suporte para os seguintes campos em
travel_activity_group_view
etravel_activity_performance_view
:- Segmentos:
- Métricas:
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
Anúncios dos Serviços Locais
LocalServicesSettings
e os respectivos ao relatóriocustomer
para retornar um erro Local Status granular de licença e seguro do anunciante de serviços.- Adicionamos os novos relatórios a seguir para Relatórios locais
Serviços:
local_services_lead
contém todos os detalhes sobre os Serviços locais Leads do Google Ads, comolead_charged
,lead_type
,lead_status
.- Enumerados:
local_services_lead_conversation
contém detalhes da mensagem e da conversa telefônica, comoconversation_channel
,call_duration_millis
,call_recording_url
.- O URL de gravação de chamada telefônica é autenticado no cliente de destino e suas contas de administrador.
local_services_verification_artifact
retorna artefatos de um anunciante dos Serviços Locais, como investigação de histórico para contratação, licenças comerciais e dados de seguros corporativos. Todos os documentos associados com licença e seguro podem ser acessados por um URL.
Planejamento
- Foi adicionado suporte para retornar
Forecast.views
ePlannedProductForecast.views
paraReachPlanService.ListPlannableProducts
para os tipos de produto aplicáveis. - Agora é possível devolver o dispositivo
PlannableTargeting.surface_targeting
paraReachPlanService.ListPlannableProducts
, que descreve as superfícies disponíveis para um produto. - Um novo item foi adicionado
Enumeração
ReachPlanSurface
. - Adicionado suporte para segmentação Target
frequência usando
AdvancedProductTargeting.target_frequency_settings
, que retornaPlannedProductForecast.average_frequency
- Adicionada
AudienceInsightsService.GenerateSuggestedTargetingInsights
para retornar públicos-alvo segmentáveis sugeridos. - Os seguintes valores foram adicionados ao
ReachPlanError
NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Recomendações
- Adicionada
RecommendationSubscriptionService
que gerencia as inscrições das recomendações: - Os seguintes tipos de recomendações foram adicionados:
FORECASTING_SET_TARGET_CPA
que recomenda definir um CPA desejado para campanhas que não têm esse especificado, antes de um evento sazonal com previsão de aumento do tráfego de entrada.SET_TARGET_CPA
que recomenda definir um CPA desejado para campanhas que não têm esse especificado.SET_TARGET_ROAS
que recomenda definir um ROAS desejado para as campanhas que não têm um especificado.
Relatórios
- Foram adicionadas as novas métricas a seguir, que podem ser consultadas com
campaign
(disponível para campanhas Discovery, de display, de vídeo e campanhas para apps) esegments.device
:
Compras
- Remoção de
ShoppingSetting.sales_country
, cujos valores agora são retornados comoShoppingSetting.feed_label
.- Você pode continuar usando uma conta do Merchant Center
feed para uma campanha usando
as
ShoppingSetting.feed_label
. Ele precisa ser definido como o valor do rótulo do feed ou o país de duas letras código usado anteriormente paraShoppingSetting.sales_country
. Para mais detalhes, consulte o artigo de suporte para feed rótulos.
- Você pode continuar usando uma conta do Merchant Center
feed para uma campanha usando
as
- Removida a dependência de categorias de produto em um código de país nos relatórios.
O conjunto de IDs de categoria com suporte não mudou.
- Os seguintes campos usados em
shopping_performance_view
segments.product_bidding_category_level1
comsegments.product_category_level1
segments.product_bidding_category_level2
comsegments.product_category_level2
segments.product_bidding_category_level3
comsegments.product_category_level3
segments.product_bidding_category_level4
comsegments.product_category_level4
segments.product_bidding_category_level5
comsegments.product_category_level5
product_bidding_category_constant
substituído porproduct_category_constant
, que retorna todas as localizações disponíveis de uma categoria em um campo repetido.ListingDimensionInfo.product_bidding_category
substituído porListingDimensionInfo.product_category
.ListingGroupFilterDimension.product_bidding_category
substituído porListingGroupFilterDimension.product_category
.
- Os seguintes campos usados em
- Remoção do suporte para adição
Campaign.shopping_setting
para pesquisar campanhas. Tentar criar uma campanha de pesquisa comCampaign.shopping_setting
ou adicionarCampaign.shopping_setting
para um campanha da Rede de Pesquisa atual resulta emOPERATION_NOT_PERMITTED_FOR_CONTEXT
- Remoção do suporte para adição
CampaignCriterion.listing_scope
às campanhas de pesquisa. Tentando adicionarCampaignCriterion.listing_scope
a uma campanha da Rede de Pesquisa existente agora resulta emOPERATION_NOT_PERMITTED_FOR_CONTEXT
- As seguintes conversões com o carrinho foram adicionadas
data:
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- Todas essas métricas podem ser selecionadas com os seguintes relatórios:
Metas unificadas
- Adicionada
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
para configurar as metas de aquisição no nível do cliente.- Relatório:
customer_lifecycle_goal
- Relatório:
- Adicionada
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
para configurar as metas de aquisição de clientes no nível da campanha.- Relatório:
campaign_lifecycle_goal
- Relatório:
- Adicionada
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
- Os seguintes valores foram adicionados ao
ConversionGoalCampaignConfigError
EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
Vídeos
- Suporte adicional para a segmentação do Google TV no nível da campanha:
- Adicionada
NetworkSettings.target_google_tv_network
- Adicionada
AdNetworkType.GOOGLE_TV
- Adicionada
- Agora é possível segmentar o YouTube no nível da campanha:
- Adicionada
NetworkSettings.target_youtube
- Em
AdNetworkType
, mescladoYOUTUBE_WATCH
eYOUTUBE_SEARCH
emYOUTUBE
. - Adicionada
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
- Adicionada
Notas de lançamento arquivadas
Acesse Versões desativadas para conferir as notas arquivadas.