Validar eventos

Elige tu plataforma:

Firebase gtag.js

El Protocolo de medición de Google Analytics no devuelve códigos de error HTTP, incluso si un evento está mal formado o le faltan parámetros obligatorios. Para verificar que tus eventos sean válidos, debes probarlos en el servidor de validación del Protocolo de Measurement 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.

Precaución: El servidor de validación no valida api_secret ni Revisa cuidadosamente esos valores para asegurarte de que sean correctos.

Puedes llamar al servidor de validación directamente o usar el Generador 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 servidor de validación del Protocolo de medición para Google Analytics 4 y cómo interpretar la respuesta.

Importante: Los eventos enviados al servidor de validación no aparecen en los informes.

Envía eventos para la validación

La única diferencia en la solicitud de eventos que se envía al servidor de validación del Protocolo de medición y al 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.

Recomendamos el siguiente enfoque para la validación:

• Usa verificaciones de validación estrictas durante el desarrollo con cualquiera de las siguientes opciones:
  • Valida las solicitudes con el Creador de eventos.
  • Envía solicitudes al servidor de validación con validation_behavior establecido en ENFORCE_RECOMMENDATIONS.
• En producción, envía solicitudes sin configurar validation_behavior para minimizar los datos rechazados por el Protocolo de medición.

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

Nota: Si deseas que se recopilen tus datos en la UE, cambia la URL que se pasa al método fetch para que comience con https://region1.google-analytics.com en lugar de https://www.google-analytics.com.

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"
    }
  ]
}

A continuación, se muestra la respuesta del servidor de validación a una solicitud sin problemas de validación:

{
  "validationMessages": []
}

Respuesta

Clave	Tipo	Descripción
validationMessages	Es un array de ValidationMessage.	Es un array de mensajes de validación.

ValidationMessage

Clave	Tipo	Descripción
fieldPath	string	Es la ruta de acceso al campo que no era válido.
description	string	Es una descripción del error.
validationCode	ValidationCode	Es un código de validación que corresponde al error.

ValidationCode

Valor	Descripción
VALUE_INVALID	El valor proporcionado para un fieldPath no era 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.