Envoyer des événements Web à GA4 à l'aide du protocole de mesure

1. Introduction

Dernière mise à jour:30/04/2019

Objectifs de l'atelier

• Dans cet atelier de programmation, vous allez apprendre à envoyer des événements externes à GA4 à l'aide du protocole de mesure.
• Cet atelier de programmation suppose que vous disposez déjà d'une page Web/d'un site sur lequel Google Analytics 4 est implémenté.

Points abordés

• Étapes pour passer votre premier appel de membre du programme
• Comprendre les paramètres requis pour l'appel
• Envoyer et valider votre appel test
• Créer un exemple de script en Python pour effectuer l'appel

Prérequis

• Un site Web/une page Web
• N'importe quel IDE pour effectuer des modifications
• Compte GA4
• Environnement de développement Python (ou Colab) (facultatif)

2. Rassemblez les champs obligatoires

Créer un code secret d'API dans GA4

Accédez à GA4 et créez votre code secret de l'API en accédant à Admin > Flux de données > choisissez votre diffusion > Protocole de mesure > Créer

Vous pouvez indiquer n'importe quel pseudo pour afficher la valeur du secret, que vous pourrez utiliser lors de votre appel.

Collecter le client_id

Vous pouvez utiliser l'une des méthodes ci-dessous pour collecter votre client_id.

1. Collecte via un gtag

Ces deux points sont expliqués en détail ci-dessous.

Collecter via gtag

Vous pouvez récupérer votre client_id via votre site Web à l'aide de :

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

Vous trouverez ci-dessous d'autres liens en fonction de votre infrastructure.

• gtag.js("get")

3. Construction de l'appel

Vous pouvez créer un exemple d'appel à l'aide de l'outil de création d'événements dans GA4. (Pour cela, vous devez vous connecter et activer les cookies.) Assurez-vous que le bouton d'activation est défini sur "gtag.js"

Vous devez remplir les champs suivants :

• api_secret : déjà créé précédemment sur GA4
• measurement_id (ID de mesure) : pour l'obtenir, accédez à Administration > Flux de données > choisissez votre flux . Elle doit s'afficher comme ci-dessous.

• client_id : vous avez déjà récupéré cette valeur.
• user_id n'est pas obligatoire. Vous pouvez le laisser vide pour le moment
• Catégorie : remplacez cette catégorie par "Personnalisée". dans le menu déroulant, puis saisissez le nom d'événement de votre choix (n'utilisez pas d'événement collecté automatiquement). Ici, nous utilisons "test_from_codelab"

Vous pouvez également choisir de fournir des paramètres d'événement et/ou des propriétés utilisateur en cliquant sur les boutons ci-dessous.

Une fois que vous avez renseigné tous les champs, vous devriez obtenir un résultat semblable à celui-ci, avec un bouton "Valider l'événement".

Cliquez ensuite sur "VALIDER L'ÉVÉNEMENT". , le bouton mis en évidence en orange. Le message ci-dessous devrait s'afficher, indiquant que l'événement est valide. Un bouton intitulé "ENVOYER À GA" s'affiche. À ce stade, si l'événement est considéré comme non valide, l'outil vous indique le champ exact où le problème s'est produit. Vous pouvez le corriger, puis réessayer.

Vous pouvez maintenant cliquer sur le bouton. Cela devrait envoyer un événement de test à GA4.

4. Valider des événements dans GA4

Une fois que vous avez envoyé l'événement, vous pouvez accéder à votre compte GA4 et consulter "Temps réel". Vous devriez voir l'événement passer

Il peut s'écouler environ 24 heures avant que les événements ne soient répercutés dans l'onglet des rapports sur les événements.

5. Créer un script Python

Maintenant que vous l'avez testée, vous pouvez examiner l'appel d'API et la charge utile de l'événement pour créer une architecture similaire en Python (ou dans n'importe quel langage de votre choix) pouvant effectuer cet appel. Vous pouvez ensuite planifier l'opération à la fréquence souhaitée et l'opérationnaliser. Pour cette partie, vous pouvez utiliser n'importe quel IDE compatible avec Python ou simplement utiliser un notebook Google Colab qui ne nécessite aucune installation sur votre appareil.

En revenant à l'outil de création d'événements GA4, vous constaterez que le point de terminaison est le suivant :

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

La charge utile de l'événement était la suivante :

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

Vous pouvez le traduire en Python en utilisant quelque chose comme ceci :

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

Une fois que vous l'aurez exécutée avec les bonnes valeurs, l'événement devrait également se refléter en temps réel dans GA4.

6. Félicitations

Félicitations, vous avez utilisé le protocole de mesure dans GA4. Vous pouvez désormais créer des architectures de solutions performantes pour envoyer des données plus pertinentes à Google Analytics, et améliorer vos analyses commerciales et marketing. Pour en profiter pleinement, nous vous suggérons également d'associer ces événements à Google Ads et d'importer ces événements en tant que conversions.

Vous vous êtes familiarisé avec les points suivants :

• Comment collecter les variables appropriées pour effectuer des appels de protocole de mesure ?
• Envoyer et valider des événements de test
• Créer un script pour envoyer des appels de protocole de mesure

Documents de référence

• Protocole de mesure – Documentation de référence
• Protocole de mesure GA4 – Outil de création d'événements
• Présentation du protocole de mesure