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 pourrez ainsi afficher les événements du protocole de mesure dans vos rapports Google Analytics.

Choisissez la plate-forme que vous souhaitez voir 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 > Choisir votre flux > ID de mesure.

    measurement_id n'est pas votre ID de flux.

Consultez la section Paramètres de requête pour une documentation de référence complète.

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

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

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

  • consent : facultatif. Découvrez comment définir les paramètres de consentement.

  • 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. Le paramètre engagement_time_msec doit refléter la durée d'engagement de l'événement en millisecondes.

    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'une session_id crée une session sans qu'il soit nécessaire d'envoyer session_start. Comprendre comment les sessions sont comptabilisées.

Essayer

Voici un exemple permettant d'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 incluant des valeurs de paramètres d'article ne doivent pas comporter plus de 100 caractères.
  • Les paramètres d'article ne peuvent pas comporter plus de 10 paramètres personnalisés.
  • La taille du corps du post doit être inférieure à 130 Ko.
  • L'attribution au niveau de l'événement à partir des événements du protocole de mesure est acceptée jusqu'à 63 jours après le dernier événement de taggage en ligne pour l'exportation des conversions vers Ads et d'autres intégrations de médias, même si la période de suivi de la conversion de l'événement de conversion est supérieure à 63 jours. En revanche, l'attribution au niveau des événements pour le taggage des événements en ligne est compatible avec l'ensemble de la période de suivi des conversions.
  • À des fins de remarketing, vous pouvez associer des événements du protocole de mesure jusqu'à un certain nombre de jours après l'événement en ligne le plus récent avec un cookie ou un ID d'appareil associé :
    • Flux Web: 30 jours
    • Flux d'application: 42 jours
  • 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.