Valider des événements

Choisissez votre plate-forme:

Firebase gtag.js

Le protocole de mesure Google Analytics n'affiche pas de codes d'erreur HTTP, même si un événement est incorrect ou n'inclut pas tous les paramètres obligatoires. Pour vous assurer que vos événements sont valides, vous devez les tester avec le serveur de validation du protocole de mesure avant de les déployer en production. Une fois que vous avez 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.

Attention :Le serveur de validation ne valide pas les api_secret ou Vérifiez attentivement ces valeurs pour vous assurer qu'elles sont correctes.

Vous pouvez appeler le serveur de validation directement 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 protocole de mesure pour le serveur de validation Google Analytics 4 et interpréter la réponse.

Important :Les événements envoyés au serveur de validation ne s'affichent pas dans les rapports.

Envoyer des événements pour validation

La seule différence entre la requête d'événements envoyée 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 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:

Conseil :Si vous souhaitez que vos données soient traitées dans l'UE, modifiez l'URL transmise à la méthode fetch pour qu'elle commence par https://region1.google-analytics.com au lieu de https://www.google-analytics.com.

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 requête 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 limites.
VALUE_REQUIRED	Vous n'avez pas fourni de valeur obligatoire pour un fieldPath.
NAME_INVALID	Le nom fourni n'est pas valide. Consultez les limites.
NAME_RESERVED	Le nom fourni était l'un 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 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 demande.