Como mapear parâmetros ValueTrack com campos de relatórios

ValueTrack parâmetros 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 que 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 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 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 (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 do ValueTrack Campos nos recursos de 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 "parte de cima" 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 anúncio clicado no dia 5 de junho com data do check-in no dia 8 do mesmo mês.
{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} feed_item.id O ID da extensão com base em feed que foi clicada.
{extensionid} asset.id O ID da extensão com base em recurso 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

Observe que a consulta de texto pode ser encontrada usando o critério nome do recurso.

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. Você pode 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. Você pode 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 de seu modelo de acompanhamento. Se {lpurl} não estiver no início do 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. Leia mais sobre 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 Google 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 exibida 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 da API Google Ads e a API Google Ads, em especial para os valores de enumeração AdNetworkType.

Nome da interface Enumeração da API Parâmetro ValueTrack Observações
Rede de Display do Google CONTENT d Para os parceiros de vídeo do Google com o parâmetro ValueTrack vp, ele também vai aparecer como CONTENT na API.
Google TV GOOGLE_TV gtv  
Várias redes MIXED x Nem sempre há um parâmetro ValueTrack.
Pesquisa do 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 Se a API Google Ads ainda não oferecer suporte à enumeração, mas ela estiver presente na interface, a API Google Ads vai retornar UNKNOWN.
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.