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:
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.
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.
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.
Para conferir a lista de clientes disponíveis:
Abra o contêiner do servidor.
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.
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/collecte 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:
- No contêiner do servidor, clique em Variáveis na barra de navegação à esquerda.
- Crie uma variável definida pelo usuário.
- Em Configuração da variável, selecione o tipo de variável Dados de eventos.
- Em Caminho da chave, insira o nome do parâmetro.
- 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:
- No seu contêiner para dispositivos móveis (Android ou iOS), clique em Tags > Nova.
- Em Configuração da tag, selecione o tipo de tag Imagem personalizada.
- 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 - Desmarque a opção Ativar inibição de cache.
- Salve a tag e publique o contêiner.
- No contêiner do servidor, clique em Clientes > Novo.
- Em Configuração do cliente, selecione o tipo de cliente do Measurement Protocol.
- Defina Caminho de ativação como o caminho do endpoint referente à coleção do seu app.
- 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:
- No contêiner do servidor, clique em Clientes > Novo.
- Em Configuração do cliente, selecione o tipo de cliente do Measurement Protocol.
- Defina Caminho de ativação como o caminho do endpoint do servidor.
- 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.