Elige tu plataforma:
El Protocolo de medición de Google Analytics 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 en el servidor de validación del Protocolo de medición antes de implementarlos en producción. Después de validar que tus eventos estén estructurados correctamente, debes verificar tu implementación para asegurarte de que estés usando las claves correctas.
Puedes llamar al servidor de validación directamente o usar el Creador de eventos de Google Analytics. El Creador de eventos de Google Analytics 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 su validación
La única diferencia en la solicitud de eventos que se envía al Protocolo de medición y al servidor de validación del Protocolo de medición 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 la compilación de 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"
}
]
}
Esta es la respuesta del servidor de validación a una solicitud sin problemas de validación:
{
"validationMessages": []
}
Respuesta
Clave | Tipo | Descripción |
---|---|---|
validationMessages | Array<ValidationMessage> | Un array de mensajes de validación. |
ValidationMessage
Clave | Tipo | Descripción |
---|---|---|
fieldPath | string | La ruta de acceso al campo que no era válida. |
description | string | Es una descripción del error. |
validationCode | ValidationCode | Un código de validación que corresponde al error. |
ValidationCode
Valor | Descripción |
---|---|
VALUE_INVALID | El valor proporcionado para un fieldPath no es válido. Consulta las limitaciones. |
VALUE_REQUIRED | No se proporcionó un valor obligatorio para un 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 era demasiado grande. Consulta las limitaciones. |
EXCEEDED_MAX_ENTITIES | Había demasiados parámetros en la solicitud. Consulta las limitaciones. |
NAME_DUPLICATED | Se proporcionó el mismo nombre más de una vez en la solicitud. |