Cette page a été traduite par l'API Cloud Translation.

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 à 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:
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 Tag Manager les dépendances à votre projet:
  $ pod install
Gestionnaire de paquets Swift
Pour ajouter Tag Manager via le gestionnaire de packages Swift:
1. 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.
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 code GitHub de Tag Manager dépôt:
  https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
4. Sélectionnez la version de Tag Manager que vous souhaitez utiliser. Neuf 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.
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 le signe "+" pour créer un conteneur.
5. Saisissez un nom pour le conteneur.
6. Sélectionnez un conteneur iOS.
7. Cliquez sur Créer.
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 Télécharger.
  
  Remarque :Le nom du fichier téléchargé est l'ID du conteneur avec un .json .
Ajoutez le conteneur téléchargé à votre projet:
1. Copiez le fichier téléchargé dans le dossier XCode, nommé container. racine du projet (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 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, 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. — **Figure 2** : Ajouter 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 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.