Google Tag Manager pour iOS

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

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 le code suivant :

      pod 'GoogleTagManager', '~> 6.0'
      
    5. 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:

    1. 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.
    2. Dans Xcode 12, installez la bibliothèque Tag Manager en accédant à Fichier > Packages Tag Manager > Ajouter une dépendance de package.
    3. Dans l'invite qui s'affiche, saisissez le 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 (Autres indicateurs Linker) dans les paramètres de compilation de votre projet.

  2. Si votre compte Tag Manager n'en possède pas, créez un conteneur iOS:

    1. Connectez-vous à votre compte Tag Manager.
    2. Cliquez sur ADMINISTRATION dans la barre de navigation supérieure.
    3. Dans la colonne CONTAINER, cliquez sur le menu déroulant et sélectionnez CONTAINER.
    4. Saisissez un nom pour le conteneur.
    5. Sélectionnez le conteneur iOS.
    6. Sélectionnez SDK Firebase (iOS).
    7. Cliquez sur CRÉER.
  3. Téléchargez votre conteneur:

    1. Connectez-vous à votre compte Tag Manager.
    2. Sélectionnez votre conteneur iOS.
    3. Cliquez sur Versions dans la barre de navigation supérieure.
    4. Cliquez sur Actions > Télécharger sur la version du conteneur sélectionnée.

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

  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 d'aperçu de début.

    Les URL d'aperçu sont disponibles dans la fenêtre d'aperçu de l'interface Web de Tag Manager

    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 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_
Enregistrez le schéma d'URL d'aperçu de Tag Manager dans le fichier de liste de propriétés de votre application.
Figure 2 : Ajoutez le schéma d'URL d'aperçu Tag Manager au fichier de liste de propriétés de votre application.

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.

Lisez Configuration avancée.