v16.1.0 (24-04-2024)
Os seguintes recursos e mudanças foram adicionados na v16.1.
Gerenciamento da conta
CustomerNegativeCriterion.ip_block
, que aceita a 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 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 tem suporte aos recursos da SKAdNetwork 4.0.- Foi adicionado suporte a avisos de
CustomerSkAdNetworkConversionValueSchemaService
comoMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Quando definido comotrue
, todos os erros sem bloqueio relacionados a falhas de operação sã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 de crédito e o carimbo de data/hora de quando 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 oferecem suporte à recuperação da adequação de brand safety de vídeos no nível do cliente.- Novo valor de enumeração:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
v16 (21-02-2024)
Os seguintes recursos e mudanças foram adicionados na v16.
Gerenciamento da conta
advertising_partner
foi migrado deAccountLink
paraProductLink
eProductLinkInvitation
.data_partner
egoogle_ads
foram removidos deAccountLink
.IdentityVerificationService
foi adicionado 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.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 de programa de verificação de identidadeidentity_verification_requirement
, que contém detalhes relacionados ao prazo para o anunciante concluir a verificação.verification_progress
, que contém detalhes relacionados à sessão de verificação, incluindo:program_status
representa o status atual desta 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
.
- Tipos:
- 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
. - Agora,
campaign
é um recurso atribuído em vez de segmentar recursos.
- 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
para uma campanha Geração de demanda atual. 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íveis para campanhas Geração de demanda com umCampaign.shopping_setting
não nulo.
- Foi adicionado suporte à configuração de
- Adicionado aos seguintes campos a
AdGroup
para mostrar se o grupo de anúncios está sendo veiculado ou os motivos para não estar:primary_status
primary_status_reasons
- Adicionado aos seguintes campos a
AdGroupAd
para mostrar se o anúncio do grupo de anúncios está sendo veiculado ou os motivos para não estar:primary_status
primary_status_reasons
- Os seguintes valores foram adicionados a
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Experimental
Experiment.sync_enabled
foi adicionado para especificar se a sincronização será ativada no experimento. Com a sincronização ativada, as alterações feitas na campanha original enquanto a experiência estiver em andamento 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
de um anúncio da seção "Coisas legais para fazer" para permitir a criação de grupos de fichas com base no estado e na cidade em que a atividade de viagem está disponível: - Foi adicionado suporte aos seguintes segmentos no
travel_activity_performance_view
:
Serviços locais
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
eBusinessRegistrationCheckArtifact
foram adicionados para permitir que os anunciantes monitorem o progresso 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 que adicionaram.
planejamento
score
foi removido deAudienceInsightsAttributeMetadata
.
Recomendações
- Adição de
RecommendationService.GenerateRecommendations()
, que retorna recomendações com base nas configurações especificadas, como tipos de recomendação e de canal de publicidade. Isso é bastante útil durante a criação da campanha. RecommendationMetrics.conversions_value
foi adicionado.- As palavras-chave recomendadas com tipo de correspondência não 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 ativar a estratégia de lances "Maximizar o valor da conversão".IMPROVE_GOOGLE_TAG_COVERAGE
, que recomenda implantar a 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 Max.REFRESH_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 criar 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
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
eCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
foram adicionados para fornecer erros mais detalhados em 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 de operação na API.
v15 (18-10-2023)
Os novos recursos e atualizações a seguir foram introduzidos na v15.
Gerenciamento da conta
- Se sua conta foi suspensa devido a atividades não autorizadas
da conta,
customer.status
ecustomer_client.status
agora são retornados comoSUSPENDED
. Anteriormente, elas eram retornadas comoENABLED
. - Possibilidade de adicionar e remover uma vinculação entre uma conta do Google Ads e uma conta do Merchant Center:
ProductLink.merchant_center
eMerchantCenterIdentifier
foram adicionados.LinkedProductType.MERCHANT_CENTER
foi adicionado.
ProductLinkInvitationService
eProductLinkInvitation
foram adicionados para oferecer suporte à atualização de convites de vinculação enviados de outros produtos, disponíveis para contas do Hotel Center e do Merchant Center.MerchantCenterLinkService
foi removido.- Para vincular contas do Google Ads a contas do Merchant Center, use
ProductLinkInvitationService
eProductLinkService
.
- Para vincular contas do Google Ads a contas do Merchant Center, use
- Removemos
AccountLink.hotel_center
e suporte para atualizar 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,
CustomerMatchUserListMetadata.consent
foi adicionado para oferecer suporte ao consentimento. A partir de 6 de março de 2024, se o consentimento estiver ausente para os usuários do EEE, o valor 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 personalização de anúncios pela Segmentação por lista de clientes. Confira nosso guia da Segmentação por lista de clientes para mais detalhes. - Para vendas na loja,
UserData.consent
foi adicionado para dar consentimento. Confira nosso Guia de vendas na loja para mais detalhes. Se você estiver usando 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 modelo fornecido. Eles só podem ser usados em uma campanha Geração de demanda.
Campanhas
Atualizações das campanhas Performance Max:
- Agora,
AssetGroupSignal
é compatível com dois tipos de indicadores que podem ser anexados a um grupo de recursos para segmentação aprimorada:AssetGroupSignal.audience
Audience.scope
eAudience.asset_group
foram adicionados para limitar o uso do público-alvo a um grupo de recursos específico.Audience.asset_group
precisará ser definido se e somente 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 umSearchThemeInfo
.
- 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. - Adicionamos um novo
asset_group_top_combination_view
para informar os recursos com melhor performance no nível do grupo. 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
,UPGRADE_ELIGIBLE
foi renomeado comoUPGRADE_ELIGIBLE
.
- Agora,
Para campanhas Geração de demanda e Discovery de CPA desejado, 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
.Adição de
BrandSuggestionService
, que pode sugerir marcas com base no prefixo 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, anexado a uma campanha criando umCampaignCriterion
combrand_list
definido como o conjunto compartilhado. Os critérios da campanha podem ser segmentados nas campanhas de pesquisa e excluídos nas campanhas Performance Max, respectivamente.Campaign.asset_automation_settings[]
foi adicionado para mostrar o status de automação de cada tipo de recurso.Os seguintes valores foram adicionados ao tipo enumerado
CampaignPrimaryStatusReason
:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversões
CallConversion.consent
eClickConversion.consent
foram adicionados para oferecer suporte ao consentimento. Confira nossos guias sobre conversões de chamada e de clique para mais detalhes.- Foram adicionados os seguintes campos relacionados às conversões da
SKAdNetwork, disponíveis ao consultá-los com
customer
oucampaign
: metrics.sk_ad_network_conversions
foi substituído pormetrics.sk_ad_network_installs
.- Agora é possível diagnosticar o upload de conversões off-line.
- O
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 conferir detalhes úteis do status do 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 enviada, mas que resulta em um erro
ConversionUploadError.CLICK_NOT_FOUND
, ainda é contada como bem-sucedida, mas também é sinalizada comoOfflineConversionAlert
.
- Advertência: uma conversão enviada, mas que resulta em um erro
job_id
foi adicionado como um parâmetro opcional para os seguintes tipos de solicitação, para que você possa agrupar logicamente várias solicitações de upload em um único job conceitual:- Foram adicionados
INVALID_JOB_ID
aos seguintes erros: INVALID_CONVERSION_ACTION
foi substituído porNO_CONVERSION_ACTION_FOUND
eINVALID_CONVERSION_ACTION_TYPE
nos seguintes erros:
- O
- Foram adicionados 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. UmConversionActionOperation
que tenta usar um dos modelos de atribuição baseados em regras descontinuados agora falha com esse erro. Anteriormente, a operação falhava 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
LocalServicesSettings
e os campos correspondentes foram adicionados ao relatóriocustomer
para retornar os status granulares de licença e seguro de um anunciante dos Serviços Locais.- Estes 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
.- Tipos:
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 chamada telefônica é autenticado na conta de 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 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. - Foi adicionado suporte ao retorno de
PlannableTargeting.surface_targeting
paraReachPlanService.ListPlannableProducts
, que descreve as plataformas disponíveis para um produto. - Foi adicionado um novo
tipo enumerado
ReachPlanSurface
. - Foi adicionado suporte à segmentação de Frequência
de destino usando
AdvancedProductTargeting.target_frequency_settings
, que retornaPlannedProductForecast.average_frequency
. AudienceInsightsService.GenerateSuggestedTargetingInsights
foi adicionado para retornar os 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
- Foi adicionado o
RecommendationSubscriptionService
, que gerencia assinaturas de recomendação: - 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 campanhas que não têm um especificado.
Relatórios
- Adicionamos estas novas métricas, que podem ser consultadas com
campaign
(disponível em campanhas Discovery, de display, de vídeo e para apps) esegments.device
:
Compras
- Remoção de
ShoppingSetting.sales_country
, cujos valores agora são retornados comoShoppingSetting.feed_label
.- É possível continuar utilizando 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 sobre rótulos do feed.
- É possível continuar utilizando um feed do Merchant Center específico para uma campanha com o campo
- Removemos a dependência de categorias de produto em um código de país nos relatórios.
O conjunto de IDs de categoria compatíveis não foi alterado.
- 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. Tentar 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 metas de aquisição de clientes no nível do cliente.- Relatório:
customer_lifecycle_goal
- Relatório:
- O método
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.
v14.1.0 (09-08-2023)
Os novos recursos e atualizações a seguir foram introduzidos na v14.1.
Gerenciamento da conta
Customer.customer_agreement_setting
, que mostra se o cliente aceitou os Termos de Serviço do formulário de lead.
Recursos
- Novos campos em
AssetGroup
para mostrar se o grupo de recursos está sendo veiculado ou os motivos para isso:primary_status
primary_status_reasons
- Novos campos em
AssetGroupAsset
para mostrar se o recurso do grupo de recursos está ou não sendo veiculado:primary_status
primary_status_details
primary_status_reasons
- Novos valores no tipo enumerado
CallToActionType
:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
- Novos valores no
tipo enumerado
AssetLinkError
:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
Faturamento
- Novos campos em
Invoice
eAccountSummary
:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
Campanhas
Novos valores no tipo enumerado
CampaignPrimaryStatusReason
:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
(Apenas contas permitidas)
DiscoveryCampaignSettings
comupgraded_targeting
:- Quando
upgraded_targeting
for definido comotrue
, será possível adicionar um local e um idioma como critério do grupo de anúncios.
- Quando
Critérios
Novo valor de enumeração:
CriterionError.INVALID_DETAILED_DEMOGRAPHIC
(Somente contas permitidas) Suporte para adicionar
LanguageInfo
eLocationInfo
como umAdGroupCriterion
:- Esse recurso está disponível apenas para uma campanha Discovery com segmentação atualizada ativada
Experimentos
- Novos valores no
tipo enumerado
ExperimentError
:DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
Recomendações
- Novos tipos de recomendações:
PerformanceMaxOptInRecommendation
, que recomenda criar a primeira campanha Performance Max na contaImprovePerformanceMaxAdStrengthRecommendation
, que recomenda melhorar a força do grupo de recursos de uma campanha Performance MaxMigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
, que recomenda migrar uma campanha de anúncios dinâmicos de pesquisa para Performance Max
Relatórios
- Novas métricas e segmentos sobre clientes novos e recorrentes:
- Novas visualizações
customer_search_term_insight
ecampaign_search_term_insight
:metrics.search_volume
mostra o intervalo de volume de uma categoria de insight do termo de pesquisa
Compras
- Novos campos para grupos de fichas:
- Novo campo:
ShoppingSetting.advertising_partner_ids
- Novos valores no tipo enumerado
CampaignError
:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
Vídeos
- (Apenas contas permitidas)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
e aDiscoveryVideoResponsiveAdInfo
correspondente
v14 (07-06-2023)
Os novos recursos e atualizações a seguir foram introduzidos na v14.
Campanhas
Conversões
Adição de suporte para identificar conversões do Google Analytics e determinar se uma conversão é importada de uma propriedade do Universal Analytics ou do GA4:
- Os seguintes valores foram adicionados a
ConversionActionType
:UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
ConversionAction.google_analytics_4_settings
adicionado
- Os seguintes valores foram adicionados a
Adição de
Customer.offline_conversion_client_summaries
, que resume o status e as informações de diagnóstico dos uploads e ajustes de conversão off-line do cliente.- Tipos enumerados
OfflineEventUploadClient
:GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus
:EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
- Tipos enumerados
Adição de
job_id
às respostas retornadas porConversionAdjustmentUploadService.UploadConversionAdjustments
eConversionUploadService.UploadClickConversions
para associar uma resposta a umaOfflineConversionUploadSummary.job_id
.
Critérios
Compatibilidade adicionada para recuperar, criar e atualizar palavras-chave negativas no nível da conta:
- Campos:
- Tipos:
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- Erros:
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
Anúncios de hotéis
SuggestTravelAssetsRequest.place_id
foi renomeado comoSuggestTravelAssetsRequest.place_ids
.
planejamento
- Os seguintes métodos foram removidos de
KeywordPlanService
:GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
foi adicionado para oferecer suporte à geração de métricas de previsão de campanhas de palavras-chave sem a necessidade de criar um plano de palavras-chave primeiro.- Remoção do suporte para recuperação do relatório
campaign_criterion_simulation
- Foi adicionado suporte a
YOUTUBE_DYNAMIC_LINEUP
como uma dimensão emAudienceInsightsService.ListAudienceInsightsAttributes
. DynamicLineupAttributeMetadata.sample_channels
foi adicionado, usado nas respostas deGenerateAudienceCompositionInsights
para fornecer canais de amostra nos lineups.
Recomendações
- Adição de
DynamicImageExtensionOptInRecommendation
, que recomenda ativar as extensões de imagem dinâmicas na conta LowerTargetRoasRecommendation
foi adicionado, que recomenda diminuir o ROAS desejado.- Adição de
RaiseTargetCpaRecommendation
, que recomenda aumentar o CPA desejado ResponsiveSearchAdAssetRecommendation.current_ad
adicionado
Relatórios
- Os seguintes valores foram adicionados ao
ServedAssetFieldType
, que estão disponíveis emad_group_ad_asset_view.pinned_field
:SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
Notas de lançamento arquivadas
Consulte Versões desativadas para ver notas da versão arquivadas.