Validar eventos

Elige tu plataforma:

Firebase gtag.js .

El Protocolo de medición de Google Analytics no devuelve Códigos de error de HTTP, incluso si un evento no tiene el formato correcto o no es obligatorio parámetros. Para asegurarte de que tus eventos sean válidos, debes probarlos con las del Servidor de validación del Protocolo de medición antes de implementarlos en la producción. Una vez que hayas validado que tus eventos están estructurados correctamente, debes verifica tu implementación para asegurarte de usar las claves correctas.

Precaución: El servidor de validación no valida la api_secret ni firebase_app_id Revisa cuidadosamente esos valores para asegúrate de que sean correctos.

Puedes llamar directamente al servidor de validación o usar la herramienta Event Builder. Google Analytics Event Builder te permite interactuar de forma interactiva construir eventos y usar el Servidor de validación del Protocolo de medición para y validarlos.

En esta guía, se describe cómo enviar eventos al Protocolo de medición para Google Analytics 4 Validation Server y la interpretación de la respuesta.

Importante: Los eventos que se envían 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 enviados al Protocolo de medición y el 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 solicitud son iguales. Consulta la referencia de protocolo para obtener detalles sobre la construcción de una solicitud válida.

El siguiente código muestra un evento no válido que se envía al Protocolo de medición Servidor de validación:

const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      // Event names must start with an alphabetic character.
      name: '_badEventName',
      params: {},
    }]
  })
});

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	Arreglo<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 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. Consultar las reservadas del usuario.
VALUE_OUT_OF_BOUNDS	El valor proporcionado era demasiado alto. Consulta las limitaciones.
EXCEEDED_MAX_ENTITIES	Se detectaron demasiados parámetros en la solicitud. Consulta las limitaciones.
NAME_DUPLICATED	Se proporcionó el mismo nombre más de una vez en la solicitud.