Configurar o modo próprio

Este documento é destinado a usuários que querem implantar a tag do Google no modo próprio. Recomendamos o modo próprio para a configuração de tag mais durável.

Visão geral

Observação: o modo próprio está na versão Beta. Isso pode melhorar a configuração da tag, resultando na recuperação de indicadores de medição perdidos, com proteção da privacidade. Se você tiver dúvidas ou problemas com sua configuração, entre em contato pelo e-mail [e-mail].

Com o modo próprio, você pode implantar a tag do Google usando uma infraestrutura própria, hospedada no domínio do seu site (por exemplo, example.com). Essa infraestrutura fica entre o site e os serviços do Google, fazendo da sua infraestrutura própria a única tecnologia para interagir diretamente com os usuários do site. O modo próprio adiciona uma camada de segurança de dados e ativa outros controles de privacidade de dados, como a ofuscação total de IP, sem comprometer a medição. A configuração nesta documentação vai ajudar você a recuperar X% a mais de indicadores de medição no seu site. É possível configurá-lo usando a rede de fornecimento de conteúdo (CDN), o balanceador de carga ou o servidor da Web para ativar o modo próprio.

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 (por exemplo, www.googletagmanager.com). Quando a tag é disparada, ela envia solicitações de medição diretamente para o produto do Google. No modo próprio, seu site carrega a tag do Google usando o domínio próprio (por exemplo, example.com). Quando a tag é disparada, ela envia solicitações de medição ao seu domínio próprio, onde elas são encaminhadas ao produto do Google relevante.

Você vai ter continuidade de medição ao mudar da configuração padrão da tag do Google para o modo próprio.

Este diagrama representa o fluxo de informações no modo próprio:

Antes de começar

Para seguir este guia, o site precisa estar configurado com:

• Uma tag do Google ou um contêiner do Gerenciador de tags
• uma rede de fornecimento de conteúdo (CDN) ou balanceador de carga que possa encaminhar solicitações para endpoints externos;

1. Escolha o caminho de veiculação da tag

Você precisa reservar um caminho no domínio do site para veicular a tag. Certifique-se de que esse caminho ainda não esteja em uso no seu domínio.

Escolha o caminho que você quer usar para configurar o modo próprio. Exemplos de caminhos que convém usar incluem: /metrics, /securemetric, /analytics ou, preferencialmente, uma string alfanumérica aleatória que você ainda não usa no seu site.

Preencha os campos a seguir para preencher os exemplos ao longo deste documento.

Your domain: example.com
Google tag ID: GTM-123456
Tag serving path: /metrics

Atenção :essa configuração redireciona todo o tráfego com o caminho escolhido. Para evitar afetar seu site, escolha um caminho que ainda não esteja em uso.

2. Rotear tráfego

Esta seção pressupõe que seu site já esteja usando uma CDN ou balanceador de carga que oferece suporte ao 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 criar regras de roteamento no balanceador de carga de aplicativo externo atual.

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 novo serviç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 de rede na Internet.
   • Defina Protocolo como HTTPS e deixe Tempo limite como o valor pré-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 por como Nome e porta de domínio totalmente qualificado.
     • Defina Nome de domínio totalmente qualificado como GTM-123456.fps.goog.
     • Clique em CRIAR para criar o endpoint.
     • Feche a guia Grupo de endpoints de rede para retornar à guia Novo serviço de back-end.
   • Pesquise e selecione o novo grupo de endpoints de rede.
   • Abra a seção Configurações avançadas. Adicione os cabeçalhos de solicitação personalizados a seguir.

     Nome do cabeçalho	Valor do cabeçalho
     Host	GTM-123456.fps.goog
     X-Gclb-Country	{client_region}
     X-Gclb-Region	{client_region_subdivision}

   • Revise as outras configurações. O Cloud CDN nem o Cloud Armor são necessários para essa integração. Portanto, é possível 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, acesse https://example.com/metrics/healthy para verificar a configuração. A página precisa ter o texto ok. Verifique se as informações geográficas estão sendo incluídas navegando para: https://example.com/metrics/?validate_geo=healthy. A página precisa ter o texto ok.

Cloudflare

Para veicular sua tag no modo próprio, crie uma entrada CNAME para um novo subdomínio, crie uma Regra de origem para encaminhar solicitações e crie uma Regra de transformação para incluir informações de geolocalização.

Criar entrada CNAME

Observação :as tags não vão usar essa entrada CNAME. O Cloudflare a usa para rotear solicitações internamente.

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

CNAME subdomain: fps

1. Na guia "DNS", abra a seção Records.
2. Adicione um novo registro com a seguinte configuração:
   • Defina Type com CNAME.
   • Defina o Nome como fps.
   • Defina Meta como GTM-123456.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. Faça a correspondência das 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 builder: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. Atualize o Host Header para Rewrite to.... GTM-123456.fps.goog.
6. Atualize o Registro DNS para Substituir para... 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 após qualquer outro caminho curinga.
9. Em um navegador, acesse https://example.com/metrics/healthy para verificar a configuração. O texto da página precisa ser ok.

Incluir informações de geolocalização

1. Na guia "Regras", abra Regras de transformação.
2. Crie uma regra Modificar cabeçalho da solicitação.
3. Aplica a regra a Todas as solicitações recebidas.
4. Modifique o cabeçalho da solicitação com a seguinte configuração:
   • Defina o operador como Definir dinâmico.
   • Defina o Nome do cabeçalho como X-CfIpCountryRegion.
   • Defina o Valor como ip.src.subdivision_1_iso_code.
5. Implante a regra de transformação.
6. Aguarde alguns minutos até que a regra seja propagada. Em um navegador, verifique a configuração acessando: https://example.com/metrics/?validate_geo=healthy. A página precisa ser ok.

(Opcional) Remover cabeçalhos de IP do visitante

O modo próprio não exige IP do visitante para funcionar corretamente. Remova todos os cabeçalhos de IP de visitante usando a opção Remover cabeçalhos de IP de visitantes transformações gerenciadas.

Outros

Para veicular a tag no modo próprio, configure a CDN ou o balanceador de carga para encaminhar solicitações para o endpoint do modo próprio.

1. Adicione uma origem ou back-end que aponte para GTM-123456.fps.goog.
2. Substitua o cabeçalho do Host para que seja igual a GTM-123456.fps.goog. Permita que todos os cookies e strings de consulta sejam encaminhados.
3. Adicione uma regra de caminho para /metrics/* a fim de rotear o tráfego para o modo próprio.
4. Configure o caminho reservado para ter maior prioridade que a regra padrão.
5. Em um navegador, acesse https://example.com/metrics/healthy para verificar a configuração. O texto da página precisa ser 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 uma das opções a seguir:

gtag.js

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

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

e substitua-os 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 -->

Etapa 4: testar a configuração da medição

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

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

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

   

Etapa 5: feedback

Envie feedback sobre o modo próprio usando o formulário de feedback.