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.
  • Ce codelab suppose que vous disposez déjà d'une page Web/d'un site avec Google Analytics 4 implémenté.

Points abordés

  • Étapes à suivre pour votre premier appel au protocole de mesure
  • 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
  • Tout IDE pour apporter des modifications
  • Compte GA4
  • Facultatif : environnement de développement Python (ou Colab)

2. Collecter les champs obligatoires

Créer un code secret d'API dans GA4

Accédez à GA4 et créez votre secret d'API en accédant à Administration > Flux de données > choisissez votre flux > Protocole de mesure > Créer.

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

Vous pouvez fournir n'importe quel pseudonyme. La valeur du secret s'affiche et vous pouvez l'utiliser dans votre appel.

Collecter client_id

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

  1. Collecter des données avec gtag

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

Collecter des données avec gtag

Vous pouvez récupérer votre client_id sur 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.

3. Construire l'appel

Vous pouvez créer un exemple d'appel à l'aide du générateur d'événements dans GA4. Pour ce faire, vous devez vous connecter et avoir activé les cookies. Assurez-vous que le bouton d'activation est défini sur "gtag.js".

b904d2a053eb7817.png

Vous devrez remplir les champs suivants :

  • api_secret : déjà créé dans GA4
  • measurement_id : pour l'obtenir, accédez à Administration > Flux de données > choisissez votre flux . Il devrait s'afficher comme ci-dessous.

d362992ff592c675.png

  • 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 : sélectionnez "Personnalisé" dans le menu déroulant, puis saisissez le nom de l'événement de votre choix (n'utilisez pas de nom d'événement collecté automatiquement). Ici, nous utilisons "test_from_codelab".

cf580a708bb0a8a2.png

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.

da59bb982f6f906a.png

Une fois que vous avez tout rempli, vous devriez voir quelque chose comme ceci, avec un bouton "Valider l'événement"

31f720d550906298.png

Une fois que vous avez atteint cette étape, cliquez sur "VALIDER L'ÉVÉNEMENT" , le bouton orange. Le message ci-dessous devrait s'afficher, indiquant que l'événement est valide. Un bouton "ENVOYER À GA" devrait également apparaître. À ce stade, si l'événement est signalé comme non valide, l'outil vous indiquera le champ exact où se trouve le problème. Vous pourrez alors le corriger et réessayer.

1d63d1e067c46294.png

Vous pouvez maintenant cliquer sur le bouton. Un événement de test devrait être envoyé à GA4.

4. Valider les événements dans GA4

Une fois l'événement envoyé, vous pouvez accéder à votre compte GA4 et consulter la section "Temps réel". L'événement devrait s'afficher.

7b9e9a0f74b64757.png

Il peut s'écouler environ 24 heures avant que les événements ne soient propagés de la vue en temps réel à l'onglet de rapports sur les événements. Ne vous inquiétez donc pas si vous ne les voyez pas immédiatement dans les rapports sur les événements habituels.

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 le langage de votre choix) qui peut effectuer cet appel. Vous pouvez ensuite planifier cette requête à la fréquence souhaitée et l'opérationnaliser. Pour cette partie, vous pouvez utiliser l'IDE de votre choix compatible avec Python ou simplement 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 verrez 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 traduire cela 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 aurez exécuté cette commande avec les bonnes valeurs, l'événement devrait également s'afficher 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 solution puissantes pour envoyer des données plus pertinentes à Google Analytics et améliorer vos analyses marketing et métier. Pour en tirer le meilleur parti, nous vous suggérons également de vous connecter à Google Ads et d'importer ces événements en tant que conversions.

Vous vous êtes familiarisé avec les points suivants :

  • Collecter les bonnes variables pour effectuer des appels MP
  • Envoyer et valider des événements de test
  • Créer un script pour envoyer des appels MP

Documents de référence