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 à reconstruire ni à renvoyer les binaires d'application aux plates-formes de téléchargement d'applications. Les développeurs qui travaillent avec le SDK Google Analytics for Firebase peuvent facilement ajouter Tag Manager pour gérer et modifier l'implémentation, même après la publication de l'application.

Les développeurs peuvent consigner les événements importants et décider ultérieurement des balises ou pixels à déclencher.

Prérequis

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 les dépendances Tag Manager dans votre projet :

      $ pod install

    Swift Package Manager

    Pour ajouter Tag Manager via Swift Package Manager :

    1. Si vous migrez depuis 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, 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 Build Settings (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 CONTENEUR, cliquez sur l'icône "+" pour créer un conteneur.
    5. Saisissez un nom pour le conteneur.
    6. Sélectionnez le 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 en haut.
    4. Sélectionnez la version du conteneur que vous souhaitez télécharger.

    5. Cliquez sur Télécharger.

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

    1. Copiez le fichier téléchargé dans un dossier nommé container dans 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 dossiers 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 for Firebase pour déclencher et créer les balises que vous avez configurées dans Google Tag Manager.

Consultez la documentation Firebase pour les développeurs afin de savoir comment enregistrer des événements et définir des 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 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 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 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 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 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 mettre à jour l'application. Les événements qui ne sont pas bloqués seront enregistrés par le SDK Google Analytics for Firebase.

Le SDK Google Analytics pour Firebase enregistre également automatiquement certains événements et propriétés utilisateur. Vous pouvez utiliser les événements et les propriétés 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, de paramètre d'événement Firebase et d'autres variables sont utilisées pour configurer des déclencheurs. Les conditions de déclenchement sont évaluées chaque fois que vous enregistrez un événement Firebase. Par défaut, les événements Google Analytics pour Firebase se déclenchent automatiquement. Il est possible d'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 devez la prévisualiser 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 Tag Manager, puis en les utilisant pour ouvrir votre application.

Conteneur d'aperçu

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

  1. Connectez-vous à votre compte Tag Manager.
  2. Sélectionnez un conteneur mobile.
  3. Cliquez sur Versions dans la barre de navigation en haut.
  4. Cliquez sur Actions > Aperçu sur la version du conteneur que vous souhaitez prévisualiser.
  5. Saisissez le nom du package de votre application.

  6. Cliquez sur Générer un lien de début d'aperçu.

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

    Figure 1  : Obtenir une URL d'aperçu à partir de l'interface Web 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 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 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 du tag manager dans le fichier de liste de propriétés de votre application.
Figure 2  : Ajoutez le schéma d'URL de prévisualisation Tag Manager au fichier de liste de propriétés de votre application.

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

Publier un conteneur

Une fois que vous avez prévisualisé votre conteneur et vérifié qu'il fonctionne, vous pouvez le publier. Une fois votre conteneur publié, les configurations de vos balises seront disponibles pour les utilisateurs de l'application mobile.

Consultez Configuration avancée.