En bref : Instructions pour configurer l'envoi d'événements signalés via le SDK Firebase à AppsFlyer dans Google Tag Manager.
Configuration de Google Tag Manager
Cette section décrit la configuration nécessaire dans l'interface utilisateur de Google Tag Manager (GTM). Toutes les étapes décrites dans cette section sont nécessaires pour que GTM puisse envoyer des événements à AppsFlyer. Suivez les étapes dans l’ordre indiqué.
Les étapes suivantes concernent Google Tag Manager pour les applications mobiles. Si votre interface Google Tag Manager diffère des captures d'écran présentées dans les différentes étapes, vérifiez les points suivants :
- Votre conteneur Google Tag Manager est configuré pour les applications mobiles.
- Le conteneur est en version 5. Pour plus d'informations, cliquez ici.
Remarque
Les étapes décrites dans cette section concernent un événement d'achat, mais elles sont pertinentes pour tout événement que vous souhaitez envoyer.
1. Création de variables de paramètres d'événement
Les variables de paramètres d'événements permettent à Google Tag Manager d'obtenir des données à partir de l'événement. Lorsque l'événement est envoyé, les variables ID AppsFlyer et Dev Key sont transmises avec. Google Tag Manager évalue ensuite leur valeur et c'est ainsi qu'il les obtient. Les données de l'événement ont deux fonctions :
- Fournir à Google Tag Manager l'ID AppsFlyer et la clé de développement
- Fournir à Google Tag Manager le nom et les paramètres de l'événement
Chaque fois que Google Tag Manager envoie un événement à AppsFlyer, il doit être accompagné de l'ID AppsFlyer et de la clé de développement. La clé de développement permet à Google Tag Manager de communiquer avec les serveurs AppsFlyer. L'ID AppsFlyer permet à AppsFlyer de savoir à quel utilisateur attribuer l'événement.
- Dans Google Tag Manager, cliquez sur Variables puis sur Nouveau.
- Nommez la variable « AppsFlyer Dev Key » et cliquez sur Configuration des variables
- Choisissez Paramètre d'événement
- Choisissez Paramètre personnalisé
- Dans le champ Paramètre d'événement , saisissez « dev_key » et enregistrez
- Répétez le processus pour l'ID AppsFlyer également : nommez la variable « AppsFlyer Device ID » et saisissez « af_id » dans le champ Paramètre d'événement
Exemple
Vous trouverez ci-dessous une capture d'écran de l'interface utilisateur de GTM. Elle montre la configuration finale du paramètre d'événement :
Important !
Pour iOS, un paramètre d'événement supplémentaire doit être configuré. Suivez le même flux qu'indiqué ci-dessus. Créez une variable et nommez-la « Apple App ID ». Dans le champ Paramètre d'événement, saisissez « apple_app_id » et enregistrez.
L'étape suivante consiste à créer et définir les variables AppsFlyer ID et Dev Key dans l'application. Cette étape est expliquée dans la section Envoi d'événements.
La plupart des événements intégrés nécessitent des paramètres de valeur d'événement. Dans ce cas, il s'agit des paramètres af_revenue et af_price, mais vous pouvez envoyer n'importe quel paramètre d'événement. Maintenant que l'événement est configuré dans l'application, les variables de revenu et de prix doivent être créées dans Google Tag Manager. Ces variables sont utilisées ultérieurement dans la balise d'événement d'achat.
- Dans Google Tag Manager, créez deux variables de paramètres d'événement pour af_revenue et af_price.
- Pour « af_revenue », nommez la variable « Revenu » et définissez la clé de paramètre d'événement sur « af_revenue »
- Pour « af_price », nommez la variable « Prix » et définissez la clé de paramètre d'événement sur « af_price »
Exemple
Vous trouverez ci-dessous une capture d'écran de l'interface utilisateur de GTM. Elle montre la configuration finale du paramètre d'événement :
Remarque
L'exemple suivant montre comment créer des variables de paramètres d'événement pour les paramètres Revenu et Prix. Vous pouvez créer des variables de paramètres d'événement pour tout type de paramètre d'événement, en fonction de l'événement envoyé.
2. Créer un déclencheur pour l'événement d'achat
Pour que Google Tag Manager sache si l'événement doit être envoyé à AppsFlyer, vous devez configurer un déclencheur pour cet événement.
- Dans Google Tag Manager, cliquez sur Déclencheurs , puis sur Nouveau.
- Nommez le déclencheur « Achat » et cliquez sur Configuration du déclencheur.
- Choisissez Personnalisé.
- Sélectionnez Certains événements.
- Dans les conditions, définissez le déclencheur pour qu'il s'active lorsque le nom de l'événement est égal à « af_purchase ».
- Cliquez sur Enregistrer.
Exemple
Vous trouverez ci-dessous une capture d'écran de l'interface utilisateur de GTM. Voici la configuration finale du déclencheur :
3. Créer une balise pour l'événement d'achat
Maintenant que les variables requises et le déclencheur de l'événement sont définis, vous pouvez créer la balise « Achat ».
- Dans Google Tag Manager, cliquez sur Balises , puis sur Nouveau.
- Nommez la balise « Achat » et cliquez sur Configuration de la balise.
- Choisissez AppsFlyer.
- Dans le champ ID d'application , définissez la variable intégrée ID d'application.
Important !
Pour iOS, définissez la variable personnalisée « apple_app_id » dans le champ ID d'application .
- Dans le champ Clé de développement , choisissez la variable « AppsFlyer Dev Key ».
- Dans le champ ID de l'appareil AppsFlyer , choisissez la variable « AppsFlyer Device ID ».
- Dans le champ Nom de l'événement, définissez la variable intégrée Nom de l'événement.
- Dans le champ Devise de l'événement , définissez votre code de devise, par exemple USD.
- Cliquez deux fois sur Ajouter une valeur d'événement.
- Définissez les éléments suivants :
Clé : af_revenue, Valeur : choisissez la variable de paramètre d'événement « Revenue ».
Clé : af_price, Valeur : choisissez la variable de paramètre d'événement « Prix ». - Dans la section Déclenchement, définissez le Déclencheur de déclenchementsur le déclencheur d'événement « Achat ».
- Cliquez sur Enregistrer.
Exemple
Vous trouverez ci-dessous une capture d'écran de l'interface utilisateur de GTM. Voici la configuration finale de la balise :
4. Publication du conteneur dans Google Tag Manager
- Android - app/src/main/assets/containers
- iOS - dossier racine/conteneur