Envoyer des événements du protocole de mesure à Google Analytics

Ce guide explique comment envoyer des événements de flux Web et d'application du protocole de mesure Google Analytics à un serveur Google Analytics. Vous pouvez ainsi afficher ces événements dans vos rapports Google Analytics.

Choisissez la plate-forme que vous souhaitez afficher dans ce guide:

Mettre en forme la requête

Le protocole de mesure pour Google Analytics 4 n'accepte que les requêtes HTTP POST.

Pour envoyer un événement, utilisez le format suivant:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Vous devez indiquer les éléments suivants dans l'URL de la requête:

  • api_secret: API SECRET généré dans l'interface utilisateur Google Analytics.

    Pour créer un secret, accédez à Administration > Flux de données > choisissez votre flux > Protocole de mesure > Créer.

  • measurement_id: ID de mesure associé à un flux. Il se trouve dans l'interface utilisateur de Google Analytics sous Administration > Flux de données > choisissez votre flux > ID de mesure.

    measurement_id n'est pas votre ID de flux.

Consultez la section Paramètres de requête pour en savoir plus.

Vous devez indiquer les éléments suivants dans le corps de la requête:

  • client_id: identifiant unique d'un client. Ceci diffère d'un app_instance_id Firebase. Utilisez gtag.js('get').

  • user_id : facultatif. Identifiant unique d'un utilisateur. Il ne peut contenir que des caractères utf-8. Pour en savoir plus sur cet identifiant, consultez la section User-ID pour l'analyse multiplate-forme.

  • events: tableau d'éléments d'événement Vous pouvez inclure plusieurs événements dans une même requête.

    Pour que l'activité des utilisateurs s'affiche dans des rapports tels que Temps réel, engagement_time_msec et session_id doivent être fournis dans le params pour un event.

    Exemple :

  {
   "client_id": "123456.7654321",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

Bien que session_start soit un nom d'événement réservé, la création d'un session_id entraîne la création d'une session sans qu'il soit nécessaire d'envoyer session_start. Découvrez comment les sessions sont comptabilisées.

Essayer

Voici un exemple que vous pouvez utiliser pour envoyer un événement tutorial_begin à votre serveur Google Analytics:

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

Limites

Les limites suivantes s'appliquent à l'envoi d'événements du protocole de mesure à Google Analytics:

  • Les requêtes ne peuvent pas comporter plus de 25 événements.
  • Les événements ne doivent pas inclure plus de 25 paramètres.
  • Les événements ne doivent pas inclure plus de 25 propriétés utilisateur.
  • Les noms de propriétés utilisateur ne doivent pas dépasser 24 caractères.
  • Les valeurs des propriétés utilisateur ne doivent pas dépasser 36 caractères.
  • Les noms d'événements ne doivent pas dépasser 40 caractères. Ils ne peuvent contenir que des caractères alphanumériques et des traits de soulignement, et doivent commencer par un caractère alphabétique.
  • Les noms de paramètres incluant des paramètres d'élément ne doivent pas comporter plus de 40 caractères. Ils ne peuvent contenir que des caractères alphanumériques et des traits de soulignement, et doivent commencer par un caractère alphabétique.
  • Les valeurs de paramètres, y compris les valeurs des paramètres d'article, ne doivent pas dépasser 100 caractères.
  • Les paramètres d'élément ne peuvent pas comporter plus de 10 paramètres personnalisés.
  • Le corps de l'article doit être inférieur à 130 Ko.
  • Les événements du protocole de mesure des applications envoyés à Google Analytics 4 ne renseignent pas les audiences sur le Réseau de Recherche dans Google Ads pour les utilisateurs d'applications.