Configurar o gateway de tag do Google para anunciantes

Este documento é destinado a usuários que querem implantar o gateway da tag do Google para anunciantes. Recomendamos o gateway da tag do Google para anunciantes para a configuração de tag mais durável.

Visão geral

Com o gateway da tag do Google para anunciantes, você pode implantar uma tag do Google usando sua própria infraestrutura própria, hospedada no domínio do seu site. Essa infraestrutura fica entre seu site e os serviços do Google. A configuração nesta documentação ajuda você a medir melhor seu site. É possível configurar usando sua rede de fornecimento de conteúdo (CDN), balanceador de carga ou servidor da Web atual.

Nas configurações padrão da tag do Google, sua página da Web solicita uma tag do Google de um domínio do Google. Quando a tag é acionada, ela envia solicitações de medição diretamente para o produto do Google. Com o gateway da tag do Google para anunciantes, seu site carrega a tag do Google do seu domínio próprio. Quando a tag é acionada, algumas solicitações de medição são enviadas ao Google usando seu domínio próprio.

Este diagrama representa o fluxo de informações no gateway da tag do Google para anunciantes:

Fluxo de informações da arquitetura do gateway da tag do Google para anunciantes.

Antes de começar

Este guia pressupõe que seu site já esteja configurado com:

Para começar, escolha o tipo de configuração.

1. Escolher os caminhos de medição

Você precisa reservar um caminho de medição exclusivo no domínio do seu site para veicular cada tag ou contêiner do Gerenciador de tags do Google.

Requisitos do caminho de medição:

  • Os caminhos não podem estar em uso no seu domínio.
  • Cada caminho não pode ser o caminho raiz /.
  • Cada caminho não pode exceder 100 caracteres.

Gerenciador de tags do Google:

Se você usa o Gerenciador de tags do Google, basta informar o ID do contêiner (por exemplo, GTM-XXXXXX). Essa configuração única é suficiente para todas as tags (como Google Analytics, Google Ads etc.) que já foram adicionadas ao contêiner.

Para cada contêiner ou tag independente, você precisa de um caminho de veiculação exclusivo e o ID correspondente.

Para configurar o gateway da tag do Google para anunciantes, escolha um caminho que ainda não esteja em uso no seu site. Para reduzir a probabilidade de conflito com um caminho já presente no site, escolha qualquer combinação de letras e números. Se quiser um caminho mais legível, use uma palavra como /gtm, /metrics, /analytics ou qualquer outra que você queira.

Exemplo:

Caso de uso ID Caminho de veiculação da tag Endpoint de origem
Tag independente 1 G-12345 /abjfo/ g-12345.fps.goog/abjfo/
Tag independente 2 G-67890 /fjdso/ g-67890.fps.goog/fjdso/
Contêiner do GTM GTM-ABCDEF /cvfjk/ gtm-abcdef.fps.goog/cvfjk/

Preencha o seguinte para incluir os exemplos em todo este documento.

Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics

Como lidar com várias tags ou contêineres:

Se as tags estiverem no mesmo contêiner do GTM, não será necessário repetir essa configuração. Basta adicionar o contêiner do Gerenciador de tags do Google, e todas as tags dentro dele serão processadas.

Se as tags estiverem em contêineres diferentes do GTM OU não estiverem vinculadas… É necessário repetir essa configuração para cada instância. Isso se aplica quando você está executando:

  • Vários contêineres diferentes do Gerenciador de tags do Google
  • Tags individuais (por exemplo, G-XXXXXX) que não estão em um contêiner.

Ao fazer isso, você precisa atribuir um caminho de veiculação de tag exclusivo a cada contêiner ou tag.

2. Rotear tráfego

Esta seção pressupõe que seu site já esteja usando uma CDN ou um balanceador de carga que aceite o roteamento de tráfego por caminhos.

Google Cloud

Você precisa configurar um novo back-end que procure a localização geográfica aproximada do visitante do site e crie regras de roteamento no balanceador de carga de aplicativo externo.

Criar o novo back-end

  1. Abra o balanceador de carga do GCP

  2. No balanceador de carga, abra a seção Configuração de back-end. Crie um serviço de back-end. configurações de configuração de back-end

  3. Configure seu novo serviço de back-end com informações de geolocalização:

    • Especifique um nome, como measurement-be-svc.
    • Defina o Tipo de back-end como Grupo de endpoints da rede na Internet.
    • Defina Protocolo como HTTPS e deixe Tempo limite como o valor preenchido.
    • Em Back-ends, clique no menu suspenso Grupo de endpoints de rede da Internet e crie um novo grupo de endpoints de rede da Internet:
      • Defina Tipo de grupo de endpoints de rede como NEG da Internet (global, regional).
      • Defina o Escopo como Global.
      • Defina Adicionar via como Nome de domínio totalmente qualificado e porta.
      • Defina Nome de domínio totalmente qualificado como G-12345.fps.goog.
      • Clique em CRIAR para criar o endpoint.
      • Feche a guia Grupo de endpoints de rede para voltar à guia Novo serviço de back-end.
    • Pesquise e selecione o nome do novo grupo de endpoints de rede.
    • Abra a seção Configurações avançadas. Adicione os seguintes cabeçalhos de solicitação personalizados.
      Nome do cabeçalho Valor do cabeçalho
      Host G-12345.fps.goog
      X-Forwarded-CountryRegion {client_region_subdivision}
      X-Forwarded-Geolocation latlong={client_city_lat_long};city={client_city}
    • Revise as outras configurações. Nem o Cloud CDN nem o Cloud Armor são necessários para essa integração. Portanto, você pode desativar os dois com segurança.
    • Salve o novo serviço de back-end.

Configurar regras de roteamento

  1. No balanceador de carga, abra a seção Regras de roteamento.

  2. Adicione as seguintes regras de host e caminho:

    Host Caminho Back-end
    * /metrics/* measurement-be-svc

  3. Atualize a configuração do balanceador de carga.

  4. Em um navegador, verifique a configuração acessando https://example.com/metrics/healthy. A página precisa ter o texto ok. Para verificar se as informações geográficas estão sendo incluídas, acesse https://example.com/metrics/?validate_geo=healthy. A página precisa ter o texto ok.

Cloudflare

Para veicular sua tag no gateway da tag do Google para anunciantes, crie uma entrada CNAME para um novo subdomínio, uma regra de origem para encaminhar solicitações e uma regra de transformação para incluir informações de geolocalização. Para concluir essa configuração, você precisa ter um plano Enterprise do Cloudflare. Se você não tiver um plano Enterprise, considere usar a configuração na interface do Cloudflare.

Criar entrada CNAME

Escolha um subdomínio para reservar para a entrada CNAME. Preencha o seguinte para preencher os exemplos ao longo deste documento. Esse CNAME nunca é exposto fora da sua configuração do Cloudflare, então o nome é arbitrário.

CNAME subdomain: fps
  1. Na guia "DNS", abra a seção Registros.
  2. Adicione um novo registro com a seguinte configuração:
    • Defina Tipo como CNAME.
    • Defina o Nome como fps.
    • Defina Segmentação como G-12345.fps.goog.
  3. Salve o registro CNAME.

Criar a regra de origem

  1. Na guia "Regras", abra Regras de origem e crie uma regra.
  2. Insira um nome para a regra, como Route measurement.
  3. Corresponda as solicitações recebidas com base em uma expressão de filtro personalizada e clique em Editar expressão.
  4. Cole a seguinte expressão no criador: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
  5. Atualize o Cabeçalho do host para Reescrever para... G-12345.fps.goog.
  6. Atualize o Registro DNS para Substituir por... fps.example.com.
  7. Salve a regra de origem.
  8. Se houver outras regras de origem, aumente a posição da regra recém-criada para que ela seja executada depois de outros caminhos curinga.
  9. Em um navegador, verifique a configuração acessando: https://example.com/metrics/healthy. A página deve mostrar ok.

Incluir informações de geolocalização

  1. Na guia "Regras", abra Configurações.
  2. Ative a opção Adicionar cabeçalhos de locais do visitante.
  3. Aguarde alguns minutos para que a regra seja propagada. Em um navegador, verifique a configuração acessando: https://example.com/metrics/?validate_geo=healthy. A página deve mostrar ok.

Akamai

Para veicular sua tag no gateway da tag do Google para anunciantes, adicione uma nova regra na sua propriedade para encaminhar solicitações e adicionar informações de geolocalização.

Criar a regra de redirecionamento

  1. Crie uma nova versão da sua configuração de veiculação no Gerenciador de propriedades
  2. Na seção Configurações da propriedade, adicione um novo Rule
    • Insira um nome, como Route measurement
  3. Adicione uma nova correspondência
    • Defina os menus suspensos de correspondência como Caminho e é um dos.
    • Defina o valor da correspondência como /metrics/*
  4. Adicionar um novo comportamento
    • Selecione Comportamento padrão da propriedade e escolha o comportamento Servidor de origem.
    • Defina o Nome do host do servidor de origem como G-12345.fps.goog
    • Defina Encaminhar cabeçalho do host como Nome do host de origem.
  5. Salve a nova regra e implante as mudanças
    • Teste a nova regra de redirecionamento no seu ambiente de staging antes de implantar na produção.
    • Dica: verifique se não há regras que modifiquem ou removam os cabeçalhos de resposta de saída. Isso pode causar falha nos scripts do Google se o cabeçalho de resposta Content-Type estiver ausente.

Incluir informações de geolocalização

  1. Escolha sua Regra de redirecionamento (criada acima) em Configurações de configuração da propriedade

  2. Adicionar um novo comportamento

    • Selecione Comportamento padrão da propriedade e escolha o comportamento Segmentação por conteúdo (EdgeScape).
    • Defina Ativar como true.

  3. Salve o novo comportamento e implante as mudanças.

    • Teste a nova regra de redirecionamento no seu ambiente de staging antes de implantar na produção.

  4. Em um navegador, verifique a configuração acessando https://example.com/metrics/healthy. A página precisa ter o texto ok. Para verificar se as informações geográficas estão sendo incluídas, acesse https://example.com/metrics/?validate_geo=healthy. A página precisa ter o texto ok.

Amazon CloudFront

Para veicular sua tag com o gateway da tag do Google para anunciantes, você precisa configurar o comportamento da sua distribuição para encaminhar solicitações e adicionar informações de geolocalização.

Adicionar uma nova origem

  1. Acesse a página do CloudFront na Amazon Web Services (AWS).
  2. Escolha sua distribuição do CloudFront.
  3. Na guia Origens, crie uma origem com as seguintes configurações:
    • Defina Domínio de origem como G-12345.fps.goog
    • Defina Protocolo como Somente HTTPS.

Criar o comportamento de redirecionamento

  1. Acesse a página do CloudFront na AWS.
  2. Escolha sua distribuição do CloudFront.
  3. Na guia Comportamentos, crie um Comportamento com as seguintes configurações:
    • Defina Padrão de caminho como /metrics/*
    • Defina Origem e grupos de origem como G-12345.fps.goog.
    • Defina Compactar objetos automaticamente como Não.
    • Defina Política de protocolo do visualizador como Somente HTTPS.
    • Defina Métodos HTTP permitidos como GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE
    • Em Chave de cache e solicitações de origem, escolha Política de cache e política de solicitações de origem
      • Defina Política de cache como CachingDisabled
      • Defina a Política de solicitação de origem como AllViewerExceptHostHeader.
  4. Na lista Comportamento, verifique se o Precedence do novo comportamento é maior que todos os outros comportamentos.
    • Para mudar a Precedence, selecione o comportamento e clique no botão Mover para cima até que ele fique acima de todos os outros comportamentos.
  5. Em um navegador, verifique a configuração acessando: https://example.com/metrics/healthy. A página deve mostrar ok.

Incluir informações de geolocalização

  1. Para encaminhar as informações de geolocalização necessárias, defina Headers como AllViewerExceptHostHeader no comportamento de redirecionamento.
    • Uma lista completa dos cabeçalhos de local do visualizador do CloudFront está detalhada neste artigo.
  2. Aguarde alguns minutos para que a distribuição seja implantada. Em um navegador, verifique a configuração acessando: https://example.com/metrics/?validate_geo=healthy. A página deve mostrar ok.

Fastly

Para veicular sua tag no gateway da tag do Google para anunciantes, você precisa configurar seu serviço de CDN do Fastly para encaminhar solicitações e adicionar informações de geolocalização. Esse processo envolve a criação de uma condição, um host e dois snippets de VCL.

Criar a condição e o host

Primeiro, você vai configurar uma condição para identificar solicitações para o gateway e um host para encaminhá-las ao Google.

  1. Crie uma nova condição com a seguinte configuração:

    • Tipo: Request
    • Nome: Google Tag Gateway Path (ou o nome que você preferir)
    • Inscreva-se se…: req.url.path ~ "^/metrics"

  2. Crie um novo Host com as seguintes configurações:

    • Nome/endereço do host: fps.goog

  3. Configure o novo host com estas configurações adicionais:

    • Clique em Anexar uma condição e selecione a condição criada na etapa 1.
    • Defina Substituir host como fps.goog.
    • Não altere as outras configurações.
    • Clique em Atualizar para salvar o host.

Adicionar o ID da tag do Google e cabeçalhos de geolocalização

Em seguida, adicione snippets de VCL (Varnish Configuration Language) para anexar o ID da tag do Google e os dados de geolocalização do cliente. Crie dois snippets separados, um para vcl_miss e outro para vcl_pass, usando exatamente o mesmo código.

  1. No seu serviço, acesse Snippets de VCL e crie um snippet com os seguintes campos:

    • Nome: Geo_MISS (ou o nome que você preferir)
    • Posição: Within Subroutine
    • Sub-rotina: vcl_miss

    • VCL:

      if (req.url.path ~ "^/metrics") {
  set bereq.http.X-Gtg-Tag-Id = "G-12345";
  set bereq.http.X-Forwarded-Country = client.geo.country_code;
  set bereq.http.X-Forwarded-Region = client.geo.region;
  set bereq.http.X-Forwarded-Geolocation = "latlong=" +
    client.geo.latitude + "," + client.geo.longitude + ";city=" +
    client.geo.city;
}

  2. Crie outro snippet com os seguintes campos:

    • Nome: Geo_PASS (ou o nome que você preferir)
    • Tipo: vcl_pass

    • VCL:

      if (req.url.path ~ "^/metrics") {
  set bereq.http.X-Gtg-Tag-Id = "G-12345";
  set bereq.http.X-Forwarded-Country = client.geo.country_code;
  set bereq.http.X-Forwarded-Region = client.geo.region;
  set bereq.http.X-Forwarded-Geolocation = "latlong=" +
    client.geo.latitude + "," + client.geo.longitude + ";city=" +
    client.geo.city;
}

    Agora você tem dois snippets novos e separados. Isso garante que os cabeçalhos de geolocalização sejam adicionados a qualquer solicitação que precise ser buscada do host, seja uma "ausência no cache" (vcl_miss) ou uma "passagem de cache" (vcl_pass).

Ativar e verificar a configuração completa

Com o host, a condição e os snippets de VCL criados, agora é possível ativar e testar a configuração completa.

  1. Clique em Ativar para implantar todas as novas mudanças.

  2. Verifique a configuração executando os dois testes no navegador:

    • Teste 1 (tag e roteamento): navegue até https://example.com/metrics/healthy
    • Teste 2 (geolocalização): navegue até https://example.com/metrics/?validate_geo=healthy

    As duas páginas precisam mostrar ok

Outro

Para veicular sua tag no gateway da tag do Google para anunciantes, configure a CDN ou o balanceador de carga para rotear solicitações ao endpoint do gateway.

  1. Adicione uma origem ou back-end que aponte para G-12345.fps.goog.
  2. Substitua o cabeçalho Host para que seja igual a G-12345.fps.goog. Permita que todos os cookies e strings de consulta sejam encaminhados.
  3. Transmita as informações de geolocalização do visitante incluindo um dos seguintes cabeçalhos:
    • X-Forwarded-CountryRegion: o país e a região do usuário em um único código ISO 3166-2 (por exemplo, US-CA).
    • X-Forwarded-Country e X-Forwarded-Region:
      • X-Forwarded-Country: o país do usuário como um código ISO 3166-1 alfa-2 (por exemplo, US).
      • X-Forwarded-Region: o código da subdivisão regional do usuário (por exemplo, CA).
    • Se os dois conjuntos de cabeçalhos forem incluídos, X-Forwarded-CountryRegion será usado.
  4. Adicione uma regra de caminho para /metrics/* para rotear o tráfego ao gateway da tag do Google para anunciantes.
  5. Configure o caminho reservado para que ele tenha maior prioridade do que a regra padrão.
  6. Em um navegador, verifique a configuração acessando https://example.com/metrics/healthy. A página deve mostrar ok. Para verificar se as informações geográficas estão sendo incluídas, acesse https://example.com/metrics/?validate_geo=healthy. A página deve mostrar ok.

Etapa 3: atualizar os scripts no site para usar o caminho de medição

Substitua os scripts em cada página do site por um dos seguintes:

gtag.js

Na parte de cima da seção <head>, encontre as duas linhas de script com o ID da sua tag do Google:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>

Substitua essas linhas pelo caminho de medição:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

Na parte de cima da seção <head>, substitua o snippet do Gerenciador de tags pelo seguinte:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Testar a configuração de medição

Para testar a configuração de medição, configure o contêiner para ter pelo menos uma tag acionável.

  1. Acesse o Assistente de tags e visualize seu contêiner.
  2. Navegue pelo site para acionar eventos.

  3. Na guia Resumo > Saída > Hits enviados, verifique se os hits são roteados para /metrics.

    Captura de tela verificando a configuração