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/collect

A 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

  1. Configure o fluxo de dados no GA4.
  2. Crie um API Secret para o Measurement Protocol.
  3. Defina quais eventos serão enviados pelo servidor.
  4. Preserve os identificadores necessários.
  5. Estruture o payload conforme o esquema da API.
  6. Configure o envio HTTP no backend ou na ferramenta de integração.
  7. 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/collect

Esse 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.

Compartilhe