Configuração de domínios personalizados

Este artigo é destinado a desenvolvedores que querem hospedar a inclusão de tags no servidor no mesmo contexto próprio do site. A veiculação de mesma origem é uma prática recomendada que permite usar os benefícios de segurança e durabilidade dos cookies definidos pelo servidor. As instruções abaixo se aplicam à configuração da veiculação de mesma origem, seja qual for a tag do Google implantada no seu site (gtag.js ou gtm.js).

Quando você configura um servidor de tags pela primeira vez, ele é hospedado em um domínio fornecido pelo provedor de nuvem. Quando você usa o endpoint padrão, ele envia dados ao contêiner do servidor, mas é executado em um contexto de terceiros. Para aproveitar os benefícios de um contexto próprio, como cookies mais duráveis, o servidor de tags e o site precisam ser executados no mesmo domínio.

A tabela abaixo ilustra como hospedar um servidor de tags quando o site pai está hospedado em www.example.com:

Mesma origem (prática recomendada) Subdomínio Domínio padrão
URL de exemplo https://www.example.com/metrics https://metrics.example.com https://metrics.run.app
Acesso a cookies definidos pelo servidor Acesso completo aos benefícios de segurança e durabilidade. Acesso completo aos benefícios de segurança e durabilidade. Nenhum. Permite definir apenas cookies de JavaScript.
Complexidade da instalação Configure uma CDN ou balanceador de carga para encaminhar solicitações. Talvez seja necessário atualizar entradas de DNS. Atualize as entradas de DNS. Vem pré-configurada.

Selecione a opção de implementação desejada para iniciar.

Pré-requisitos

Confira o que é necessário para seguir este guia:

  • Criar um contêiner do servidor no Gerenciador de tags
  • Definir um servidor de tags
  • Uma CDN ou balanceador de carga que encaminhe solicitações
  • Se você usa o App Engine: o servidor de tags precisará executar a versão 2.2.0 ou mais recente. Para preparar seu servidor de tags para as exigências futuras, migre para o Cloud Run.

Configurar o domínio personalizado

Você pode configurar o contêiner do servidor para que ele seja executado em um caminho com o mesmo domínio do seu site. Por exemplo, se o site disponibilizar tráfego da Web em www.example.com, reserve um caminho como www.example.com/metrics para o contêiner do servidor.

Diagrama de inclusão de tags no servidor configurada na mesma origem.

1. Escolher um caminho do seu domínio para usar no servidor de tags

Esse caminho será reservado para a implementação com veiculação própria. Escolha um caminho que você ainda não esteja usando.

Exemplos de caminhos que convém usar: /collect, /metrics, /data

Anote a string do caminho. Você a usará nas próximas etapas no lugar de /metrics sempre que aparecer /metrics.

2. Rotear o tráfego para seu servidor de tags

Se o site já estiver configurado com uma CDN ou balanceador de carga compatível com roteamento de tráfego por caminhos, pule para a etapa 4.

  1. Adicione uma origem ou back-end que aponte para seu site.
  2. Substitua o cabeçalho do Host pelo nome do host do site, como example.com.
  3. Permita que todos os cookies e strings de consulta sejam encaminhados. Se a plataforma não tiver essa opção, provavelmente ela fará o encaminhamento por padrão.
  4. Adicione outra origem ou back-end que aponte para seu servidor de tags. Pode ser o domínio fornecido pelo provedor de nuvem, como metrics.run.app.
  5. Substitua o cabeçalho do Host para que seja o mesmo do domínio especificado acima. Permita que todos os cookies e strings de consulta sejam encaminhados.
  6. Adicione uma regra de caminho, como /metrics/*, para rotear tráfego para o servidor de tags.
  7. Configure o caminho reservado de inclusão de tags para que ele tenha maior prioridade do que a regra padrão.
  8. Atualize o DNS para que ele aponte para a CDN ou balanceador de carga, caso não tenha feito isso ainda. A propagação das atualizações de DNS pode levar algum tempo.
  9. Acesse o endpoint /healthy no domínio que você acabou de definir, como https://example.com/metrics/healthy. Será exibido um ok.

3. Atualizar o URL do servidor no Gerenciador de tags do Google

Você precisará atualizar a configuração do contêiner do servidor para que ela identifique o prefixo do caminho e processe as solicitações da forma certa.

Para atualizar para o novo endpoint:

  1. Abra o Gerenciador de tags do Google.
  2. Abra o contêiner do servidor que está definido na mesma origem que o site.
  3. Na guia Administrador > Configurações de contêiner, remova todos os URLs anteriores. Essa ação é necessária porque todos os URLs de contêineres do servidor precisarão ter o mesmo caminho.
  4. Clique em Adicionar URL e insira seu URL, incluindo o prefixo do caminho.
  5. Salve e volte para seu espaço de trabalho.
  6. Clique no botão Visualização para iniciar uma sessão de depuração e enviar uma solicitação em uma guia separada.
  7. Clique na solicitação enviada. Confira se o cliente reivindicou a solicitação enviada.

Solução de problemas comuns

  1. A visualização não exibe as solicitações de entrada
    1. Navegue até a análise de registros do seu projeto na nuvem. Verifique se a implantação da inclusão de tags no servidor está recebendo tráfego. Se não estiver, siga as instruções na etapa 1.
    2. Confirme se a CDN ou o balanceador de carga está encaminhando os cookies.
    3. Verifique se você tem apenas um servidor de visualização e se os servidores de tags têm o PREVIEW_SERVER_URL definido.
    4. Acesse PREVIEW_SERVER_URL + /healthy para confirmar se o servidor de visualização está sendo executado. Será exibido um ok.
  2. Os clientes não estão reivindicando solicitações: atualize o URL nas Configurações de contêiner para usar o caminho reservado. Se o URL não tiver o caminho ou se eles forem diferentes, os clientes não funcionarão da forma adequada.