Enviar dados para o Gerenciador de tags do lado do servidor

Neste artigo, você vai conferir as diferentes maneiras de enviar eventos para um contêiner do lado do servidor. Se você precisar de mais informações, saiba como funciona a inclusão de tags no servidor.

Este artigo descreve como:

• Enviar dados de um site para seu contêiner do lado do servidor
• Enviar mais dados para um contêiner do servidor
• Receber dados no contêiner do lado do servidor
• Enviar dados de outras origens que não sejam os sites

Antes de começar

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

• Criar um contêiner do servidor no Gerenciador de tags
• Configurar um servidor de tags

1. Enviar dados de um site para seu contêiner do lado do servidor

Para encaminhar dados, faça uma implementação do lado do servidor usando o Gerenciador de tags ou a tag do Google (gtag.js). Escolha a opção de implementação.

Gerenciador de tags Tag do Google (gtag.js)

Tag do Google: GA4Universal Analytics

Se quiser configurar uma tag do Google para processamento do lado do servidor, adicione o URL do contêiner do servidor.

Criar uma variável de configuração para o URL do contêiner do servidor

1. Abra o Gerenciador de tags do Google.

2. Selecione o contêiner da Web que você quer configurar.

3. Abra o menu Variáveis.

4. Crie outra variável definida pelo usuário do tipo Tag do Google: configurações.

5. Adicione os seguintes parâmetros:

   • Nome: server_container_url
   • Valor: defina como o URL do contêiner do servidor no Gerenciador de tags

6. Atribua um nome à variável, como "URL do servidor", e Salve.

Atribuir o URL do contêiner do servidor a uma tag do Google

1. Abra o menu Tags.
2. Adicione uma nova tag do Google ou edite uma atual.
3. Em Definições de configuração, selecione a variável do contêiner do servidor que você acabou de criar.
   Dica: para consultar quais parâmetros foram herdados da variável de configurações, clique em Mostrar configurações herdadas.
4. Para garantir que a tag do Google seja disparada antes de outros acionadores, clique em Acionamento e use o acionador Inicialização: todas as páginas. Conheça os acionadores de página.
5. Salve a tag e publique o contêiner.

Se quiser configurar uma tag para processamento do lado do servidor, adicione seu URL do contêiner do servidor:

1. Em um contêiner da Web, adicione uma tag do Universal Analytics com uma variável de configurações do Google Analytics ou use uma configuração atual do UA.
2. Acesse Mais configurações > Configuração avançada.
3. Marque a caixa de seleção Definir URL de transporte.
4. Adicione o URL do contêiner do servidor ao campo URL de transporte (exemplo: https://<DOMAIN_NAME>, em que DOMAIN_NAME é o nome de domínio do contêiner do servidor).
5. Configure o acionador para disparar em Inicialização: todas as páginas.
6. Salve a tag e publique o contêiner.

Opcional: enviar mais parâmetros com cada evento

Você pode enviar mais dois tipos de parâmetros: de configuração e de evento. Os parâmetros de configuração influenciam o comportamento da tag do Google e só podem ser definidos na tag do Google.

Os parâmetros de evento especificam mais informações sobre um evento e podem ser definidos para todos, alguns deles ou eventos page_view.

Parâmetros de configuraçãoTodos os eventosSelecionar eventosEventos page_view

Saiba como reutilizar as configurações no Gerenciador de tags do Google.

Para enviar outros parâmetros em todos os eventos, reutilize as configurações de eventos no Gerenciador de tags do Google.

Para enviar outros parâmetros com um evento do Google Analytics 4:

1. Em um contêiner da Web, adicione ou edite uma tag de evento do Google Analytics 4.
2. Clique em Parâmetros do evento > Adicionar linha.
3. Adicione o parâmetro que será enviado com o evento. No caso de parâmetros de eventos predefinidos, consulte a referência de eventos recomendados.
   • Em Nome do campo, adicione o nome do parâmetro, como language.
   • Em Valor, adicione o valor do parâmetro.

Dica: se o valor precisa estar definido quando o Gerenciador de tags é carregado, use uma variável, em vez de um valor codificado.

1. Configure um acionador para disparar em Inicialização: todas as páginas.
2. Salve a tag e publique o contêiner.

Para enviar um parâmetro em um evento page_view:

1. Em um contêiner da Web, edite uma tag do Google.

2. Para desativar o evento page_view padrão nas configurações, adicione novos parâmetros:

   • Nome: send_page_view
   • Valor: false

3. Crie uma tag Google Analytics: evento do GA4.

   • Selecione a tag de configuração que você modificou na etapa 1.
   • Defina o Nome do evento como page_view.

4. Adicione o parâmetro que será enviado com o evento. No caso de parâmetros de eventos predefinidos, consulte a referência de eventos recomendados. Em Nome do campo, adicione o nome do parâmetro, como language.

   • Em Valor, adicione o valor do parâmetro.

Dica: se o valor precisa estar definido quando o Gerenciador de tags é carregado, use uma variável, em vez de um valor codificado.

1. Configure um acionador para disparar em Inicialização: todas as páginas.
2. Salve a tag e publique o contêiner.

2. Receber dados no contêiner do lado do servidor

Quando você envia uma solicitação HTTP a um contêiner do servidor, um cliente precisa reivindicar essa solicitação.

Termo-chave: "clientes" são adaptadores entre o software em execução no dispositivo de um usuário e seu contêiner do Gerenciador de tags do lado do servidor. Eles recebem dados de medição de um aparelho, transformam essas informações em um ou mais eventos, processam os dados no contêiner e agrupam os resultados para serem enviados de volta ao dispositivo.

Para conferir a lista de clientes disponíveis:

1. Abra o Gerenciador de tags do Google.

2. Abra o contêiner do servidor.

3. Na barra de navegação à esquerda, clique em Clientes. O cliente do GA4 é pré-instalado no contêiner do lado do servidor por padrão. Se for necessário trabalhar com o Universal Analytics, configure um cliente do Google Analytics: Universal Analytics.

4. Clique no nome do cliente para acessar ou editar os detalhes.

Configurações opcionais do cliente

Na maioria dos casos, o cliente não vai precisar de modificações. No entanto, seu caso de uso pode ser diferente, e é recomendável editar uma destas configurações:

• Prioridade: determina a ordem em que os clientes serão executados. Os números mais elevados são executados antes, e o primeiro cliente que corresponde à solicitação recebida se torna o cliente ativo dela.

• Critérios de ativação: definem quando o cliente vai responder às solicitações.

  • Para clientes do UA – Caminhos padrão do Universal Analytics: o cliente será ativado quando os caminhos da solicitação incluírem /collect, /r/collect e outros caminhos semelhantes usados por arquivos JavaScript que enviam dados ao Google Analytics. Essa configuração fica ativada por padrão.

  • Caminhos padrão da gtag.js para IDs específicos: use essa configuração para ativar a veiculação JavaScript da gtag.js com o URL do contêiner do servidor. Quando habilitado, esse cliente será ativado em resposta às solicitações para os caminhos padrão da gtag.js, como /gtag/js?id=TAG_ID. Clique em Adicionar ID de métricas para incluir um ou mais IDs de destino.

Opcional: receber mais dados no Gerenciador de tags do lado do servidor

Se você está enviando outros parâmetros, configure o cliente do Google Analytics 4 no contêiner do servidor para analisar os demais parâmetros e criar dados de eventos com base neles.

Para usar outros parâmetros em uma tag do servidor:

1. No contêiner do servidor, clique em Variáveis na barra de navegação à esquerda.
2. Crie uma variável definida pelo usuário.
3. Em Configuração da variável, selecione o tipo de variável Dados de eventos.
4. Em Caminho da chave, insira o nome do parâmetro.
5. Atribua um nome à variável e salve.

Agora, é possível usar o parâmetro de evento em qualquer outra tag no contêiner do servidor.

3. Opcional: enviar dados de outras origens que não sejam os sites

O Measurement Protocol do Google Analytics pode ser usado para ativar o suporte à inclusão de tags no servidor de origens como apps para dispositivos móveis e aplicativos de servidor para servidor.

Apps para dispositivos móveis

Para fazer com que seu app Android ou iOS envie dados para o contêiner do servidor, crie uma tag de imagem personalizada e configure-a para usar o Measurement Protocol:

1. No seu contêiner para dispositivos móveis (Android ou iOS), clique em Tags > Nova.
2. Em Configuração da tag, selecione o tipo de tag Imagem personalizada.
3. Defina o valor de URL da imagem como uma imagem de pixel no contêiner do servidor no caminho do cliente do Measurement Protocol que você especificou. Anexe os parâmetros desejados do Measurement Protocol ao fim do URL do pixel:
   https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
4. Desmarque a opção Ativar inibição de cache.
5. Salve a tag e publique o contêiner.
6. No contêiner do servidor, clique em Clientes > Novo.
7. Em Configuração do cliente, selecione o tipo de cliente do Measurement Protocol.
8. Defina Caminho de ativação como o caminho do endpoint referente à coleção do seu app.
9. Salve a configuração do cliente e publique o contêiner do servidor.

Apps de servidor para servidor

Para enviar dados do Measurement Protocol ao seu contêiner do servidor, substitua o nome do host www.google-analytics.com pelo nome de domínio do contêiner do servidor. Exemplo:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

Para receber hits do Measurement Protocol, configure a instalação do Gerenciador de tags do lado do servidor com um cliente do Measurement Protocol:

1. No contêiner do servidor, clique em Clientes > Novo.
2. Em Configuração do cliente, selecione o tipo de cliente do Measurement Protocol.
3. Defina Caminho de ativação como o caminho do endpoint do servidor.
4. Salve a configuração do cliente e publique o contêiner.

Próximas etapas

Para enviar dados em um contexto próprio, é necessário veicular scripts do Google, como a biblioteca do Analytics dos seus servidores.

Carregar scripts do Google usando meu servidor