Valider des événements

Sélectionnez votre plate-forme :

Le protocole de mesure Google Analytics ne renvoie pas de codes d'erreur HTTP, même si un événement est incorrect ou s'il manque des paramètres obligatoires. Pour vous assurer que vos événements sont valides, vous devriez les tester avec 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 valider votre implémentation pour vous assurer d'utiliser les bonnes clés.

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

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

Envoyer des événements pour validation

La seule différence entre la requête pour les événements envoyés au protocole de mesure et celle pour le serveur de validation du protocole de mesure est l'URL.

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

Tous les autres champs de la requête sont identiques. Pour en savoir plus sur la création d'une requête valide, consultez la documentation de référence sur le protocole.

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

Voici la réponse du serveur de validation à une demande sans problème de validation :

{
  "validationMessages": []
}

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 un fieldPath n'est pas valide. Consultez les limitations.
VALUE_REQUIRED Aucune valeur obligatoire n'a été fournie pour un fieldPath.
NAME_INVALID Le nom fourni n'était pas valide. Consultez les limitations.
NAME_RESERVED Le nom fourni fait partie des noms réservés. Consultez la section Noms réservés.
VALUE_OUT_OF_BOUNDS La valeur fournie était trop élevée. Consultez les limitations.
EXCEEDED_MAX_ENTITIES La requête contenait trop de paramètres. Consultez les limitations.
NAME_DUPLICATED Le même nom a été fourni plusieurs fois dans la demande.