Serverseitiges Tagging für mobile Apps

Sie können Ihre mobilen Apps mit dem Google Analytics for Firebase SDK so konfigurieren, dass sie mit dem serverseitigen Tagging in Google Tag Manager funktionieren.

Mit dem serverseitigen Tagging können Sie Ihre Daten vor dem Senden an Zielprodukte wie Google Analytics vorbereiten, entfernen und ergänzen. Weitere Informationen zum serverseitigen Tagging

So richten Sie das serverseitige Tagging für mobile Apps ein:

1. App für serverseitiges Tagging vorbereiten
2. Servercontainer für mobile Zugriffe konfigurieren
3. Serverseitiges Tagging in Ihrer GA4-Property aktivieren

Vorbereitung

• Sie müssen das Google Analytics for Firebase SDK in Ihre App einbinden und mit Ihrer Google Analytics 4-Property verknüpfen. Weitere Informationen zum Google Analytics for Firebase SDK
• Sie benötigen ein Google Tag Manager-Konto und einen Servercontainer. Falls Sie noch keines haben, erstellen Sie ein neues Tag Manager-Konto und einen neuen Container.
• Sie müssen einen Tagging-Server einrichten.

Schritt 1: App für serverseitiges Tagging vorbereiten

iOS

1. Aktiviere die Uploadfunktion für die serverseitige Tag-Kennzeichnung und richte in der Datei Info.plist das benutzerdefinierte URL-Schema für den Debug-Modus der serverseitigen Tag-Kennzeichnung ein. Ersetzen Sie BUNDLE_ID im Folgenden durch die Bundle-ID der App.

   <?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. Wenn Sie den Debug- oder Vorschaumodus aktivieren möchten, fügen Sie in einer Lebenszyklusmethode einen Aufruf von Analytics.handleOpen(_:) ein, um die Start-URL zu übergeben.

   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)
       }
     }
   }
   

   Für Apps, die nicht SwiftUI oder UIScene verwenden, sind keine Maßnahmen erforderlich. Das SDK empfängt die Start-URL von ApplicationDidFinishLaunchingNotification.

Android

1. Installieren Sie die neueste Version des Google Analytics for Firebase SDK.

2. Aktivieren Sie sGTM, indem Sie der Datei AndroidManifest.xml der Anwendung Folgendes hinzufügen:

   <!-- 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" />
   

Schritt 2: Servercontainer für mobile Zugriffe konfigurieren

Im folgenden Abschnitt wird davon ausgegangen, dass Sie eine vorhandene Bereitstellung für das serverseitige Tagging haben und mit den zugehörigen Konzepten vertraut sind. Wenn Sie mit serverseitigem Tagging noch nicht vertraut sind, können Sie den Grundlagenkurs zum serverseitigen Tagging absolvieren.

Google Analytics: GA4 (App)-Client einrichten

Ein Client ist ein Tag Manager-Ressourcentyp, der bestimmte Typen eingehender Anfragen abfängt und Ereignisse generiert, die an ein Ziel wie Google Analytics 4 übergeben werden können. In diesem Fall ist die HTTP-Anfrage ein Google Analytics 4-Ereignis. Daher müssen Sie den integrierten Google Analytics: GA4-Client (App) konfigurieren. Sie benötigen nur einen GA4-Client pro Datenquelle, z. B. GA SDK und Website. Weitere Informationen zur Funktionsweise von Clients

1. Klicken Sie in Ihrem Servercontainer auf Clients und dann auf Neu.

2. Klicken Sie auf Clientkonfiguration und wählen Sie Google Analytics: GA4 (App) aus.

   

3. Geben Sie einen Namen für den Kunden ein und klicken Sie auf Speichern.

Google Analytics: GA4-Tag konfigurieren

Wenn Sie Daten an Google Analytics senden möchten, müssen Sie im Servercontainer ein „Google Analytics: GA4“-Tag erstellen. Der Client parst die eingehende HTTP-Anfrage in ein Ereignisdatenobjekt. Das Tag ordnet dieses Ereignisdatenobjekt dem richtigen Format zu und sendet es dann an Google Analytics 4.

1. Klicken Sie in Ihrem Servercontainer auf Tags und dann auf Neu.

2. Klicken Sie auf Tag-Konfiguration und wählen Sie dann Google Analytics: GA4 aus.

   

Standardmäßig werden dem Tag alle relevanten Felder und Parameter aus dem vom Client erstellten Ereignisdatenobjekt vererbt:

• Wenn die eingehende Google Analytics 4-Anfrage den Client Google Analytics: GA4 (App) passiert, werden die App-ID und die Ereignisparameter an das Tag übergeben.
• Wenn eingehende Google Analytics 4-Anfragen über den Client Google Analytics: GA4 (Web) weitergeleitet werden, übernimmt das Tag die Mess-ID und die Ereignisparameter.

Tipp :Optional können Sie Transformationen verwenden, um die vom Client ausgegebenen Ereignisparameter ein-, auszuschließen oder zu ändern, bevor sie Tags ausgesetzt werden. So haben Sie die Möglichkeit, vertrauliche Informationen zu schützen und genau zu steuern, welche Ereignisparameter für die weitere Verarbeitung verfügbar sind.

Trigger für Zugriffe über Mobilgeräte einrichten

Legen Sie dann fest, wann das GA4-Tag ausgelöst werden soll. Der Google Analytics: GA4 (App)-Client analysiert die eingehende Anfrage in ein Ereignisdatenobjekt und überträgt die Werte an das Tag. Daher sollten Sie das Tag in der Regel immer dann auslösen, wenn der GA4-Client die Anfrage anfordert.

So richten Sie die Trigger ein:

1. Klicken Sie in den Tag-Einstellungen auf Trigger.
2. Klicken Sie rechts oben auf das Symbol +, um einen neuen Trigger zu erstellen.
3. Klicken Sie auf Triggerkonfiguration, um den Triggertyp auszuwählen.

4. Wählen Sie in der Liste Benutzerdefiniert oder Benutzerdefiniertes Ereignis aus.

   • Der Typ Benutzerdefinierter Trigger löst das Tag standardmäßig aus, wenn ein Ereignis von einem serverseitigen Client generiert wird.
   • Mit dem Triggertyp Benutzerdefiniertes Ereignis können Sie das Tag bei einem bestimmten Ereignisnamen oder einem Ereignis auslösen, das einem regulären Ausdruck entspricht.

5. Wählen Sie Einige Ereignisse aus, um die Liste der Aktivierungsbedingungen für diesen Trigger zu aktivieren und beispielsweise nur bei mobilen Ereignisdaten oder Webereignisdaten auszulösen.

   1. Ereignisname ist bereits ausgewählt. Klicken Sie auf die Auswahl und wählen Sie in der Liste Integrierte Variable auswählen aus.
   2. Wenn der Name des Clients, der das Ereignis generiert hat, automatisch zurückgegeben werden soll, wählen Sie Clientname aus.

   3. Verwenden Sie den Namen des zuvor konfigurierten Clients, um die Bedingung entsprechend festzulegen. Der Trigger sollte so aussehen:

      

      Hinweis: Der Name des Clients entspricht den Angaben, die Sie im vorherigen Schritt angegeben haben. Der Kunde ist Google Analytics: GA4 (App). Die Variable „Clientname“ gibt den Namen und nicht den Typ des Clients zurück.

6. Speichern Sie den Trigger und geben Sie einen aussagekräftigen Namen ein. Sie können beispielsweise „Alle GA4-App-Ereignisse“ verwenden.

7. Sie sollten jetzt wieder in den Tag-Einstellungen mit dem neuen Trigger angezeigt werden. Speichern Sie das Tag und geben Sie einen aussagekräftigen Namen ein, z. B. „GA4“. Ihr Tag sollte so aussehen:

   

Tipp :Wenn Sie bestimmte Ereignisse nicht weitergeben möchten, können Sie benutzerdefinierte Trigger mit bedingter Logik basierend auf dem Ereignisnamen (oder einer anderen Variablen) verwenden oder Triggerausnahmen hinzufügen. Weitere Informationen zum Auslösen von Triggern und Triggerausnahmen

Container als Vorschau ansehen

Sie können mit Google Tag Manager eine Vorschau Ihres Servercontainers anzeigen und ihn debuggen, bevor Sie die Änderungen veröffentlichen. Die Vorschau funktioniert erst, wenn Sie das serverseitige Tagging in Ihrer GA4-Property aktiviert haben.

Damit Ihre App-Anfragen die Vorschaukonfiguration auslösen, müssen Sie Folgendes tun:

1. Wählen Sie in Ihrem Google Tag Manager-Servercontainer Vorschau aus.
2. Klicken Sie rechts oben auf das Symbol Mehr ⋮ und wählen Sie Anfragen über eine App senden aus.

3. Geben Sie Ihre App-ID ein und klicken Sie auf QR-Code generieren.

   

4. Scannen Sie den QR-Code mit der Kamera App Ihres Smartphones. Sie können die App dann wie gewohnt nutzen, um Vorschauereignisse zu generieren.

5. Klicken Sie auf OK, um das Dialogfeld zu schließen.

Container veröffentlichen

Nachdem Sie die Änderungen überprüft haben, veröffentlichen Sie den Container, damit sie für den gesamten Traffic übernommen werden. Weitere Informationen zu Veröffentlichung, Versionen und Genehmigungen

Schritt 3: Serverseitiges Tagging in Ihrer GA4-Property aktivieren

1. Klicken Sie in Ihrer Google Analytics 4-Property auf Verwaltung.
2. Öffnen Sie Datenstreams.

3. Wählen Sie auf dem Tab „iOS“ oder „Android“ die Streamkonfiguration Ihrer Anwendung aus.

   

4. Klicken Sie auf SDK-Einstellungen konfigurieren und dann auf Serverseitiges Tag Manager-Tag konfigurieren.

   

5. So aktivieren Sie, dass das SDK Messdaten an die Servercontainer-URL sendet:

   1. Aktivieren oder deaktivieren Sie die Option Daten an einen serverseitigen Tag Manager-Container senden.
   2. Kopieren Sie die Servercontainer-URL. Sie finden sie in Google Tag Manager unter Verwaltung > Containereinstellungen > Servercontainer-URLs.

   3. Wählen Sie den Prozentsatz des Traffics aus, der an den Servercontainer weitergeleitet werden soll. Sie können eine Option unter 100% auswählen, um die Servereinrichtung und -konfiguration zu validieren, bevor Sie das serverseitige Tagging für Ihren gesamten Traffic verwenden.

      Hinweis :Mit der Option „Nur Geräte debuggen“ können Sie festlegen, dass Daten nur von Apps an Ihren Server gesendet werden, die im Vorschaumodus geöffnet wurden.

   

6. Klicken Sie auf Speichern. Das SDK ruft die aktualisierte Servercontainer-URL ab und leitet Messdaten an diese weiter.

Bekannte Einschränkungen

• Für Android-Apps:

  • Um potenzielle Sicherheitslücken im Zusammenhang mit Servercontainern und Google Play-Diensten zu vermeiden, werden Ereignisse zwischen dem SDK und Ihrem Servercontainer über einen zustandslosen Proxyserver geleitet. Dieser Proxy prüft die Quelle und den Endpunkt der Anfrage, prüft oder speichert jedoch keine Daten zu den Ereignissen. Gemäß der Datenerhebung in GA4 von Geräten in der EU befindet sich der Proxy für Zugriffe in der EU in der EU.
  • Automatisch protokollierte In-App-Käufe müssen in das Google Play-Back-End eingebunden werden und werden nicht an den Servercontainer gesendet.
  • app_remove Ereignis wird nicht auf Android-Geräten gemeldet.

• Sie müssen Ihre App-Datenstreams in Google Analytics weiterhin mit Ihrem Google Ads-Konto verknüpfen, damit Ihre SDK-Daten und -Conversions in Google Ads importiert werden können. Beim serverseitigen Tagging gibt es keine integrierte Integration zwischen Ihrem SDK und Google Ads.

API

Mit der Tag Manager REST API können Sie auf die Tag Manager-Konfigurationsdaten zugreifen. Weitere Informationen zur API:

• Informationen zur Verwendung der API finden Sie im Entwicklerhandbuch.
• In der Tag Manager API-Referenz finden Sie Informationen zu Tag Manager-Ressourcen und verfügbaren Vorgängen.