Google Tag Manager pour Android

En tant que développeur, vous pouvez utiliser Google Tag Manager pour implémenter et gérer des balises et des pixels de mesure dans vos applications mobiles, sans avoir à recréer ni à renvoyer des binaires d'application aux marketplaces d'applications. Les développeurs qui utilisent le SDK Google Analytics pour Firebase peuvent facilement ajouter Tag Manager pour gérer et modifier l'implémentation, même après la publication de l'application.

Les développeurs peuvent enregistrer des événements importants et décider ultérieurement des balises ou des pixels à déclencher.

Prérequis

Avant de commencer :

• Dans la console Firebase, ajoutez votre application à votre projet Firebase.
• Configurez Google Analytics pour votre application, y compris en activant Google Analytics dans votre projet Firebase et en ajoutant le SDK Google Analytics pour Firebase à votre application.
• Créez un compte Tag Manager.
• Configurez un conteneur Google Tag Manager.

Les sections suivantes vous expliquent comment configurer et utiliser Google Tag Manager dans votre application Android.

1. Ajouter Google Tag Manager à votre projet

1. Dans le fichier Gradle de votre module (généralement app/build.gradle), ajoutez la dépendance suivante à la bibliothèque Tag Manager :

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.3.0'
   }
   

2. Connectez-vous à votre compte Tag Manager.

3. Sélectionnez un conteneur mobile.

4. Cliquez sur Versions dans la barre de navigation en haut.

5. Cliquez sur la version du conteneur que vous souhaitez utiliser.

6. Cliquez sur Télécharger.

7. Créez le dossier app/src/main/assets/containers s'il n'existe pas. Copiez le conteneur téléchargé dans le dossier.

2. Enregistrer des événements et des variables

Tag Manager utilise les événements, les paramètres et les propriétés utilisateur enregistrés par le SDK Google Analytics pour Firebase afin de déclencher et de créer les balises que vous avez configurées dans Google Tag Manager.

Pour savoir comment enregistrer des événements et définir des propriétés utilisateur, consultez la documentation Firebase pour les développeurs.

Configurer des variables dans Tag Manager

Pour capturer la valeur des paramètres d'événement et des propriétés utilisateur à utiliser dans Google Tag Manager, vous pouvez configurer des variables dans l'interface Tag Manager.

Par exemple, vous pouvez enregistrer l'événement personnalisé suivant dans votre application :

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Vous pouvez ensuite configurer de nouvelles variables de paramètre d'événement dans Tag Manager comme suit pour capturer les valeurs image_name et full_text parameter :

• Nom de la variable : Image Name
• Type de variable : Paramètre d'événement
• Nom de la clé du paramètre d'événement : image_name

et

• Nom de la variable : Full Text
• Type de variable : Paramètre d'événement
• Nom de la clé du paramètre d'événement : full_text

De même, vous pouvez définir la propriété utilisateur suivante dans votre application :

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

Vous pouvez ensuite configurer une nouvelle variable de propriété utilisateur Firebase dans Google Tag Manager pour capturer la valeur favorite_food :

• Nom de la variable : Favorite Food
• Type de variable : Propriété utilisateur Firebase
• Nom de la clé du paramètre d'événement : favorite_food

Modifier et bloquer des événements

Tag Manager vous permet de modifier et de bloquer des événements avant qu'ils ne soient enregistrés par le SDK Google Analytics pour Firebase. La modification des événements peut vous aider à ajouter, supprimer ou modifier les valeurs des paramètres d'événement ou à ajuster les noms d'événements sans mettre à jour l'application. Les événements qui ne sont pas bloqués seront enregistrés par le SDK Google Analytics pour Firebase.

Le SDK Google Analytics pour Firebase enregistre également automatiquement certains événements et propriétés utilisateur. Vous pouvez utiliser les événements et les propriétés collectés automatiquement dans Tag Manager sans avoir à ajouter de code. Toutefois, vous ne pouvez pas les bloquer.

3. Envoyer des événements

Les variables de nom d'événement Firebase, les variables de paramètre d'événement Firebase et d'autres variables sont utilisées pour configurer des déclencheurs. Les conditions de déclenchement sont évaluées chaque fois que vous enregistrez un événement Firebase. Par défaut, les événements Google Analytics pour Firebase se déclenchent automatiquement. Vous pouvez ajouter une balise Google Analytics pour Firebase dans Tag Manager afin d'empêcher l'envoi d'événements à Google Analytics.

4. Prévisualiser, déboguer et publier votre conteneur

Avant de publier une version de votre conteneur, vous devez la prévisualiser pour vous assurer qu'elle fonctionne comme prévu. Google Tag Manager vous permet de prévisualiser les versions de votre conteneur en générant des liens et des codes QR dans l'interface Web, puis en les utilisant pour ouvrir votre application. Vous pouvez également activer un mode de journalisation détaillé pour déboguer tout comportement inattendu.

Prévisualiser un conteneur

Avant de prévisualiser un conteneur, générez une URL d'aperçu dans l'interface Web Google Tag Manager en sélectionnant la version du conteneur que vous souhaitez prévisualiser, puis en sélectionnant Aperçu. Enregistrez cette URL d'aperçu pour les étapes ultérieures.

Figure 1 : Obtenir une URL d'aperçu à partir de l'interface Web Tag Manager.

Pour prévisualiser votre conteneur (si vous utilisez Android Studio, passez à l'étape 3) :

1. Ajoutez cette activité d'aperçu à votre fichier AndroidManifest :

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. Modifiez cette ligne pour inclure le nom de package de votre application :

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. Dans l'interface Web Google Tag Manager, générez un lien d'aperçu :

   1. Connectez-vous à votre compte Tag Manager.
   2. Sélectionnez un conteneur mobile.
   3. Cliquez sur Versions dans la barre de navigation en haut.
   4. Cliquez sur Actions > Aperçu dans la version du conteneur que vous souhaitez prévisualiser.
   5. Saisissez le nom de package de votre application.
   6. Cliquez sur Générer un lien de début d'aperçu.

4. Arrêtez votre application et utilisez le lien d'aperçu ou le code QR généré pour la lancer.

5. Vous pouvez quitter le mode Aperçu en cliquant sur un lien généré par l'option Générer un lien de fin d'aperçu dans l'interface Web.

Déboguer un conteneur

Pour résoudre les problèmes liés à l'implémentation de votre conteneur, activez la journalisation détaillée :

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Publier un conteneur

Une fois que vous avez prévisualisé votre conteneur et vérifié qu'il fonctionne, vous pouvez le publier. Une fois votre conteneur publié, les configurations de vos balises seront disponibles pour les utilisateurs d'applications mobiles.

Remarque : Pour les conteneurs mobiles, un conteneur par défaut est utilisé pour définir les configurations de balises initiales jusqu'à ce qu'un conteneur soit téléchargé pour la première fois. Une fois que l'application s'est connectée à Internet et a téléchargé un conteneur, elle n'utilisera plus jamais le conteneur par défaut. Les applications recherchent régulièrement des mises à jour de conteneurs, généralement toutes les 12 heures.

Étapes suivantes

Consultez Configuration avancée.