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 à recompiler et renvoyer les fichiers binaires de l'application aux places de marché d'applications. Les développeurs qui utilisent le SDK Google Analytics pour Firebase peuvent facilement ajouter Tag Manager afin de gérer et de modifier l'implémentation, même après l'expédition de l'application.
Les développeurs peuvent enregistrer des événements importants et décider ultérieurement des balises ou des pixels à déclencher.
Conditions préalables
- 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 Tag Manager.
Les sections suivantes vous expliquent comment configurer et utiliser Google Tag Manager dans votre application iOS.
1. Ajouter Tag Manager à votre projet
Ajoutez le package Tag Manager:
CocoaPods
Pour ajouter Tag Manager via CocoaPods:
Dans un terminal, exécutez la commande suivante:
$ sudo gem install cocoapods
Accédez au répertoire de votre projet.
Exécutez la commande suivante pour créer un fichier nommé
Podfile
:$ pod init
Dans
Podfile
, ajoutez le code suivant :pod 'GoogleTagManager', '~> 6.0'
Exécutez la commande suivante pour télécharger et installer les dépendances Tag Manager dans votre projet:
$ pod install
Gestionnaire de packages Swift
Pour ajouter Tag Manager via Swift Package Manager, procédez comme suit:
- Si vous effectuez une migration depuis un projet basé sur CocoaPods, exécutez
pod deintegrate
pour supprimer CocoaPods de votre projet Xcode. Par la suite, le fichier.xcworkspace
généré par CocoaPods peut être supprimé en toute sécurité. Si vous ajoutez Firebase à un projet pour la première fois, vous pouvez ignorer cette étape. - Dans Xcode 12, installez la bibliothèque Tag Manager en accédant à Fichier > Packages Tag Manager > Ajouter une dépendance de package.
Dans l'invite qui s'affiche, saisissez le dépôt GitHub Tag Manager:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
Sélectionnez la version de Tag Manager que vous souhaitez utiliser. Pour les nouveaux projets, nous vous recommandons d'utiliser la dernière version de Tag Manager.
Ajoutez
-ObjC
à Other Linker Flags (Autres indicateurs Linker) dans les paramètres de compilation de votre projet.
Si votre compte Tag Manager n'en possède pas, créez un conteneur iOS:
- Connectez-vous à votre compte Tag Manager.
- Cliquez sur ADMINISTRATION dans la barre de navigation supérieure.
- Dans la colonne CONTAINER, cliquez sur le menu déroulant et sélectionnez CONTAINER.
- Saisissez un nom pour le conteneur.
- Sélectionnez le conteneur iOS.
- Sélectionnez SDK Firebase (iOS).
- Cliquez sur CRÉER.
Téléchargez votre conteneur:
- Connectez-vous à votre compte Tag Manager.
- Sélectionnez votre conteneur iOS.
- Cliquez sur Versions dans la barre de navigation supérieure.
Cliquez sur Actions > Télécharger sur la version du conteneur sélectionnée.
Ajoutez le conteneur téléchargé à votre projet:
- Copiez le fichier téléchargé dans un dossier nommé
container
à la racine du projet XCode (généralementPROJECT_ROOT/container/GTM-XXXXXX.json
). - Ouvrez Xcode.
- Dans le menu Fichier, sélectionnez Ajouter des fichiers à.
- Sélectionnez le dossier
container
. - Cliquez sur Options et assurez-vous que l'option Créer des références de dossier est sélectionnée.
- Cliquez sur Terminer.
- Copiez le fichier téléchargé dans un dossier nommé
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 afin de 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 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 consigner l'événement personnalisé suivant dans votre application:
Analytics.logEvent("share_image", parameters: [
"image_name": name,
"full_text": text
])
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: 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 complet
- 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:
Analytics.setUserProperty(food, forName: "favorite_food")
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: aliment favori
- 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 consignés par le SDK Google Analytics pour Firebase. Modifier des événements vous permet d'ajouter, de supprimer ou de modifier les valeurs des paramètres d'événement, ou d'ajuster les noms d'événements sans mettre à jour l'application. Les événements qui ne sont pas bloqués seront consigné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 des propriétés et des é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ètre d'événement Firebase et d'autres variables permettent de configurer des déclencheurs. Les conditions de déclenchement sont évaluées chaque fois que vous consignez 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 pouvez le prévisualiser pour vous assurer qu'il fonctionne comme prévu. 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 de Tag Manager, et en les utilisant pour ouvrir votre application.
Prévisualiser un conteneur
Pour prévisualiser un conteneur, générez une URL d'aperçu dans l'interface Web de Tag Manager:
- 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 > Prévisualiser sur la version du conteneur que vous souhaitez prévisualiser.
- Saisissez le nom de package de votre application.
Cliquez sur Générer un lien d'aperçu de début.
Enregistrez cette URL d'aperçu pour les étapes suivantes.
Pour activer les aperçus de conteneurs, vous devez définir le schéma d'URL d'aperçu Tag Manager dans la liste des propriétés de votre projet. Sous Types d'URL du fichier de liste de propriétés de votre application, enregistrez l'identifiant d'URL et le schéma d'URL suivants:
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
Arrêtez votre application et ouvrez l'URL d'aperçu sur un émulateur ou un appareil physique pour prévisualiser le brouillon de conteneur de votre application.
Conteneur de débogage
Lorsque vous exécutez votre application dans un simulateur ou en mode Aperçu, Tag Manager active automatiquement la journalisation détaillée.
Conteneur de publication
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 de l'application mobile.
Ressources associées
Lisez Configuration avancée.