Validar eventos

Elige tu plataforma:

El Protocolo de medición de Google Analytics para Google Analytics 4 no muestra códigos de error HTTP, incluso si un evento tiene un formato incorrecto o faltan parámetros obligatorios. Para asegurarte de que tus eventos sean válidos, debes probarlos con el servidor de validación del Protocolo de medición antes de implementarlos en producción. Una vez que hayas validado que tus eventos están estructurados correctamente, debes verificar tu implementación para asegurarte de estar usando las claves correctas.

Puedes llamar al servidor de validación directamente o usar el Compilador de eventos de GA4. El Creador de eventos de GA4 te permite crear eventos de forma interactiva y usa el servidor de validación del Protocolo de medición para validarlos.

En esta guía, se describe cómo enviar eventos al Protocolo de medición para el servidor de validación de Google Analytics 4 y cómo interpretar la respuesta.

Envía eventos para validación

La única diferencia entre la solicitud de eventos enviados al Protocolo de medición y al servidor de validación de este protocolo es la URL.

Servidor	URL
Protocolo de medición	/mp/collect
Servidor de validación del Protocolo de medición	/debug/mp/collect

Todos los demás campos de la solicitud son iguales. Consulta la referencia del protocolo para obtener detalles completos sobre cómo construir una solicitud válida.

En el siguiente código, se muestra un evento no válido que se envía al servidor de validación del Protocolo de medición:

Respuesta de validación

Esta es la respuesta del servidor de validación al evento anterior:

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

Respuesta

Clave	Tipo	Descripción
validationMessages	Array<ValidationMessage>	Un array de mensajes de validación.

ValidationMessage

Clave	Tipo	Descripción
fieldPath	cadena	La ruta de acceso al campo que no es válida.
description	cadena	Es una descripción del error.
validationCode	ValidationCode	Un ValidationCode que corresponde al error.

ValidationCode

Valor	Descripción
VALUE_INVALID	El valor proporcionado para fieldPath no es válido. Consulta las limitaciones.
VALUE_REQUIRED	No se proporcionó un valor obligatorio para fieldPath.
NAME_INVALID	El nombre proporcionado no es válido. Consulta las limitaciones.
NAME_RESERVED	El nombre proporcionado era uno de los nombres reservados. Consulta los nombres reservados.
VALUE_OUT_OF_BOUNDS	El valor proporcionado es demasiado alto. Consulta las limitaciones.
EXCEEDED_MAX_ENTITIES	La solicitud contenía demasiados parámetros. Consulta las limitaciones.
NAME_DUPLICATED	Se proporcionó el mismo nombre más de una vez en la solicitud.