Valider des événements

Présentation

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 qu'il manque des paramètres obligatoires. 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 clés appropriées.

Vous pouvez appeler le serveur de validation directement ou utiliser le générateur d'événements GA4. Le générateur d'événements GA4 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 protocole de mesure pour le serveur de validation Google Analytics 4 et interpréter la réponse.

Envoi d'événements pour validation

La seule différence entre la requête pour les événements envoyés au protocole de mesure et au 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 requête sont identiques. Pour en savoir plus sur la construction 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

La réponse du serveur de validation à l'événement précédent est indiquée ci-dessous:

{
  "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.

Message de validation

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) Code de validation qui correspond à l'erreur.

Code de validation

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