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

Attention : Le serveur de validation ne valide pas les api_secret, Examinez attentivement ces valeurs pour vous assurer qu'elles sont correctes.

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.

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

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 requête sont identiques.

Nous vous recommandons d'adopter l'approche suivante pour la validation :

• Utilisez des vérifications de validation strictes pendant le développement en utilisant l'une des options suivantes :
  • Validez les requêtes avec l'outil de création d'événements.
  • Envoyez des requêtes au serveur de validation avec validation_behavior défini sur ENFORCE_RECOMMENDATIONS.
• En production, envoyez des requêtes sans définir validation_behavior pour minimiser les données rejetées par le protocole de mesure.

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 collectées dans l'UE, remplacez l'URL transmise à la méthode fetch 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 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.