Valider des événements

Choisissez votre plate-forme:

Le protocole de mesure Google Analytics pour Google Analytics 4 ne renvoie pas de codes d'erreur HTTP, même si un événement est incorrect ou si des paramètres obligatoires manquent. Pour vous assurer que vos événements sont valides, vous devez les tester sur le serveur de validation du protocole de mesure avant de les déployer en production. Après avoir vérifié que vos événements sont correctement structurés, vous devez vérifier votre implémentation pour vous assurer que vous utilisez les bonnes clés.

Vous pouvez appeler directement le serveur de validation ou utiliser le générateur d'événements GA4. L'outil de création d'événements GA4 vous permet de créer des événements de manière interactive et de les valider à l'aide du serveur de validation du protocole de mesure.

Ce guide explique comment envoyer des événements au protocole de mesure pour le serveur de validation Google Analytics 4 et interpréter la réponse.

Envoyer des événements pour validation

L'URL est la seule différence entre la requête d'événements envoyée au protocole de mesure et celle au serveur de validation du protocole de mesure.

Autoscaling	URL
Protocole de mesure	/mp/collect
Serveur de validation du protocole de mesure	/debug/mp/collect

Tous les autres champs de requête sont identiques. Consultez la documentation de référence du protocole pour en savoir plus sur la construction d'une requête valide.

Le code suivant montre un événement non valide envoyé au serveur de validation du protocole de mesure:

Réponse de validation

Voici la réponse du serveur de validation à l'événement précédent:

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

Réponse

Clé	Type	Description
validationMessages	Array<ValidationMessage>	Tableau de messages de validation.

ValidationMessage

Clé	Type	Description
fieldPath	chaîne	Chemin d'accès au champ non valide.
description	chaîne	Description de l'erreur.
validationCode	ValidationCode	Code de validation correspondant à l'erreur.

ValidationCode

Valeur	Description
VALUE_INVALID	La valeur fournie pour l'élément fieldPath n'est pas valide. Consultez les limites.
VALUE_REQUIRED	Vous n'avez pas fourni de valeur obligatoire pour fieldPath.
NAME_INVALID	Le nom indiqué n'était pas valide. Consultez les limites.
NAME_RESERVED	Le nom indiqué est l'un des noms réservés. Voir Noms réservés.
VALUE_OUT_OF_BOUNDS	La valeur fournie était trop élevée. Consultez les limites.
EXCEEDED_MAX_ENTITIES	La requête comportait trop de paramètres. Consultez les limites.
NAME_DUPLICATED	Le même nom a été fourni plusieurs fois dans la requête.