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