v17 (05/06/2024)
Os recursos e alterações a seguir foram adicionados na v17.
Anúncios
AdService.getAd
foi removido. Assim, oAdService
fica alinhado a outros serviços da API Google Ads. Consulte Como recuperar objetos para conferir a maneira recomendada de buscar anúncios e outros tipos de recursos.- Adicionamos mais validações para
ImageAdInfo.image_asset
relacionadas a dimensões e formato. Os erros a seguir podem ser gerados se a imagem for inválida:
Recursos
- Um novo tipo enumerado foi adicionado:
ClickType.AD_IMAGE
- Adicionamos estes novos relatórios com novas métricas para campanhas Performance Max e de pesquisa:
Públicos-alvos
Jobs em lote
- Adição de
BatchJobError.REQUEST_TOO_LARGE
, que será gerado quando oAddBatchJobOperationsRequest
enviado for maior que 10484504 bytes. - Foi adicionado suporte à configuração
MutateOperation.asset_group_operation
ao usarBatchJobService
. Assim, é possível usar o processamento em lote para criar e gerenciar campanhas Performance Max inteiras. Confira nosso novo guia dedicado.
Campanhas
- O Discovery foi renomeado como Geração de demanda em todos os campos, tipos enumerados e erros em todos os recursos na API Google Ads, como campanhas, anúncios e recursos. Por
exemplo,
AdvertisingChannelType.DISCOVERY
agora éAdvertisingChannelType.DEMAND_GEN
. - Adicionamos
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 conversões da SKAdNetwork,
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 são zero. Isso as torna consistentes com outras métricas.
Critérios
- Adicionado aos campos a seguir a
AdGroupCriterion
para mostrar se o critério do grupo de anúncios está sendo veiculado ou os motivos para isso:primary_status
primary_status_reasons
- Foi adicionado suporte a
metrics.search_impression_share
paragender_view
. - Foi adicionado suporte a
metrics.phone_calls
parakeyword_view
.
Serviços locais
- Adicionamos
LocalServicesLeadService.AppendLeadConversation()
, usado para anexar um novoLocalServicesLeadConversation
aLocalServicesLead
, que envia as mensagens aos usuários por canais adequados, como SMS, dependendo de como o lead foi criado.- O tamanho de
AppendLeadConversationRequest.conversations
é limitado a 1.000. - Somente
LocalServicesLead
comlead_type
definido comoLeadType.MESSAGE
pode ser especificado emConversation.local_services_lead
.
- O tamanho de
- Novos valores de tipo enumerado foram adicionados a
ConversationType
:WHATSAPP
para representar uma conversa iniciada pelo WhatsApp.ADS_API
para representar uma conversa introduzida usando o novo métodoLocalServicesLeadService.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ório
- Agora é possível selecionar apenas campos relacionados a um produto vinculado
ao consultar
product_link
. A seleção de vários campos de vários produtos vinculados geraQueryError.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. - Transmitir um
page_size
paraGoogleAdsService.Search
vai resultar em um erroRequestError.PAGE_SIZE_NOT_SUPPORTED
.
Compras
- Adicionamos um novo relatório
shopping_product
, que corresponde à página Produtos da interface do Google Ads. Ela é compatível com o retorno de dados relacionados ao estado atual dos produtos de contas do Google Merchant Center vinculadas a uma conta do Google Ads.- É possível filtrar as métricas do relatório
shopping_product
usandosegments.date
ao utilizarGoogleAdsService.Search
ouGoogleAdsService.SearchStream
. A segmentação por data não é permitida e vai retornar um erroShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- É possível filtrar as métricas do relatório
Metas unificadas
- Adicionamos
UserListCustomerTypeService.MutateUserListCustomerTypes()
para configurar tipos de clientes de público-alvo. 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()
.- Anexe ou remova uma lista de usuários definindo
UserListCustomerType.customer_type_category
comoUserListCustomerTypeCategory.PURCHASERS
para incluí-la ou excluí-la de uma definição de cliente atual para metas de ciclo de vida do cliente, respectivamente. Acesse segmentar seus públicos-alvo para mais detalhes.
- Anexe ou remova uma lista de usuários definindo
Vídeos
- Os valores abaixo foram adicionados a
ContentLabelType
. Você pode excluir essesContentLabelTypes
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
foi adicionado para oferecer suporte às preferências de inventário para recursos de vídeo ao criarDemandGenVideoResponsiveAdInfo
.- (Apenas contas na lista de permissões) Agora o
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 oferece suporte à adição de um IP como um critério negativo no nível do cliente.- Novo valor de enumeração:
ProductLinkError.LINK_EXISTS
. - Novo valor de enumeração:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Recursos
- Suporte a recursos relacionados à Geração de demanda para
ad_group_ad_asset_view
easset_field_type_view
. - Novo valor de enumeração:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Públicos-alvos
- Novo valor de enumeração:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
, que limita a 1.000 o número de listas de usuários semelhantes que um cliente pode ter.
Campanhas
- Suporte para retornar simulações de lances de campanhas de ROAS desejado em campanhas para apps usando o relatório
campaign_simulation
. - Novo valor de enumeração:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - Novo valor de enumeração:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - Novo valor de enumeração:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
Conversões
SkAdNetworkConversionValueSchema.postback_mappings
, que é compatível com recursos da SKAdNetwork 4.0.- Foi adicionado suporte a avisos para
CustomerSkAdNetworkConversionValueSchemaService
comoMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Quando definido comotrue
, todos os erros sem bloqueio relativos a falhas de operação serão retornados comoMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - Novos valores de tipo enumerado em
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Critérios
- Novos campos em
BrandInfo
:display_name
primary_url
rejection_reason
status
- Novo tipo enumerado:
BrandRequestRejectionReason
. - Novo valor de enumeração:
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 retornam o estado do crédito e o carimbo de data/hora em que o estado de crédito foi atualizado, 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 são compatíveis com a recuperação de adequação de brand safety de vídeo no nível do cliente.- 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
- Migração de
advertising_partner
deAccountLink
paraProductLink
eProductLinkInvitation
. data_partner
egoogle_ads
foram removidos deAccountLink
.- Adicionamos
IdentityVerificationService
para gerenciar a verificação do anunciante.StartIdentityVerification()
é usado para iniciar uma sessão de verificação usando overification_program
fornecido. Ele cria uma nova sessão de verificação e retorna uma resposta vazia para uma verificação criada com sucesso.IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
foi adicionado.
GetIdentityVerification()
pode ser usado para recuperar informações de verificação, que retorna vários objetos deIdentityVerification
. CadaIdentityVerification
inclui:verification_program
, que é o tipo do programa de verificação de identidadeidentity_verification_requirement
, que contém detalhes relacionados ao prazo em que o anunciante precisa concluir a verificação.verification_progress
, que contém detalhes relacionados à sessão de verificação, incluindo:program_status
representa o status atual da sessão de verificação.action_url
direciona o cliente a um URL para concluir a verificação.invitation_link_expiration_time
representa a data de validade doaction_url
.
- Enumerações:
- Erros:
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
foi adicionado.
Recursos
- Mudanças no
asset_group
:- Foi adicionado suporte a segmentos relacionados ao tempo, como
segments.year
esegments.month
. - A classe
campaign
passou a ser um recurso atribuído em vez de segmentar o recurso.
- Foi adicionado suporte a segmentos relacionados ao tempo, como
Campanhas
- Mudanças nas campanhas Geração de demanda:
- Foi adicionado suporte à configuração de
Campaign.shopping_setting
em uma campanha Geração de demanda. ShoppingSetting.disable_product_feed
foi adicionado para desativar o feed de produtos opcional das campanhas Geração de demanda.Ad.demand_gen_product_ad
e oDemandGenProductAdInfo
correspondente, disponível para campanhas Geração de demanda com umCampaign.shopping_setting
não nulo, foram adicionados.
- Foi adicionado suporte à configuração de
- Adicionado aos campos a seguir a
AdGroup
para mostrar se o grupo de anúncios está sendo veiculado ou os motivos para isso: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 os motivos para isso:primary_status
primary_status_reasons
- Os seguintes valores foram adicionados a
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Testar
Experiment.sync_enabled
foi adicionado para especificar se a sincronização precisa ser ativada no experimento. Com a sincronização ativada, as alterações feitas na campanha original enquanto o experimento está em execução são automaticamente copiadas para a campanha experimental.ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
foi adicionado.CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
foi adicionado.
Hotel e viagens
- Adicionamos os seguintes campos a
ListingDimensionInfo
em um anúncio da seção "Coisas legais para fazer" para permitir a criação de grupos de produtos anunciados com base no estado e na cidade em que a atividade de viagem está disponível: - Foi adicionado suporte aos seguintes segmentos a
travel_activity_performance_view
:
Serviços locais
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
eBusinessRegistrationCheckArtifact
foram adicionados para permitir que os anunciantes monitorem o andamento do processo de verificação do registro da empresa.- Foi adicionado um novo recurso
local_services_employee
para permitir que os anunciantes recuperem as informações de funcionários adicionadas.
planejamento
score
foi removido deAudienceInsightsAttributeMetadata
.
Recomendações
RecommendationService.GenerateRecommendations()
foi adicionado, que retorna recomendações com base nas configurações especificadas, como tipos de recomendações e tipos de canais de publicidade. Isso é especialmente útil durante a criação da campanha.RecommendationMetrics.conversions_value
foi adicionado.- As palavras-chave recomendadas sem tipo definido agora têm
recommended_match_type
definido comoUNSPECIFIED
em vez deUNKNOWN
. - Os seguintes tipos de recomendações foram adicionados:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
que recomenda a ativação da estratégia de lances "Maximizar o valor da conversão".IMPROVE_GOOGLE_TAG_COVERAGE
que recomenda a implantação da tag do Google em mais páginas.PERFORMANCE_MAX_FINAL_URL_OPT_IN
que recomenda ativar a expansão de URL final nas suas campanhas Performance MaxREFRESH_CUSTOMER_MATCH_LIST
que recomenda atualizar uma lista de clientes que não foi atualizada nos últimos 90 dias.CUSTOM_AUDIENCE_OPT_IN
que recomenda a criação de um público-alvo personalizadoLEAD_FORM_ASSET
, que recomenda adicionar recursos de formulário de lead no nível da campanha ou do cliente.IMPROVE_DEMAND_GEN_AD_STRENGTH
que recomenda melhorar a qualidade do anúncio em campanhas Geração de demanda.
Compras
- Adicionamos
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
eCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
para fornecer erros mais detalhados a campanhas do Shopping vinculadas a uma conta do Comparison Shopping Service Center. - Os seguintes valores foram adicionados a
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 tornar esses tipos de operação consistentes com outros tipos 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 atividade não autorizada,
customer.status
ecustomer_client.status
agora serã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:
- Foram adicionados
ProductLink.merchant_center
eMerchantCenterIdentifier
. LinkedProductType.MERCHANT_CENTER
foi adicionado.
- Foram adicionados
- Adicionamos
ProductLinkInvitationService
eProductLinkInvitation
para oferecer suporte à atualização de um convite de link enviado de outros produtos, disponível para contas do Hotel Center e do Merchant Center. MerchantCenterLinkService
foi removido.- Para vincular contas do Google Ads e do Merchant Center, use
ProductLinkInvitationService
eProductLinkService
.
- Para vincular contas do Google Ads e do Merchant Center, use
- Remoção de
AccountLink.hotel_center
e suporte à atualização de convites de vinculação 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
foi substituído porImageAdInfo.image_asset
para oferecer suporte à adição e remoção de imagens usando os recursos. Como resultado, também removemosMediaFileService
, que não é mais necessário.ListingGroupFilterDimension.webpage
foi adicionado para oferecer suporte à criação de um filtro de grupo de fichas com base em rótulos personalizados e substrings de URL.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.ad_group_ad_asset_view.source
foi adicionado para mostrar a origem do recurso de anúncio do grupo de anúncios.
Públicos-alvos
- Para a Segmentação por lista de clientes, adicionada
CustomerMatchUserListMetadata.consent
para aceitar o consentimento. A partir de 6 de março de 2024, se não houver consentimento para os usuários do EEE, o valor de consentimento será considerado "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 personalização de anúncios pela Segmentação por lista de clientes. Confira nosso guia de Segmentação por lista de clientes para mais detalhes. - Para vendas na loja, foi adicionado
UserData.consent
para aceitar o consentimento. Confira nosso Guia de vendas na loja para mais detalhes. Se você usa a Segmentação por lista de clientes com vendas na loja, consulte as Perguntas frequentes para mais informações. UserList.lookalike_user_list
foi adicionado para oferecer suporte à criação de um segmento semelhante, um público-alvo criado com base no público-alvo de origem fornecido. Eles só podem ser usados em uma campanha Geração de demanda.
Campanhas
Atualizações nas campanhas Performance Max:
- O
AssetGroupSignal
agora oferece suporte a dois tipos de indicadores que podem ser anexados a um grupo de recursos para melhorar a segmentação:AssetGroupSignal.audience
Audience.scope
eAudience.asset_group
foram adicionados para limitar o uso de público-alvo a um grupo de recursos específico.Audience.asset_group
precisará ser definido apenas seAudience.scope
forASSET_GROUP
.
AssetGroupSignal.search_theme
CriterionType.SEARCH_THEME
foi adicionado para oferecer suporte a esse novo tipo de critério. Esse novo tipo de critério só pode ser usado em campanhas Performance Max para criar umAssetGroupSignal
preenchendo oAssetGroupSignal.search_theme
com um critérioSearchThemeInfo
.
- O método
AssetGroupSignalOperation.exempt_policy_violation_keys
foi adicionado para oferecer suporte à solicitação de isenção ao adicionar indicadores de grupos de recursos. - Um novo
asset_group_top_combination_view
foi adicionado para informar os recursos com melhor performance no nível do grupo de recursos. asset_group
agora pode ser consultado com campos de métricas para ajudar na recuperação da performance de uma campanha Performance Max.- Em
PerformanceMaxUpgradeStatus
, renomeadoUPGRADE_ELIGIBLE
comoUPGRADE_ELIGIBLE
.
- O
Para campanhas de geração de demanda e Discovery, as simulações de lance de CPA desejado no nível da campanha (
campaign_simulation.target_cpa_point_list.points
) agora retornamTargetCpaSimulationPoint.interactions
em vez deTargetCpaSimulationPoint.clicks
.Adicionamos
BrandSuggestionService
, que pode sugerir marcas com base no prefixo de marca fornecido e na lista de marcas excluídas. Essas marcas podem ser usadas para criar um critérioBRAND
, adicionado a um conjunto compartilhadoBRANDS
e, em seguida, anexadas a uma campanha criando umCampaignCriterion
combrand_list
definido para o conjunto compartilhado. Os critérios da campanha podem ser segmentados nas campanhas de pesquisa e excluídos nas campanhas Performance Max, respectivamente.- Campos:
- Enumerações:
Campaign.asset_automation_settings[]
foi adicionado para mostrar o status da automação de cada tipo de recurso.Os seguintes valores foram adicionados ao enum
CampaignPrimaryStatusReason
:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversões
CallConversion.consent
eClickConversion.consent
foram adicionados para oferecer suporte ao consentimento. Confira os guias de conversões de chamada e de cliques para mais detalhes.- Foram adicionados os seguintes campos relacionados às conversões da
SKAdNetwork, disponíveis na consulta com
customer
oucampaign
: metrics.sk_ad_network_conversions
foi substituído pormetrics.sk_ad_network_installs
.- Foi adicionado suporte para diagnóstico de upload de conversões off-line.
offline_conversion_upload_client_summary
foi movido de um campo no recursocustomer
para um relatório de nível superior. Use esse relatório para ver detalhes úteis do status de upload de conversões, como a contagem de eventos bem-sucedidos, a taxa de sucesso e a porcentagem de erros.- Advertência: uma conversão que é enviada, mas resulta em um erro
ConversionUploadError.CLICK_NOT_FOUND
, ainda é contada como bem-sucedida, mas também é sinalizada como umOfflineConversionAlert
.
- Advertência: uma conversão que é enviada, mas resulta em um erro
job_id
foi adicionado como um parâmetro opcional para os tipos de solicitação a seguir. Assim, é possível agrupar logicamente várias solicitações de upload em um único job conceitual:INVALID_JOB_ID
foi adicionado aos seguintes erros:INVALID_CONVERSION_ACTION
foi substituído porNO_CONVERSION_ACTION_FOUND
eINVALID_CONVERSION_ACTION_TYPE
nos seguintes erros:
- Adicionamos três relatórios para oferecer suporte à atribuição de várias redes
do Sandbox de privacidade do Android 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.
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
foi adicionado. UmaConversionActionOperation
que tenta usar um dos modelos de atribuição baseados em regras descontinuados agora falha com esse erro. Anteriormente, a operação falharia com um erroUNKNOWN
.
Hotel e viagens
- Foi adicionado suporte aos 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
- Adicionamos
LocalServicesSettings
e os campos relacionados ao relatóriocustomer
para retornar os status granulares de licença e seguro de um anunciante dos Serviços Locais. - Os seguintes novos relatórios foram adicionados para Serviços
locais:
local_services_lead
contém todos os detalhes relacionados aos leads dos anúncios dos Serviços Locais, comolead_charged
,lead_type
elead_status
.- Enumerações:
local_services_lead_conversation
contém detalhes de mensagem e conversa telefônica, comoconversation_channel
,call_duration_millis
ecall_recording_url
.- O URL de gravação de chamadas telefônicas é autenticado na conta do cliente de destino e nas respectivas contas de administrador.
local_services_verification_artifact
retorna os artefatos de um anunciante dos Serviços Locais, como investigação de histórico para contratação, licenças comerciais e dados de seguro empresarial. Todos os documentos associados à licença e ao seguro podem ser acessados por um URL.
planejamento
- Foi adicionado suporte ao retorno de
Forecast.views
ePlannedProductForecast.views
paraReachPlanService.ListPlannableProducts
nos tipos de produto aplicáveis. - Foi adicionado suporte ao retorno de
PlannableTargeting.surface_targeting
paraReachPlanService.ListPlannableProducts
, que descreve as plataformas disponíveis para um produto. - Um novo tipo enumerado
ReachPlanSurface
foi adicionado - Foi adicionado suporte à segmentação da frequência
desejada usando
AdvancedProductTargeting.target_frequency_settings
, que retornaPlannedProductForecast.average_frequency
. - O método
AudienceInsightsService.GenerateSuggestedTargetingInsights
foi adicionado para retornar públicos-alvo segmentáveis sugeridos. - Os seguintes valores foram adicionados a
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Recomendações
- Adicionamos
RecommendationSubscriptionService
, que gerencia assinaturas de 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 um especificado, antes de um evento sazonal com previsão de aumento do tráfego.SET_TARGET_CPA
que recomenda definir um CPA desejado para campanhas que não têm um especificado.SET_TARGET_ROAS
que recomenda definir um ROAS desejado para as campanhas que não têm um especificado.
Relatório
- Adicionamos as novas métricas a seguir, que podem ser consultadas com
campaign
(disponível para campanhas de display, vídeo, Discovery e para apps) esegments.device
:
Compras
- Remoção de
ShoppingSetting.sales_country
, cujos valores agora são retornados comoShoppingSetting.feed_label
.- É possível continuar usando um feed do Merchant Center específico para uma campanha com o campo
ShoppingSetting.feed_label
. Ele precisa ser definido como o valor do rótulo do feed ou o código do país de duas letras usado anteriormente paraShoppingSetting.sales_country
. Para mais detalhes, consulte o artigo de suporte para rótulos de feed.
- É possível continuar usando um feed do Merchant Center específico para uma campanha com o campo
- 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
foram substituídos: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
foi substituído porproduct_category_constant
, que retorna todas as localizações disponíveis de uma categoria em um campo repetido.ListingDimensionInfo.product_bidding_category
foi substituído porListingDimensionInfo.product_category
.ListingGroupFilterDimension.product_bidding_category
foi substituído porListingGroupFilterDimension.product_category
.
- Os seguintes campos usados em
- Removemos o suporte para adicionar
Campaign.shopping_setting
às campanhas de pesquisa. Tentar criar uma campanha de pesquisa comCampaign.shopping_setting
ou adicionarCampaign.shopping_setting
a uma campanha de pesquisa atual agora resulta emOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Removemos o suporte para adicionar
CampaignCriterion.listing_scope
às campanhas de pesquisa. A tentativa de adicionarCampaignCriterion.listing_scope
a uma campanha de pesquisa atual agora resulta emOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Adicionamos as seguintes métricas de conversões com dados
do carrinho:
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
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
foi adicionado para configurar as metas de aquisição de clientes no nível do cliente.- Relatório:
customer_lifecycle_goal
- Relatório:
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
foi adicionado para configurar as metas de aquisição de clientes no nível da campanha.- Relatório:
campaign_lifecycle_goal
- Relatório:
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
foi adicionado.- Os seguintes valores foram adicionados a
ConversionGoalCampaignConfigError
:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
Vídeos
- Agora é possível segmentar o Google TV no nível da campanha:
NetworkSettings.target_google_tv_network
foi adicionadoAdNetworkType.GOOGLE_TV
foi adicionado.
- Agora é possível segmentar o YouTube no nível da campanha:
NetworkSettings.target_youtube
foi adicionado- Em
AdNetworkType
,YOUTUBE_WATCH
eYOUTUBE_SEARCH
foram mesclados emYOUTUBE
. CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
foi adicionado.
Notas de lançamento arquivadas
Acesse Versões desativadas para conferir as notas arquivadas.