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

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

1. Introduction

Dernière mise à jour : 2021-06-08

Ce que tu vas construire

Dans cet atelier de programmation, vous apprendrez à envoyer des événements externes à GA4 à l'aide du protocole de mesure .

Cet atelier de programmation suppose que vous disposez déjà d'une application avec Google Analytics pour Firebase implémenté. Si vous souhaitez apprendre à intégrer Google Analytics pour Firebase, veuillez d'abord vous référer à cet atelier de programmation . Si vous souhaitez apprendre à créer une application avec Firebase, veuillez vous référer à Firebase Android Codelab-Build Friendly Chat .

Ce que vous apprendrez

  • Étapes pour passer votre premier appel MP
  • Comprendre les paramètres requis pour l'appel
  • Envoyez et validez votre appel test
  • Créez un exemple de script en Python pour effectuer l'appel

Ce dont vous aurez besoin

  • Votre application Android ou iOS
  • N'importe quel IDE pour apporter des modifications
  • Compte GA4
  • Facultatif - Environnement de développement Python (ou Colab )

2. Rassemblez les champs obligatoires

Créer un secret d'API dans GA4

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

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

Vous pouvez fournir n'importe quel surnom, et la valeur secrète sera affichée, que vous pouvez utiliser dans votre appel

Si vous ne savez pas comment accéder à GA4, vous pouvez visiter votre projet Firebase, vérifier Paramètres du projet > Intégrations > Google Analytics, et cliquer sur "Gérer". La connexion Google Analytics doit être visible et vous pouvez également naviguer directement à partir de là

f0feed0557420678.png

Collecter app_instance_id

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

  1. Utiliser l'exportation BigQuery
  2. Récupération native dans le code source de votre application

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

  1. Utiliser l'exportation BigQuery

Si l'exportation BigQuery est activée, vous pouvez suivre les étapes ci-dessous

  • Connectez-vous à Firebase
  • Accédez à Paramètres du projet > Intégrations > BigQuery.
  • Cliquez sur "Afficher dans BigQuery" à côté de l'ensemble de données

Remarque : L'ensemble de données ne sera disponible qu'après l'activation de la bascule pendant environ 24 à 48 heures

1dc4e93dee33316f.png

  • Dans BigQuery, vous pouvez rechercher user_pseudo_id dans le tableau. Il s'agit de l'app_instance_id que vous pouvez utiliser dans votre appel

aa6d384e380a11e8.png

  1. Récupération native dans le code source de votre application

Si votre application est construite à l'aide de Java, vous pouvez utiliser quelque chose comme ceci pour récupérer le app_instance_id

 FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(new OnCompleteListener<String>() {
        @Override
        public void onComplete(@NonNull Task<String> task) {
            if (task.isSuccessful()) {
                String user_pseudo_id = task.getResult();
            }
        }
    });

Pour Kotlin, vous pouvez essayer ce qui suit

Thread {
   Firebase.analytics.appInstanceId.addOnSuccessListener { user_pseudo_id ->
       Log.d("Firebase", "user_pseudo_id using appInstanceId is $user_pseudo_id")
       /*
       Store the value to your server or do something with the retrieved id
        */
   }
}.start()

Si vous avez une application iOS, vous pouvez utiliser les éléments suivants dans Swift

let user_pseudo_id = Analytics.appInstanceID()
print("user_pseudo_id = \(user_pseudo_id)")
/*
Store the value to your server or do something with the retrieved id
*/

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. (Cela nécessite que vous vous connectiez et que les cookies soient activés). Assurez-vous que la bascule est définie sur "firebase"

15440faa9ca6a1f1.png

Vous devrez remplir les champs suivants

  • api_secret - Déjà créé plus tôt sur GA4
  • firebase_app_id - Pour l'obtenir, vous pouvez accéder à Admin > Data Streams > choisissez votre flux . Il devrait être affiché comme ci-dessous

71174b16f86ff03e.png

  • app_instance_id - Vous avez déjà récupéré cette valeur
  • user_id n'est pas obligatoire. Vous pouvez le laisser vide pour l'instant
  • Catégorie - remplacez-la par "Personnalisé" dans la liste déroulante et indiquez le nom de l'événement de votre choix (n'utilisez aucun événement collecté automatiquement ). Ici, nous utilisons "test_from_codelab"

cf580a708bb0a8a2.png

En option, 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 ça, avec un bouton pour "Valider l'événement"

39676ab485d17dc0.png

Une fois que vous y êtes parvenu, cliquez sur "VALIDER L'ÉVÉNEMENT", le bouton surligné en orange. Il devrait afficher le message ci-dessous, spécifiant que l'événement est valide, et vous verrez maintenant un bouton "SEND TO GA". À ce stade, si l'événement apparaît comme invalide, l'outil vous indiquera le champ exact où il y a un problème, et vous pouvez résoudre ce problème et réessayer.

1d63d1e067c46294.png

Vous pouvez maintenant cliquer sur le bouton, et il devrait envoyer un événement de test à GA4

4. Validation des événements dans GA4

Une fois que vous avez envoyé l'événement, vous pouvez accéder à votre compte GA4 et vérifier en temps réel. Vous devriez voir l'événement arriver

7b9e9a0f74b64757.png

Cela peut prendre environ 24 heures pour que les événements se propagent de la vue en temps réel à l'onglet de rapport d'événements réels, donc pas besoin de s'inquiéter si vous ne le voyez pas immédiatement dans le rapport d'événement régulier !

5. Construire un script Python

Maintenant que vous l'avez testé, 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) qui peut effectuer cet appel. Vous pouvez ensuite programmer cela à la fréquence souhaitée et l'opérationnaliser. Pour cette partie, vous pouvez soit utiliser n'importe quel IDE de votre choix prenant en charge Python, soit simplement utiliser un bloc-notes Google Colab qui ne nécessite aucune installation sur votre appareil.

En vous référant au générateur d'événements GA4, vous verrez que le point de terminaison est comme ci-dessous

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

La charge utile de l'événement était comme ci-dessous

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

Vous pouvez traduire ceci en python en utilisant quelque chose comme ceci

import requests
import json
url = "https://www.google-analytics.com/mp/collect?firebase_app_id=XXXX&api_secret=XXXX"
payload = {
  "app_instance_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 avez exécuté ceci avec les bonnes valeurs, vous devriez également voir l'événement se refléter en temps réel dans GA4.

6. Félicitations

Félicitations, vous avez utilisé avec succès le protocole de mesure dans GA4. Vous pouvez désormais créer des architectures de solutions puissantes pour envoyer des données plus significatives à Google Analytics et améliorer vos analyses marketing et commerciales. Afin d'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 pouvez vous référer à l'étape 6 de cet atelier de programmation pour obtenir des instructions détaillées à ce sujet. À des fins de suivi des conversions, Google Ads n'affichera que les données associées à l'IDFA ou aux identifiants d'appareils collectés à partir du SDK Firebase au cours des 60 derniers jours. Gardez à l'esprit qu'il s'agit toujours d'une API alpha et assurez-vous de respecter les limitations répertoriées ici qui doivent être traitées avant le lancement complet

Vous avez appris

  • Comment collecter les bonnes variables pour passer des appels MP
  • Comment envoyer et valider des événements de test
  • Comment créer un script pour envoyer des appels MP