Merci d'avoir consulté la documentation sur la nouvelle plate-forme de balises de Google. Ce site est en version bêta publique. (Commentaires)

Google Tag Manager pour Android

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

En tant que développeur, vous pouvez utiliser Google Tag Manager pour implémenter et gérer des balises de mesure et des pixels dans vos applications mobiles, sans avoir à recréer et à renvoyer des binaires sur les places de marché d'applications. Les développeurs qui utilisent le SDK Google Analytics pour Firebase peuvent facilement ajouter Tag Manager pour faciliter la gestion et la modification de la mise en œuvre, même après l'expédition de l'application.

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

Conditions préalables

Avant de commencer:

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.0.2'
    }
    
  2. Connectez-vous à votre compte Tag Manager.

  3. Sélectionnez un conteneur mobile.

  4. Cliquez sur Versions dans la barre de navigation supérieure.

  5. Cliquez sur Actions > Télécharger pour la version du conteneur sélectionnée.

    télécharger un conteneur

  6. S'il n'existe pas, créez le dossier app/src/main/assets/containers. Copiez le conteneur téléchargé dans le dossier.

2. Consigner 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 pour déclencher et créer les balises que vous avez configurées dans Google Tag Manager.

Consultez la documentation destinée aux développeurs Firebase pour savoir comment enregistrer des événements et définir les propriétés utilisateur.

Configurer les variables dans Tag Manager

Pour capturer la valeur des paramètres d'événements 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 consigner 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);

Ensuite, vous pouvez configurer de nouvelles variables de paramètres d'événement dans Tag Manager comme suit pour capturer les valeurs image_name et full_text parameter:

  • Nom de la variable: Nom de l'image
  • Type de variable : "Event Parameter"
  • Event Parameter Key Name (Nom de la clé du paramètre d'événement) : image_name

et :

  • Nom de la variable : texte intégral
  • Type de variable : "Event Parameter"
  • Event Parameter Key Name (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 : Aliments favoris
  • Type de variable: propriété utilisateur Firebase
  • Event Parameter Key Name (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. Modifier 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 propriétés et événements collectés automatiquement dans Tag Manager sans 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ètres d'événement Firebase et d'autres variables servent à configurer les 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 de bloquer 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ée pour déboguer tout comportement inattendu.

Prévisualiser le conteneur

Avant de prévisualiser un conteneur, générez une URL d'aperçu dans l'interface Web de Google Tag Manager. Pour ce faire, sélectionnez la version du conteneur que vous souhaitez prévisualiser, puis cliquez sur Aperçu. Enregistrez cette URL d'aperçu pour plus tard.

Les URL d'aperçu sont disponibles dans la fenêtre d'aperçu de l'interface Web de Tag Manager
Figure 1 : Obtenez une URL d'aperçu à partir de l'interface Web de 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 du package de votre application:

    <data android:scheme="tagmanager.c.com.example.app"/>
    
  3. Dans l'interface Web de 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 supérieure.
    4. Cliquez sur Actions > Aperçu sur la version du conteneur que vous souhaitez prévisualiser.
    5. Saisissez le nom de package de votre application.
    6. Cliquez sur Générer le lien d'aperçu.
  4. Arrêtez votre application et utilisez le lien d'aperçu généré ou le code QR pour la lancer.

  5. Pour quitter le mode Aperçu, cliquez sur un lien généré par l'option Générer le lien d'aperçu dans l'interface Web.

Conteneur de débogage

Pour résoudre les problèmes d'implémentation du conteneur, activez la journalisation détaillée:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Publier le conteneur

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

Étapes suivantes

Consultez Configuration avancée.