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