Valider des événements

Choisissez votre plate-forme:

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.

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.

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:

const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      // Event names must start with an alphabetic character.
      name: '_badEventName',
      params: {},
    }]
  })
});

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.