O Google Analytics 4 Measurement Protocol permite enviar eventos diretamente para o GA4 por meio de requisições HTTP.
Ele pode ser utilizado para complementar a coleta Web e App com eventos registrados em servidores, sistemas internos e integrações.
Como funciona
Para fluxos Web, o endpoint de coleta utiliza uma requisição HTTP POST:
POST https://www.google-analytics.com/mp/collectA autenticação utiliza parâmetros como:
- measurement_id: identificador do fluxo Web.
- api_secret: segredo criado para o Measurement Protocol.
O corpo da requisição contém identificadores e uma lista de eventos.
Exemplo prático
{
"client_id": "1234567890.1234567890",
"events": [
{
"name": "generate_lead",
"params": {
"session_id": 1234567890,
"engagement_time_msec": 100,
"lead_type": "consultoria"
}
}
]
}O client_id deve ser obtido e preservado corretamente para relacionar o evento ao usuário Web.
O session_id, quando aplicável, ajuda a associar o evento a uma sessão existente.
Como implementar
- Configure o fluxo de dados no GA4.
- Crie um API Secret para o Measurement Protocol.
- Defina quais eventos serão enviados pelo servidor.
- Preserve os identificadores necessários.
- Estruture o payload conforme o esquema da API.
- Configure o envio HTTP no backend ou na ferramenta de integração.
- Teste e monitore o processamento dos eventos.
Como validar
O GA4 disponibiliza um endpoint específico para validação:
POST https://www.google-analytics.com/debug/mp/collectEsse endpoint permite identificar problemas de estrutura e parâmetros antes do envio definitivo.
Utilize também o DebugView e os relatórios do GA4 para verificar os eventos recebidos, considerando as condições necessárias para sua visualização.
Pontos de atenção
- Uma resposta HTTP bem-sucedida não garante que todos os dados foram processados.
- O Measurement Protocol não cria automaticamente o contexto completo de uma sessão.
- Eventos enviados sem identificadores consistentes podem ficar desconectados da jornada.
- Não envie informações pessoais identificáveis em parâmetros comuns do GA4.
- Evite duplicar eventos já enviados pela implementação Web.
- Proteja o api_secret e não o exponha em código público.
O Measurement Protocol é especialmente útil quando um evento de negócio ocorre fora do navegador, mas precisa complementar a mensuração do GA4.
