Ativar comportamento específico da região para tags

Este artigo é destinado a desenvolvedores que veiculam scripts do Google pelo próprio servidor. Recomendamos ativar o comportamento específico da região para que as tags aproveitem recursos como o modo de consentimento avançado e controlem o comportamento da tag com base na localização dos usuários.

Antes de começar

Este guia pressupõe que você já:

Etapa 1: configurar o cabeçalho da solicitação

Você precisa enviar cabeçalhos de solicitação específicos com as informações da região do usuário, como descrito nas seções abaixo.

É possível começar diretamente da etapa 2 se:

  • Você usa o App Engine, que envia cabeçalhos geográficos automaticamente.
  • Você usa um provedor de infraestrutura diferente dos listados abaixo. É necessário configurar cabeçalhos personalizados.

Cloud Run com balanceador de carga do GCP

Você pode enviar informações de geolocalização com todos os cabeçalhos de solicitação HTTP ou para solicitações específicas. Como a adição de cabeçalhos personalizados tem uma taxa por 1 milhão de solicitações, recomendamos incluir apenas detalhes geográficos das solicitações para veicular scripts do Google. Essa opção requer mais configuração no início, mas ajuda a executar sua infraestrutura da forma mais econômica possível.

Solicitações de script

Para incluir os cabeçalhos geográficos apenas em solicitações de script, configure um novo back-end e crie regras de roteamento.

Para criar outro 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.
    Captura de tela mostrando as configurações de back-end
  3. Configure seu novo serviço:
    • Tipo de back-end: escolha o tipo de grupo de endpoints de rede que o aplicativo usa. Se você usa o Cloud Run, escolha Grupo de endpoints de rede sem servidor.
    • Em Novo back-end, escolha o grupo de endpoints de rede para a implantação do Gerenciador de tags do lado do servidor.
      Captura de tela mostrando o novo serviço de back-end
  4. Abra a seção Configurações avançadas. Adicione os cabeçalhos de solicitação personalizados.
    Nome do cabeçalho Valor do cabeçalho
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. Salve o novo serviço de back-end.

Para configurar regras de roteamento:

  1. No balanceador de carga, abra a seção Regras de roteamento. Escolha o modo Regra avançada de host e caminho.
  2. Atualize o parâmetro pathRules se quiser mapear gtm.js, /gtag/js e /gtag/destination para o novo serviço de back-end.
    pathRules:
- paths:
  - /gtm.js
  - /gtag*
  service: projects/project_id/global/backendServices/new backend service
- paths:
  - /*
  service: projects/project_id/global/backendServices/original backend service
  3. Salve as mudanças.

Todas as solicitações

Para enviar informações de geolocalização com todas as solicitações HTTP, adicione cabeçalhos de solicitação personalizados ao serviço de back-end atual. Consulte a documentação do Google Cloud. Crie um cabeçalho personalizado para cada uma das opções abaixo:

Nome do cabeçalho Valor do cabeçalho
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

Balanceador de carga do GCP

Você pode enviar informações de geolocalização com todos os cabeçalhos de solicitação HTTP ou para solicitações específicas. Como a adição de cabeçalhos personalizados tem uma taxa por 1 milhão de solicitações, recomendamos incluir apenas detalhes geográficos das solicitações para veicular scripts do Google. Essa opção requer mais configuração no início, mas ajuda a executar sua infraestrutura da forma mais econômica possível.

Solicitações de script

Para incluir os cabeçalhos geográficos apenas em solicitações de script, configure um novo back-end e crie regras de roteamento.

Para criar outro 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.
    Captura de tela mostrando as configurações de back-end
  3. Configure seu novo serviço:
    • Tipo de back-end: escolha o tipo de grupo de endpoints de rede que o aplicativo usa. Se você usa o Cloud Run, escolha Grupo de endpoints de rede sem servidor.
    • Em Novo back-end, escolha o grupo de endpoints de rede para a implantação do Gerenciador de tags do lado do servidor.
      Captura de tela mostrando o novo serviço de back-end
  4. Abra a seção Configurações avançadas. Adicione os cabeçalhos de solicitação personalizados.
    Nome do cabeçalho Valor do cabeçalho
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. Salve o novo serviço de back-end.

Para configurar regras de roteamento:

  1. No balanceador de carga, abra a seção Regras de roteamento. Escolha o modo Regra avançada de host e caminho.
  2. Atualize o parâmetro pathRules se quiser mapear gtm.js, /gtag/js e /gtag/destination para o novo serviço de back-end.
    pathRules:
- paths:
  - /gtm.js
  - /gtag*
  service: projects/project_id/global/backendServices/new backend service
- paths:
  - /*
  service: projects/project_id/global/backendServices/original backend service
  3. Salve as mudanças.

Todas as solicitações

Para enviar informações de geolocalização com todas as solicitações HTTP, adicione cabeçalhos de solicitação personalizados ao serviço de back-end atual. Consulte a documentação do Google Cloud. Crie um cabeçalho personalizado para cada uma das opções abaixo:

Nome do cabeçalho Valor do cabeçalho
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

Amazon Web Services (AWS) CloudFront

Crie uma política de solicitação de origem para adicionar os cabeçalhos CloudFront-Viewer-Country e CloudFront-Viewer-Country-Region à solicitação.

Assim, estes cabeçalhos e os respectivos valores serão adicionados automaticamente:

Nome do cabeçalho Valor do cabeçalho
CloudFront-Viewer-Country O país do usuário
CloudFront-Viewer-Country-Region A subdivisão do usuário
Configurações de cabeçalho no AWS CloudFront

Azure Front Door

Usando mecanismo de regras, crie um conjunto de regras com a ação Modificar o cabeçalho de resposta que utilize o seguinte mapeamento:

Nome do cabeçalho Valor do cabeçalho
X-Azure-Country {geo_country}
Captura de tela mostrando a configuração do Azure Front Door

Cloudflare

Ative a opção "Add visitor location headers" (Adicionar cabeçalhos de locais do visitante) na seção de transformações gerenciadas (link em inglês):

Assim, o seguinte cabeçalho será adicionado automaticamente ao valor:

Nome do cabeçalho Valor do cabeçalho
CF-IPCountry O país do usuário
Captura de tela mostrando a configuração do Cloudflare

Etapa 2: configurar a variável de região do visitante

Se você configurou cabeçalhos geográficos como especificado acima, o Gerenciador de tags detecta automaticamente a região ou o país lendo o cabeçalho da solicitação HTTP. Também é possível definir cabeçalhos personalizados.

Detecção automática

  1. Abra o Gerenciador de tags do Google.
  2. Abra o contêiner do servidor.
  3. No menu Variáveis, configure a lista de variáveis integradas.
  4. Selecione Região do visitante.

Agora, os cabeçalhos geográficos poderão ser usados na variável Região do visitante.

Cabeçalhos personalizados

  1. Abra o Gerenciador de tags do Google.
  2. Abra o contêiner do servidor.
  3. No menu Variáveis, clique em Nova para criar uma variável definida pelo usuário do tipo Região do visitante.
  4. Em Configuração da variável, escolha Variável personalizada.

  5. No menu Variáveis, crie duas variáveis de cabeçalhos de solicitação: uma para o país e outra para o código de subdivisão. Preencha os valores com os códigos de país nos cabeçalhos de solicitação HTTP.

  6. Use as variáveis criadas em Região do visitante, como mostrado na captura de tela.

    Captura de tela mostrando as configurações da variável

  7. Dê um nome à variável e clique em Salvar.

Etapa 3: ativar configurações específicas da região no cliente

Se quiser usar a região do visitante para processar as solicitações HTTP recebidas, ela precisa ser adicionada ao cliente.

  1. Selecione o cliente ou crie outro para implementar a configuração de região. Os clientes aceitos são:

    • Gerenciador de tags do Google: contêiner da Web
    • Google Analytics: GA4
    • Google Analytics: Universal Analytics

  2. Se você estiver configurando clientes do GA4 ou do UA, marque a caixa Caminhos de gtag.js padrão para IDs específicos e insira o ID de métricas do contêiner da Web.

  3. Marque a opção Ativar configurações específicas da região. Adicione a variável {{Região do visitante}} criada na etapa anterior ao campo Região.

  4. Salve seu cliente.

Etapa 4: verificar se as configurações de região são relevantes

Para testar se as configurações funcionam:

  1. Abra o Modo de visualização do contêiner do servidor.
  2. Carregue seu site enquanto usa a veiculação própria.
  3. Na janela de visualização, clique no cliente reivindicado do Google Analytics: GA4 ou do Universal Analytics. Captura de tela do cliente
  4. Para conferir a região em si, mude o botão de opção Mostrar variáveis para "valores". Captura de tela mostrando o campo de região do visitante
    • ✅ A implementação está certa se a propriedade Região mostra um código de país.
    • ❌ Se a propriedade Região mostra undefined ou está faltando, o servidor não está recebendo dados de região. Verifique se os cabeçalhos HTTP do servidor estão configurados de acordo com as variáveis predefinidas que o Gerenciador de tags do Google está procurando. Consulte Configurar o cabeçalho da solicitação.

Próximas etapas