Validar eventos

Escolha sua plataforma:

Firebase gtag.js

O Measurement Protocol do Google Analytics para o Google Analytics 4 não retorna códigos de erro HTTP, mesmo que um evento esteja incorreto ou não tenha os parâmetros necessários. Para garantir que os eventos sejam válidos, é necessário testá-los no servidor de validação do Measurement Protocol antes de implantá-los na produção. Depois de validar se os eventos estão estruturados corretamente, verifique a implementação para ter certeza de que você está usando as chaves corretas.

Cuidado: o servidor de validação não valida api_secret ou Revise cuidadosamente esses valores para garantir que estejam corretos.

Chame o servidor de validação diretamente ou use o Criador de eventos do GA4. Com o Criador de eventos do GA4, é possível criar eventos de maneira interativa e usar o servidor de validação do Measurement Protocol para validá-los.

Neste guia, descrevemos como enviar eventos para o servidor de validação do Measurement Protocol para Google Analytics 4 e interpretar a resposta.

Importante :os eventos enviados ao servidor de validação não aparecem nos relatórios.

Como enviar eventos para validação

A única diferença na solicitação de eventos enviados para o Measurement Protocol e o servidor de validação do Measurement Protocol é o URL.

Servidor	URL
Measurement Protocol	/mp/collect
Servidor de validação do Measurement Protocol	/debug/mp/collect

Todos os outros campos de solicitação são os mesmos. Consulte a referência de protocolo para ver detalhes completos sobre como criar uma solicitação válida.

O código a seguir mostra um evento inválido que está sendo enviado ao servidor de validação do Measurement Protocol:

Resposta de validação

Esta é a resposta do servidor de validação ao evento anterior:

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

Resposta

Chave	Tipo	Descrição
validationMessages	Array<ValidationMessage>	Matriz de mensagens de validação.

ValidationMessage

Chave	Tipo	Descrição
fieldPath	string	Caminho para o campo inválido.
description	string	Descrição do erro.
validationCode	ValidationCode	Um ValidationCode que corresponde ao erro.

ValidationCode

Valor	Descrição
VALUE_INVALID	O valor informado para fieldPath é inválido. Veja as limitações.
VALUE_REQUIRED	Um valor obrigatório não foi informado para um fieldPath.
NAME_INVALID	O nome informado é inválido. Veja as limitações.
NAME_RESERVED	O nome informado é um dos nomes reservados. Veja os nomes reservados.
VALUE_OUT_OF_BOUNDS	O valor informado é muito grande. Veja as limitações.
EXCEEDED_MAX_ENTITIES	Havia muitos parâmetros na solicitação. Veja as limitações.
NAME_DUPLICATED	O mesmo nome foi informado mais de uma vez na solicitação.