Google Tag Manager pour iOS

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 à recompiler et à renvoyer les 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 pour gérer et modifier l'implémentation, même après l'expédition de l'application.

Les développeurs peuvent enregistrer les événements importants et décider ultérieurement quelles balises ou quels pixels doivent être déclenchés.

Conditions préalables

• Dans la console Firebase, ajoutez votre application à votre projet Firebase.
• Configurez Google Analytics pour votre application, 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

1. Ajoutez le package Tag Manager:

   CocoaPods

   Pour ajouter Tag Manager via CocoaPods:

   1. Dans un terminal, exécutez la commande suivante:

      $ sudo gem install cocoapods
      

   2. Accédez au répertoire de votre projet.

   3. Exécutez la commande suivante pour créer un fichier nommé Podfile:

      $ pod init
      

   4. Dans Podfile, ajoutez les éléments suivants :

      pod 'GoogleTagManager', '~> 6.0'
      

   5. Exécutez la commande suivante pour télécharger et installer des dépendances Tag Manager dans votre projet:

      $ pod install
      

   Gestionnaire de paquets Swift

   Pour ajouter Tag Manager via le gestionnaire de packages Swift:

   1. Si vous effectuez une migration à partir d'un projet basé sur CocoaPods, exécutez pod deintegrate pour supprimer CocoaPods de votre projet Xcode. Le fichier .xcworkspace généré par CocoaPods 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.
   2. Dans Xcode 12, installez la bibliothèque Tag Manager en accédant à File > Tag Manager Packages > Add Package Dependency... (Fichier > Packages Tag Manager > Ajouter une dépendance de package...)

   3. Dans l'invite qui s'affiche, accédez au dépôt GitHub Tag Manager:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      

   4. 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.

   5. Ajoutez -ObjC à Other Linker Flags dans les paramètres de compilation de votre projet.

2. Créez un conteneur iOS si votre compte Tag Manager n'en possède pas:

   1. Connectez-vous à votre compte Tag Manager.
   2. Dans l'onglet Comptes, sélectionnez votre conteneur iOS.
   3. Cliquez sur Admin dans la barre de navigation supérieure.
   4. Dans la colonne CONTAINER, cliquez sur l'icône "+" pour créer un conteneur.
   5. Saisissez un nom pour le conteneur.
   6. Sélectionnez un conteneur iOS.
   7. Cliquez sur Créer.

3. Téléchargez votre conteneur:

   1. Connectez-vous à votre compte Tag Manager.
   2. Dans l'onglet Comptes, sélectionnez votre conteneur iOS.
   3. Cliquez sur Versions dans la barre de navigation supérieure.
   4. Sélectionnez la version du conteneur que vous souhaitez télécharger.

   5. Cliquez sur Download (Télécharger).

      Remarque :Le nom du fichier téléchargé est l'ID du conteneur avec une extension .json.

4. Ajoutez le conteneur téléchargé à votre projet:

   1. Copiez le fichier téléchargé dans un dossier nommé container, à la racine du projet XCode (généralement PROJECT_ROOT/container/GTM-XXXXXX.json).
   2. Ouvrez Xcode.
   3. Dans le menu Fichier, sélectionnez Ajouter des fichiers à.
   4. Sélectionnez le dossier container.
   5. Cliquez sur Options et assurez-vous que l'option Créer des références de dossier est sélectionnée.
   6. Cliquez sur Terminer.

2. Événements de journaux et 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 des balises que vous avez configurées dans Google Tag Manager.

Lisez 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 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è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 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")

Ensuite, vous pouvez configurer une nouvelle variable de propriété utilisateur Firebase dans Google Tag 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 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 les mises à jour d'application. Les événements qui ne sont pas bloqués sont 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 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

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 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, prévisualisez-la pour vous assurer qu'elle 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, puis en les utilisant pour ouvrir votre application.

Prévisualiser le conteneur

Pour prévisualiser un conteneur, générez une URL d'aperçu dans l'interface Web de Tag Manager:

1. Connectez-vous à votre compte Tag Manager.
2. Sélectionnez un conteneur pour mobile.
3. Cliquez sur Versions dans la barre de navigation supérieure.
4. Cliquez sur Actions > Prévisualiser 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 un lien de début d'aperçu.

   

   Figure 1 : Obtenir une URL d'aperçu à partir de 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 dans le 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_

Figure 2 : Ajoutez le schéma d'URL d'aperçu Tag Manager au fichier de liste de propriétés de votre application.

Remarque :your.package.name doit correspondre au nom de l'application utilisée pour générer l'URL d'aperçu (voir la figure 1).

Arrêtez votre application et ouvrez l'URL d'aperçu sur un émulateur ou un appareil physique pour prévisualiser le conteneur de brouillon 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 mode détaillé.

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é, les configurations de balises deviennent disponibles pour les utilisateurs d'applications mobiles.

Remarque :Pour les conteneurs pour mobile, un conteneur par défaut est utilisé afin de définir les configurations initiales des balises jusqu'au premier téléchargement d'un conteneur. Une fois que l'application s'est connectée à Internet et a téléchargé un conteneur, elle n'utilise plus jamais le conteneur par défaut. Les applications vérifient régulièrement les mises à jour des conteneurs, généralement toutes les 12 heures.

Ressources associées

Consultez la section Configuration avancée.