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
- 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 Tag Manager.
Les sections suivantes vous expliquent comment configurer et utiliser 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 les éléments suivants :pod 'GoogleTagManager', '~> 6.0'
Exécutez la commande suivante pour télécharger et installer Tag Manager les dépendances à votre projet:
$ pod install
Gestionnaire de paquets Swift
Pour ajouter Tag Manager via le gestionnaire de packages Swift:
- Si vous effectuez une migration depuis un projet basé sur CocoaPods, exécutez
pod deintegrate
pour supprimez CocoaPods de votre projet Xcode. Les pods générés par CocoaPods.xcworkspace
fichier peut être supprimé en toute sécurité par la suite. 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 code GitHub de Tag Manager dépôt:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
Sélectionnez la version de Tag Manager que vous souhaitez utiliser. Neuf nous vous recommandons d'utiliser la dernière version de Tag Manager.
Ajoutez
-ObjC
à Other Linker Flags dans les paramètres de compilation de votre projet.
Créez un conteneur iOS si votre compte Tag Manager n'en possède pas:
- Connectez-vous à votre compte Tag Manager.
- Dans l'onglet Comptes, sélectionnez votre conteneur iOS.
- Cliquez sur Admin dans la barre de navigation supérieure.
- Dans la colonne CONTENEUR, cliquez sur le signe "+" pour créer un conteneur.
- Saisissez un nom pour le conteneur.
- Sélectionnez un conteneur iOS.
- Cliquez sur Créer.
Téléchargez votre conteneur:
- Connectez-vous à votre compte Tag Manager.
- Dans l'onglet Comptes, sélectionnez votre conteneur iOS.
- Cliquez sur Versions dans la barre de navigation supérieure.
- Sélectionnez la version du conteneur que vous souhaitez télécharger.
Cliquez sur Télécharger.
Ajoutez le conteneur téléchargé à votre projet:
- Copiez le fichier téléchargé dans le dossier XCode, nommé
container
. racine du projet (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 Créer des références de dossier est sélectionnée.
- Cliquez sur Terminer.
- Copiez le fichier téléchargé dans le dossier XCode, nommé
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 des 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:
Analytics.logEvent("share_image", parameters: [
"image_name": name,
"full_text": text
])
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:
Analytics.setUserProperty(food, forName: "favorite_food")
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. Tag Manager vous permet de prévisualiser les versions en générant des liens et des codes QR dans l'interface Web de Tag Manager, les utiliser pour ouvrir votre application.
Prévisualiser le conteneur
Pour prévisualiser un conteneur, générez une URL d'aperçu dans le site Web de Tag Manager interface:
- 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 prévisualiser.
- Saisissez le nom de package de votre application.
Cliquez sur Générer un lien de début d'aperçu.
Figure 1 : Obtenir une URL d'aperçu à partir du à l'interface Web de Tag Manager. Enregistrez cette URL d'aperçu pour les étapes ultérieures.
Pour activer les aperçus de conteneurs, vous devez définir le schéma d'URL d'aperçu Tag Manager dans la liste de propriétés de votre projet. Sous Types d'URL de la page liste de propriétés, enregistrez l'identifiant d'URL et le schéma d'URL suivants:
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
![Enregistrez le schéma d'URL d'aperçu Tag Manager dans le fichier
liste de propriétés.](https://developers.google.cn/static/tag-platform/tag-manager/images/plist.png?authuser=0000&hl=fr)
Arrêtez votre application et ouvrez l'URL d'aperçu sur un émulateur ou un appareil physique. pour prévisualiser le brouillon du conteneur dans votre application.
Conteneur de débogage
Lorsque vous exécutez votre application dans un simulateur ou en mode Aperçu, Tag Manager transforme automatiquement la journalisation en verbosité.
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.
Ressources associées
Consultez la section Configuration avancée.