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 posteriormente 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 parâmetros ValueTrack, 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 é possível 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 (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 de ValueTrack são mapeados para os campos do relatório

Parâmetro do 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á campo que mapeie 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" (que significa página 1, parte de cima, 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 data do check-in em 8 de junho.
{campaignid} campaign.id O ID da campanha. Use-o quando tiver configurado as informações de acompanhamento no nível da conta e quiser saber qual campanha exibiu seu 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 (desativado; use asset.id com {extensionid}) O ID da extensão com base no feed que foi clicada. Observação: as extensões baseadas em 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 do 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. Para procurar um ID de critério, use GeoTargetConstantService.SuggestGeoTargetConstants.
{loc_physical_ms} click_view.location_of_presence.most_specific O ID da localização geográfica do clique. Para procurar um ID de critério, use GeoTargetConstantService.SuggestGeoTargetConstants.
{lpurl} O URL final. Será feito escape, a menos que você coloque {lpurl} no início do seu modelo de acompanhamento. Se {lpurl} não estiver no início do seu modelo de acompanhamento, 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 Tipo de canal de compras pelo qual o produto exibido no anúncio com informações sobre o 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 do 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 local.
{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/ano da data de check-in mostrada no anúncio.

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

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

Nome da interface Tipo enumerado 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 Geração de Demanda não retorna um parâmetro de rede ValueTrack.