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