Taggage côté serveur pour les applications mobiles

Vous pouvez configurer vos applications mobiles à l'aide du SDK Google Analytics pour Firebase pour qu'elles fonctionnent avec le taggage côté serveur dans Google Tag Manager.

Le taggage côté serveur vous permet de mettre en scène, de masquer et d'enrichir vos données avant de les transmettre aux produits de destination tels que Google Analytics. En savoir plus sur le taggage côté serveur

Pour configurer le taggage côté serveur pour les applications mobiles:

1. Préparer votre application au taggage côté serveur
2. Configurer votre conteneur serveur pour prendre en charge le trafic mobile
3. Activer le taggage côté serveur dans votre propriété GA4

Prérequis

• Vous devez inclure le SDK Google Analytics pour Firebase dans votre application et l'associer à votre propriété Google Analytics 4. En savoir plus sur le SDK Google Analytics pour Firebase
• Vous avez besoin d'un compte Google Tag Manager et d'un conteneur serveur. Si vous n'en avez pas, créez un compte et un conteneur Tag Manager.
• Vous devez configurer un serveur d'ajout de balises.

Étape 1: Préparez votre application au taggage côté serveur

iOS

1. Activez la fonctionnalité d'importation du taggage côté serveur et configurez le schéma d'URL personnalisé pour le mode débogage du taggage côté serveur dans le fichier Info.plist. Remplacez BUNDLE_ID dans ce qui suit par l'identifiant du groupe de l'application.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. Pour activer le mode débogage ou d'aperçu, ajoutez un appel à Analytics.handleOpen(_:) dans une méthode de cycle de vie pour transmettre l'URL de lancement.

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   Aucune action n'est requise pour les applications qui n'utilisent pas SwiftUI ni UIScene. Le SDK reçoit l'URL de lancement de ApplicationDidFinishLaunchingNotification.

Android

1. Installez la dernière version du SDK Google Analytics pour Firebase.

2. Activez sGTM en ajoutant les éléments suivants au fichier AndroidManifest.xml de l'application.

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

Étape 2: Configurez votre conteneur serveur pour prendre en charge le trafic mobile

La section suivante suppose que vous disposez d'un déploiement de taggage côté serveur existant et que vous connaissez ses concepts. Si vous ne connaissez pas le taggage côté serveur, vous pouvez suivre le cours sur les principes de base du taggage côté serveur.

Configurer le client Google Analytics (application) GA4

Un client est un type de ressource Tag Manager qui intercepte certains types de requêtes entrantes et génère des événements pouvant être transmis à une destination, comme Google Analytics 4. Dans ce cas, la requête HTTP est un événement Google Analytics 4. Vous devez donc configurer le client Google Analytics: GA4 (application) intégré. Vous n'avez besoin que d'un seul client GA4 par source de données, comme le SDK GA et le site Web. En savoir plus sur le fonctionnement des clients

1. Dans votre conteneur serveur, accédez à Clients, puis cliquez sur Nouveau.

2. Cliquez sur Configuration client, puis sélectionnez Google Analytics: GA4 (application).

   

3. Attribuez un nom à votre client, puis cliquez sur Enregistrer.

Configurer votre balise Google Analytics: GA4

Pour envoyer des données à Google Analytics, vous devez créer une balise Google Analytics: GA4 dans le conteneur serveur. Le client analyse la requête HTTP entrante dans un objet de données d'événement. La balise prendra cet objet de données d'événement, le mappera au format approprié, puis l'enverra à Google Analytics 4.

1. Dans votre conteneur de serveur, accédez à Tags (Balises), puis cliquez sur Nouveau.

2. Cliquez sur Configuration de la balise, puis sélectionnez Google Analytics: GA4.

   

Par défaut, la balise hérite de tous les champs et paramètres pertinents de l'objet de données d'événement créé par le client:

• Si la requête Google Analytics 4 entrante passe par le client Google Analytics: GA4 (application), la balise hérite de l'ID de l'application et des paramètres d'événement.
• Si les requêtes Google Analytics 4 entrantes passent par le client Google Analytics: GA4 (Web), la balise hérite de l'ID de mesure et des paramètres d'événement.

Conseil :Vous pouvez éventuellement utiliser des transformations pour inclure, exclure ou modifier la sortie des paramètres d'événement de votre client avant qu'ils ne soient exposés aux balises. Les transformations vous permettent de protéger les informations sensibles et de contrôler précisément les paramètres d'événement disponibles pour un traitement ultérieur.

Configurer des déclencheurs pour le trafic mobile

Vous devez ensuite déterminer quand la balise GA4 doit se déclencher. Le client Google Analytics : GA4 (application) analyse la requête entrante dans un objet de données d'événement, et la balise hérite de ses valeurs. Par conséquent, il est généralement préférable que la balise se déclenche chaque fois que le client GA4 revendique la requête.

Pour configurer les déclencheurs:

1. Dans les paramètres de la balise, cliquez sur Déclenchement.
2. Pour créer un déclencheur, cliquez sur l'icône + en haut à droite.
3. Cliquez sur Configuration du déclencheur pour choisir le type de déclencheur.

4. Sélectionnez Événement personnalisé ou Événement personnalisé dans la liste.

   • Par défaut, le type Déclencheur personnalisé déclenche la balise lorsqu'un événement est généré par un client côté serveur.
   • Le type de déclencheur Événement personnalisé peut être utilisé pour déclencher la balise sur un nom d'événement spécifique ou sur un événement correspondant à un modèle d'expression régulière.

5. Pour activer la liste des conditions d'activation de ce déclencheur (par exemple, pour qu'il ne s'active que sur les données d'événements Web ou mobiles), sélectionnez Certains événements.

   1. L'option Nom de l'événement est présélectionnée. Cliquez sur ce sélecteur, puis sélectionnez Choisir une variable intégrée dans la liste.
   2. Pour renvoyer automatiquement le nom du client qui a généré l'événement, sélectionnez Nom du client.

   3. Utilisez le nom du client que vous avez configuré précédemment pour définir la condition en conséquence. Votre déclencheur doit se présenter comme suit:

      

      Remarque :Le nom du client est celui que vous avez spécifié à l'étape précédente. Le type de client est Google Analytics: GA4 (application). La variable "Nom du client" renvoie le nom et non le type du client.

6. Enregistrez le déclencheur et saisissez un nom descriptif. Par exemple, vous pouvez utiliser "Tous les événements d'application GA4".

7. Vous devriez à présent revenir dans les paramètres de la balise, avec le nouveau déclencheur à la place. Enregistrez la balise et saisissez un nom descriptif, par exemple "GA4". Votre balise doit se présenter comme suit:

   

Conseil :Pour empêcher l'envoi de certains événements, vous pouvez choisir d'utiliser des déclencheurs personnalisés avec une logique conditionnelle basée sur le nom de l'événement (ou une autre variable) ou d'ajouter des exceptions de déclencheur. En savoir plus sur le déclenchement de déclencheurs et d'exceptions de déclencheur

Prévisualiser votre conteneur

Vous pouvez utiliser Google Tag Manager pour prévisualiser et déboguer votre conteneur serveur avant de publier les modifications. Notez que la prévisualisation ne fonctionnera pas tant que vous n'avez pas activé le taggage côté serveur dans votre propriété GA4.

Pour que les requêtes de votre application déclenchent la configuration Preview, vous devez:

1. Sélectionnez Aperçu dans votre conteneur de serveur Google Tag Manager.
2. Cliquez sur l'icône Autres actions ⋮ en haut à droite, puis sélectionnez Envoyer des requêtes à partir d'une application.

3. Saisissez votre ID d'application, puis cliquez sur Générer un code QR.

   

4. Scannez le code QR avec l'application Appareil photo de votre téléphone. Interagissez avec votre application comme vous le feriez normalement pour générer des événements d'aperçu.

5. Cliquez sur OK pour fermer la boîte de dialogue.

Publier votre conteneur

Une fois que vous avez vérifié vos modifications, publiez le conteneur pour les appliquer à tout le trafic. En savoir plus sur la publication, les versions et les approbations

Étape 3: Activez le taggage côté serveur dans votre propriété GA4

1. Dans votre propriété Google Analytics 4, accédez à Administration.
2. Ouvrez Flux de données.

3. Sélectionnez la configuration de flux de votre application dans l'onglet iOS ou Android.

   

4. Cliquez sur Configurer les paramètres du SDK, puis sur Configurer Tag Manager côté serveur.

   

5. Pour permettre au SDK d'envoyer des données de mesure à l'URL du conteneur de serveur:

   1. Activez l'option Envoyer des données à un conteneur Tag Manager côté serveur.
   2. Copiez l'URL du conteneur de serveur. Vous pouvez trouver cette information dans Google Tag Manager en accédant à Admin > Paramètres du conteneur > URL du conteneur serveur.

   3. Sélectionnez le pourcentage de trafic que vous souhaitez acheminer vers le conteneur serveur. Vous pouvez choisir une option inférieure à 100% pour valider la configuration de votre serveur avant d'utiliser le taggage côté serveur pour l'ensemble de votre trafic.

      Remarque :Utilisez l'option "Debug devices only" (Déboguer uniquement les appareils) pour n'autoriser que les applications ouvertes à l'aide du mode Aperçu à envoyer des données à votre serveur.

   

6. Cliquez sur Enregistrer. Le SDK récupère l'URL du conteneur serveur mise à jour et y dirige les données de mesure.

Limites connues

• Pour les applications Android:

  • Pour éviter les failles de sécurité potentielles impliquant les conteneurs de serveurs et les services Google Play, les événements passent par un serveur proxy sans état entre le SDK et votre conteneur de serveur. Ce proxy validera la source et le point de terminaison de la requête, mais n'inspectera ni ne stockera de données sur les événements. Conformément à la manière dont GA4 collecte les données des appareils situés dans l'UE, le proxy se trouve dans l'UE pour le trafic situé dans l'UE.
  • Les achats via une application enregistrés automatiquement reposent sur l'intégration avec le backend de Google Play et ne sont pas envoyés au conteneur serveur.
  • L'événement app_remove ne sera pas enregistré sur Android.

• Vous devez toujours associer vos flux de données d'application dans Google Analytics à votre compte Google Ads pour vous assurer que vos données et conversions SDK sont importées dans Google Ads. Le taggage côté serveur n'offre aucune intégration intrinsèque entre votre SDK et Google Ads.

API

Vous pouvez utiliser l'API REST Tag Manager pour accéder aux données de configuration de Tag Manager. Pour en savoir plus sur l'API:

• Reportez-vous au guide du développeur pour apprendre à utiliser l'API.
• Consultez la documentation de référence de l'API Tag Manager pour vous familiariser avec les ressources et les opérations disponibles dans Tag Manager.