Serverseitiges Tagging für mobile Apps

Sie können Ihre mobilen Apps mit dem Google Analytics for Firebase SDK für die Verwendung von serverseitigem Tagging in Google Tag Manager konfigurieren.

Beim serverseitigen Tagging können Sie Ihre Daten vorbereiten, entfernen und erweitern, bevor Sie sie an Zielprodukte wie Google Analytics senden. Weitere Informationen zum serverseitigen Tagging

So richten Sie serverseitiges Tagging für mobile Apps ein:

1. App für serverseitiges Tagging vorbereiten
2. Servercontainer für die Unterstützung von Traffic über Mobilgeräte konfigurieren
3. Serverseitige Tag-Kennzeichnung in Ihrer GA4-Property aktivieren

Vorbereitung

• Sie müssen das Google Analytics for Firebase SDK in Ihre App einbinden und es 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. Aktivieren Sie die Uploadfunktion für serverseitiges Tagging und richten Sie das benutzerdefinierte URL-Schema für den Debug-Modus für serverseitiges Tagging in der Datei Info.plist ein. Ersetzen Sie BUNDLE_ID im Folgenden durch den Paket-Identifikator 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 Lifecycle-Methode einen Aufruf von Analytics.handleOpen(_:) hinzu, 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 SwiftUI oder UIScene nicht verwenden, sind keine Maßnahmen erforderlich. Das SDK empfängt die Start-URL von ApplicationDidFinishLaunchingNotification.

Android

1. Installieren Sie die aktuelle 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" />
   

   Hinweis :<APP_PACKAGE_ID> sollte nur Kleinbuchstaben enthalten. Der Abgleich von Schemas im Android-Framework erfolgt im Gegensatz zur RFC unter Berücksichtigung der Groß- und Kleinschreibung.

Schritt 2: Servercontainer für die Unterstützung von Traffic über Mobilgeräte konfigurieren

Im folgenden Abschnitt wird davon ausgegangen, dass Sie bereits eine serverseitige Tagging-Bereitstellung haben und mit den entsprechenden Konzepten vertraut sind. Wenn Sie noch nicht mit serverseitigem Tagging vertraut sind, empfehlen wir Ihnen den Kurs zu den Grundlagen des serverseitigen Tagging.

Google Analytics: GA4 (App)-Client einrichten

Ein Client ist ein Tag Manager-Ressourcentyp, der bestimmte Arten von eingehenden 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. Sie müssen also den integrierten Google Analytics: GA4 (App)-Client konfigurieren. Sie benötigen nur einen GA4-Client pro Datenquelle, z. B. GA SDK und Website. Weitere Informationen zur Funktionsweise von Clients

1. Rufen Sie in Ihrem Servercontainer Clients auf und klicken Sie auf Neu.

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

   

3. Geben Sie einen Namen für den Client 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 Tag vom Typ „Google Analytics: GA4“ erstellen. Der Client parst die eingehende HTTP-Anfrage in ein Ereignisdatenobjekt. Das Tag nimmt dieses Ereignisdatenobjekt, ordnet es dem richtigen Format zu und sendet es dann an Google Analytics 4.

1. Rufen Sie in Ihrem Servercontainer Tags auf und klicken Sie auf Neu.

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

   

Standardmäßig übernimmt der Tag alle relevanten Felder und Parameter aus den vom Client erstellten Ereignisdaten:

• Wenn die eingehende Google Analytics 4-Anfrage den Client Google Analytics: GA4 (App) durchläuft, werden die App-ID und die Ereignisparameter an das Tag weitergegeben.
• Wenn die eingehenden Google Analytics 4-Anfragen den Client Google Analytics: GA4 (Web) durchlaufen, werden die Mess-ID und die Ereignisparameter vom Tag übernommen.

Tipp :Optional können Sie Transformationen verwenden, um Ereignisparameter, die von Ihrem Client ausgegeben werden, ein- oder auszuschließen oder zu ändern, bevor sie für Tags verfügbar gemacht 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 Traffic über Mobilgeräte einrichten

Legen Sie dann fest, wann das GA4-Tag ausgelöst werden soll. Der Google Analytics: GA4 (App)-Client parst die eingehende Anfrage in ein Ereignisdatenobjekt und das Tag übernimmt seine Werte. Daher sollte das Tag in der Regel ausgelöst werden, wenn der GA4-Client die Anfrage übernimmt.

So richten Sie die Trigger ein:

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

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

   • Beim Typ Benutzerdefinierter Trigger wird das Tag standardmäßig ausgelöst, wenn ein serverseitiger Client ein Ereignis generiert.
   • Mit dem Trigger-Typ Benutzerdefiniertes Ereignis kann das Tag bei einem bestimmten Ereignisnamen oder bei einem Ereignis, das einem Muster für reguläre Ausdrücke entspricht, ausgelöst werden.

5. Wenn Sie die Liste der Aktivierungsbedingungen für diesen Trigger aktivieren möchten, z. B. um den Trigger nur bei Daten zu Mobilgeräte- oder Webereignissen auszulösen, wählen Sie Einige Ereignisse aus.

   1. Ereignisname ist bereits ausgewählt. Klicken Sie auf diese Auswahl und wählen Sie Integrierte Variable auswählen aus der Liste aus.
   2. Wenn Sie automatisch den Namen des Clients zurückgeben möchten, der das Ereignis generiert hat, wählen Sie Client Name (Clientname) aus.

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

      

      Hinweis :Der Name des Clients ist der Name, den Sie im vorherigen Schritt angegeben haben. Der Client-Typ ist „Google Analytics: GA4 (App)“. Die Variable „Client Name“ (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 sich jetzt wieder in den Tag-Einstellungen befinden und der neue Trigger sollte an der entsprechenden Stelle zu sehen sein. Speichern Sie das Tag und geben Sie einen aussagekräftigen Namen ein, z. B. „GA4“. Ihr Tag sollte so aussehen:

   

Tipp :Wenn Sie verhindern möchten, dass bestimmte Ereignisse weitergeleitet werden, können Sie benutzerdefinierte Trigger mit bedingter Logik basierend auf dem Ereignisnamen (oder einer anderen Variablen) verwenden oder Triggerausnahmen hinzufügen. Weitere Informationen zu Auslösetriggern und Triggern für Ausnahmen

Container in der Vorschau ansehen

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

Damit 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 Weitere Aktionen ⋮ und wählen Sie Anfragen über eine App senden aus.

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

   Hinweis :Die App‑ID muss mit einem Buchstaben beginnen. Alternativ können Sie eine beliebige eindeutige ID verwenden, die mit einem Buchstaben beginnt, sofern sie mit der ID in der Info.plist- oder AndroidManifest.xml-Datei übereinstimmt.

   

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 wirksam werden. Weitere Informationen

Schritt 3: Serverseitige Tag-Kennzeichnung in Ihrer GA4-Property aktivieren

1. Rufen Sie in Ihrer Google Analytics 4-Property die Verwaltung auf.
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 Serverseitigen Tag Manager konfigurieren.

   

5. So aktivieren Sie das Senden von Analysedaten an die Servercontainer-URL:

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

   3. Wählen Sie den Prozentsatz des Traffics aus, den Sie an den Servercontainer weiterleiten möchten. Sie können eine Option unter 100% auswählen, um die Servereinrichtung und -konfiguration zu validieren, bevor Sie serverseitiges Tagging für den gesamten Traffic verwenden.

      Hinweis: Wenn Sie die Option „Nur Debugging-Geräte verwenden“ auswählen, können nur Apps, die im Vorschaumodus geöffnet werden, Daten an Ihren Server senden.

   

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

Bekannte Einschränkungen

• Für Android-Anwendungen:

  • Automatisch erfasste In-App-Käufe basieren auf der Integration mit dem Google Play-Backend und werden nicht an den Servercontainer gesendet.
  • Das app_remove-Ereignis wird unter Android nicht gemeldet.

• Wenn Sie Ihre App-Datenstreams in Google Analytics mit Ihrem Google Ads-Konto verknüpfen, werden Ihre SDK-Daten und Conversions in Google Ads importiert. Serverseitiges Tagging bietet keine direkte Integration zwischen Ihrem SDK und Google Ads.

Hinweis :Das Google Analytics for Firebase SDK wurde für das Senden von Daten an Google Analytics 4 entwickelt und optimiert. Google Analytics 4 kann dann mit Google Ads verknüpft werden, um Conversion-Berichte zu erstellen, Zielgruppen zu erstellen, Kampagnen zu optimieren und Modellierungen durchzuführen. Dazu gehört auch das serverseitige Tagging für Apps. Wir empfehlen Kunden, die Integration zwischen Google Analytics und dem serverseitigen Tagging in Google Tag Manager zu nutzen.

API

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

• Im Entwicklerhandbuch erfahren Sie, wie Sie mit der API arbeiten.
• In der Tag Manager API-Referenz finden Sie Informationen zu Tag Manager-Ressourcen und verfügbaren Vorgängen.