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 à reconstruire et renvoyer les binaires de l'application aux places de marché d'applications. Les développeurs qui utilisez le SDK Google Analytics pour Firebase afin d'ajouter facilement Tag Manager gérer et modifier l'implémentation, même une fois que l'application a expédiés.
Les développeurs peuvent enregistrer les événements importants et décider ultérieurement des balises ou des pixels à utiliser. être déclenchés.
Prérequis
Avant de commencer:
- Dans la console Firebase, ajoutez votre application à votre projet Firebase.
- configurer Google Analytics pour votre application, y compris l'activer. 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 dans votre application Android.
1. Ajouter Google Tag Manager à votre projet
Dans le fichier Gradle de votre module (généralement
app/build.gradle
), ajoutez ce qui suit : à la bibliothèque Tag Manager:dependencies { // ... compile 'com.google.android.gms:play-services-tagmanager:18.1.0' }
Connectez-vous à votre compte Tag Manager.
Sélectionnez un conteneur pour mobile.
Cliquez sur Versions dans la barre de navigation supérieure.
Cliquez sur la version du conteneur que vous souhaitez utiliser.
Cliquez sur Télécharger.
S'il n'existe pas, créez le dossier
app/src/main/assets/containers
. Copier le conteneur téléchargé vers le dossier.
2. Événements de journaux et variables
Tag Manager utilise les événements, paramètres et propriétés utilisateur enregistrés par SDK Analytics pour Firebase afin de déclencher et de créer les balises que vous avez configurées Google Tag Manager.
Pour savoir comment procéder, consultez la documentation destinée aux développeurs Firebase. enregistrer les événements et définir les propriétés utilisateur.
Configurer les variables dans Tag Manager
Capturer la valeur des paramètres d'événement et des propriétés utilisateur afin de les utiliser dans Google Dans Tag Manager, vous pouvez configurer les 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ètres d'événement dans Tag Manager en tant que
pour capturer les valeurs image_name
et full_text parameter
:
- Nom de la variable: nom de l'image
- 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: texte intégral
- 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 la balise Google
Manager pour capturer la valeur favorite_food
:
- Nom de la variable: Plat préféré
- 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 SDK Google Analytics pour Firebase. La modification d'événements vous permet d'ajouter, de supprimer ou modifier les valeurs des paramètres des événements ou ajuster les noms des événements sans mettre à jour l'application. Les événements qui ne sont pas bloqués seront consignés par Google Analytics pour Firebase SDK.
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 les événements collectés automatiquement dans Tag Manager sans avoir à ajouter de code. Toutefois, vous ne pouvez pas les bloquer.
3. Envoyer des événements
Variables de nom d'événement Firebase, variables de paramètre d'événement Firebase et autres Les variables servent à configurer des déclencheurs. Les conditions de déclenchement sont évaluées chaque fois que vous enregistrez un événement Firebase. Par défaut, Google Analytics pour Firebase se déclenchent automatiquement. Vous pouvez ajouter un compte Google Analytics pour Firebase dans Tag Manager pour 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 pouvez la prévisualiser pour s'assurer qu'elle fonctionne comme prévu. Google Tag Manager vous permet de prévisualiser de votre conteneur en générant des liens et des codes QR dans l'interface Web et les utiliser pour ouvrir votre application. Vous pouvez également activer une 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 Google Tag Manager de l'interface Web en sélectionnant la version du conteneur que vous souhaitez prévisualiser, puis sélectionnez Prévisualiser. Enregistrez cette URL d'aperçu pour les étapes ultérieures.
<ph type="x-smartling-placeholder">![Les URL d'aperçu sont disponibles dans la fenêtre d'aperçu du tag.
Interface Web du gestionnaire](https://google-developers.gonglchuangl.net/static/tag-platform/tag-manager/images/preview_example.png?authuser=0&hl=fr)
Pour prévisualiser votre conteneur (si vous utilisez Android Studio, passez à l'étape 3):
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>
Modifiez cette ligne pour inclure le nom du package de votre application:
<data android:scheme="tagmanager.c.com.example.app"/>
Dans l'interface Web de Google Tag Manager, générez un lien d'aperçu:
- Connectez-vous à votre compte Tag Manager.
- Sélectionnez un conteneur pour mobile.
- Cliquez sur Versions dans la barre de navigation supérieure.
- Cliquez sur Actions > Aperçu sur la version du conteneur que vous souhaitez un aperçu.
- Saisissez le nom de package de votre application.
- Cliquez sur Générer un lien de début d'aperçu.
Arrêtez votre application et utilisez le lien d'aperçu ou le code QR généré pour lancer votre application.
Vous pouvez quitter le mode Aperçu en cliquant sur un lien généré par l'option Générer un lien d'aperçu final dans l'interface Web ;
Conteneur de débogage
Pour résoudre les problèmes d'implémentation de votre 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 la publier. Une fois votre conteneur publié, vos configurations de balises seront disponibles pour les utilisateurs d'applications mobiles.
Étapes suivantes
Consultez la section Configuration avancée.