Mapear parâmetros ValueTrack para campos de relatório

Os parâmetros ValueTrack são parâmetros de URL que você pode adicionar aos URLs de página de destino dos seus anúncios. Eles coletam informações sobre a origem dos cliques nos seus anúncios. Eles são mais úteis quando você quer saber mais sobre os cliques no seu anúncio ou se está começando a usar o acompanhamento.

Quando você ativa a codificação automática, um identificador de clique do Google (GCLID) é adicionado automaticamente a cada URL e pode ser usado mais tarde para mapear um clique no anúncio para uma linha no relatório.

Para uma visão geral de como os parâmetros ValueTrack funcionam, consulte Sobre os parâmetros ValueTrack. Para uma lista completa de ValueTrack parâmetros, consulte a seção Parâmetros ValueTrack disponíveis em Configurar o acompanhamento com parâmetros ValueTrack.

O Google Analytics e a API associada oferecem outra opção para coletar métricas sobre cliques.

Os relatórios da API Google Ads têm recursos e visualizações em que você pode consultar campos que correspondem aos parâmetros ValueTrack. No entanto, o campo mapeado não tem necessariamente um valor de texto idêntico. Por exemplo, quando {matchtype} é igual a e (que é a abreviação de correspondência exata), um campo de relatório correspondente, como ad_group_criterion.keyword.match_type mostra EXACT. Alguns exemplos de mapeamentos são mostrados na tabela a seguir.

Como os parâmetros ValueTrack são mapeados para campos de relatório

Parâmetro ValueTrack Campos nos recursos do relatório Descrição
{adgroupid} ad_group.id O ID do grupo de anúncios. Use essa opção quando você configurar suas informações de acompanhamento no nível da conta ou da campanha e quiser saber qual grupo veiculou o anúncio.
{adposition} Mapeia para uma combinação de:

Não há um campo que mapeie para o local do anúncio, como "superior" ou "lateral".

A posição na página em que o anúncio apareceu, com um valor como "1t2" (isso significa página 1, superior, posição 2).
{advanced_booking_window} segments.hotel_booking_window_days O número de dias entre a data do clique no anúncio e a data de check-in anunciada. Por exemplo, '3' para um clique no anúncio em 5 de junho com a data do check-in de 8 de junho.
{campaignid} campaign.id O ID da campanha. Use essa opção quando você configurar suas informações de acompanhamento no nível da conta e quiser saber qual campanha veiculou o anúncio.
{creative} ad_group_ad.ad.id Um ID exclusivo para o anúncio.
{device} segments.device O tipo de dispositivo que originou o clique.
{feeditemid} Nenhum (descontinuado; use asset.id com {extensionid}) O ID da extensão com base no feed que foi clicada. Observação: as extensões com base no feed foram descontinuadas e não têm um recurso de relatório correspondente nas versões compatíveis da API Google Ads. As extensões com base em recursos usam {extensionid}, que é mapeado para asset.id.
{extensionid} asset.id O ID da extensão com base em recursos que foi clicada.
{hotelcenter_id} segments.hotel_center_id O ID da conta da Central para Hotéis vinculada à campanha que gerou o anúncio quando ele foi clicado.
{hotel_id} segments.partner_hotel_id O ID do hotel do feed de hotéis da conta associada.
{keyword} segments.keyword.ad_group_criterion

A consulta de texto pode ser encontrada usando o nome do recurso de critério.

Para a rede de pesquisa, a palavra-chave da sua conta que corresponde à consulta de pesquisa. Para a Rede de Display, a palavra-chave da sua conta que corresponde ao conteúdo.
{loc_interest_ms} click_view.area_of_interest.most_specific O ID do local de interesse que ajudou a acionar o anúncio. É possível pesquisar um ID de critério usando GeoTargetConstantService.SuggestGeoTargetConstants.
{loc_physical_ms} click_view.location_of_presence.most_specific O ID da localização geográfica do clique. É possível pesquisar um ID de critério usando GeoTargetConstantService.SuggestGeoTargetConstants.
{lpurl} O URL final. Será feito escape, a menos que você coloque {lpurl} no início do seu modelo de rastreamento. Se {lpurl} não estiver no início do modelo de rastreamento, os seguintes caracteres serão escapados: ?, =, ", #, \t, ', e [space].
{matchtype} O tipo de correspondência da palavra-chave que acionou seu anúncio. (Saiba mais sobre os tipos de correspondência.)
{merchant_id} segments.product_merchant_id O ID da conta do Google Merchant Center que é a proprietária direta do anúncio do Shopping clicado.
{placement} O site da Rede de Display onde alguém clicou no anúncio (para as campanhas segmentadas por palavras-chave ), ou os critérios de segmentação por canal correspondente do site onde alguém clicou no anúncio (para as campanhas segmentadas por canal).
{product_channel} segments.product_channel O tipo de canal de compras pelo qual o produto exibido no anúncio de produto clicado é vendido.
{product_country} segments.product_country O país de venda do produto no anúncio clicado.
{product_id} segments.product_item_id O ID do produto apresentado no anúncio clicado, conforme indicado no seu feed de dados do Merchant Center.
{product_language} segments.product_language O idioma das informações do produto, conforme indicado no seu feed de dados do Merchant Center.
{product_partition_id} ad_group_criterion.criterion_id O ID exclusivo do grupo de produtos ao qual o anúncio de produto clicado pertence.
{rate_rule_id} segments.hotel_rate_rule_id O identificador de qualquer preço especial que tenha sido clicado. Os anunciantes de viagens podem aplicar tarifas condicionais a usuários (como membros de programas de fidelidade), dispositivos (como desconto para usuários de dispositivos móveis) e países específicos.
{store_code} segments.product_store_id Com uma campanha que usa o canal de compras local, você verá o ID exclusivo da loja.
{targetid} O ID da palavra-chave (identificado como "kwd"), da correspondência sem palavra-chave da IA Max ("kwl"), do anúncio dinâmico de pesquisa ("dsa") ou do destino da lista de remarketing ("aud") que acionou um anúncio. Por exemplo, se você adicionar uma lista de remarketing ao seu grupo de anúncios (ID de critério "456") e segmentar o ID de palavra-chave "123", o {targetid} será substituído por "kwd-123:aud-456".
{travel_start_day}
{travel_start_month}
{travel_start_year}
segments.hotel_check_in_date O dia, mês e ano da data do check-in mostrada no anúncio.

Como os parâmetros ValueTrack são mapeados entre a interface do Google Ads e a API Google Ads

Esta tabela mapeia os parâmetros ValueTrack entre a interface do Google Ads e a API Google Ads, em particular para os AdNetworkType valores de tipo enumerado.

Nome da interface Enumeração da API Parâmetro ValueTrack Observações
Rede de Display do Google CONTENT d Para parceiros de vídeo do Google com o parâmetro ValueTrack vp, que também aparece como CONTENT na API.
Google TV GOOGLE_TV gtv  
Várias redes MIXED x Nem sempre há um parâmetro ValueTrack.
Pesquisa Google SEARCH g  
Parceiros de pesquisa SEARCH_PARTNERS s ou a a representa uma correspondência da IA Max, normalmente associada ao tráfego sem palavras-chave.
N/A UNKNOWN N/A Retornado quando um valor de rede na interface do Google Ads não é compatível com a versão da API Google Ads consultada.
N/A UNSPECIFIED N/A  
YouTube YOUTUBE ytv  
Canais do Google UNKNOWN   A campanha de geração de demanda não retorna um parâmetro ValueTrack de rede.