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
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à
Collecter app_instance_id
Vous pouvez utiliser l'une des méthodes ci-dessous pour collecter votre app_instance_id.
- Utiliser l'exportation BigQuery
- Récupération native dans le code source de votre application
Ces deux éléments sont expliqués en détail ci-dessous
- 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
- 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
- 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"
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
- 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"
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
Une fois que vous avez tout rempli, vous devriez voir quelque chose comme ça, avec un bouton pour "Valider l'événement"
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.
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
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