Valider des événements

Choisissez votre plate-forme:

<ph type="x-smartling-placeholder"></ph> Firebase gtag.js

Le protocole de mesure Google Analytics ne renvoie pas HTTP codes d'erreur, même si le format de l'événement est incorrect ou si des éléments obligatoires ne sont pas renseignés paramètres. Pour vous assurer que vos événements sont valides, vous devez les tester par rapport au 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, vérifiez votre implémentation pour vous assurer que vous utilisez les bonnes clés.

Attention :Le serveur de validation ne valide pas les api_secret ou Examinez attentivement ces valeurs pour vérifiez qu'ils sont corrects.

Vous pouvez soit appeler directement le serveur de validation, soit utiliser l'outil Google Analytics Event Builder. L'outil de création d'événements Google Analytics vous permet créer des événements 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 Google Serveur de validation Analytics 4 et 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 dans la requête pour les événements envoyés au protocole de mesure et 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 demande sont identiques. Pour en savoir plus, consultez la documentation de référence sur le protocole. des détails sur la création d'une requête valide.

Le code suivant montre un événement non valide envoyé au protocole de mesure. Serveur de validation:

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	Tableau <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	ValidationCode correspondant à l'erreur.

ValidationCode

Valeur	Description
VALUE_INVALID	La valeur fournie pour fieldPath n'était pas valide. Consultez les limites.
VALUE_REQUIRED	La valeur obligatoire de fieldPath n'a pas été fournie.
NAME_INVALID	Le nom fourni n'était pas valide. Consultez les limites.
NAME_RESERVED	Le nom indiqué était l'un des noms réservés. Voir les noms.
VALUE_OUT_OF_BOUNDS	La valeur fournie était 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 demande.