Schritt 1: SKAdNetwork-Postbacks für die relevanten iOS-Versionen registrieren
Weitere Informationen finden Sie in der Dokumentation von Apple. Wenn Sie das Google Analytics for Firebase SDK verwenden, können Sie diesen Schritt überspringen, da die Postbacks damit automatisch für die App registriert werden.
Schritt 2: Prüfen, ob Sie SKAdNetwork-Postbacks empfangen und decodieren
Weitere Informationen finden Sie in der Dokumentation von Apple. Falls noch nicht erfolgt, richten Sie einen SKAdNetwork-Endpunkt ein. Folgen Sie dafür der Anleitung von Apple.
Wenn Sie bereits einen Endpunkt über einen von Google genehmigten App Attribution Partner (AAP) oder eine interne Lösung eingerichtet haben, können Sie mit Schritt 3 fortfahren, in dem Sie die Weiterleitung von Ergebnissen an Google Analytics über das Measurement Protocol einrichten.
Schritt 3: Postback-Ergebnisse über das Measurement Protocol an Google Analytics weiterleiten
Dabei wird ein benutzerdefiniertes Ereignis vom Typ campaign_details über das Measurement Protocol an Google Analytics gesendet. Verwenden Sie dazu das folgende Schema (Codelab-Beispiel).
Measurement Protocol-Implementierung für SKAdNetwork in Google Analytics 4
Parameter der Anfrage
| Parameter | Weitere Informationen |
| firebase_app_id: {gmp_app_id} |
|
| api_secret: {api_secret} |
|
| timestamp_micros: {timestamp of received SKAN postback} |
|
| app_instance_id: {...} |
Erforderlich. Generieren Sie einen eindeutigen String mit Zufallszahlen. Dieser individuelle ID-String wird durch die tatsächliche App-Instanz-ID ersetzt, sobald diese Daten für die Conversion-Modellierung verwendet werden. |
GA-Ereignis
| Ereignis | Weitere Informationen |
| campaign_details | Benutzerdefiniertes Ereignis |
GA-Parameter (vorhanden)
| Parameter | Weitere Informationen |
| source: {source} |
Das sind Parameter, die für das manuelle Tagging verwendet werden. Berichte in Google Analytics 4 werden anhand der Google Analytics 4-Standard-Channelgruppierungen strukturiert. Wir empfehlen, dass Sie sich bei der Kategorisierung der einzelnen Parameter daran orientieren. Senden Sie diese Parameter für alle Postbacks, die nicht von Google stammen. Beispiel Facebook-Postback:
Für Google-Postbacks decodieren wir Kampagnen basierend auf der Verknüpfung Ihrer Property mit Google Ads. Deshalb sind die oben genannten Parameter für Google-Postbacks optional. Die Google Analytics 4-Property muss mit Ihren Google Ads-Werbekonten verknüpft sein. Hinweis: Es ist wichtig, alle SKAdNetwork-Postbacks an Google Analytics 4 zu senden, nicht nur die von Drittanbietern. |
| medium: {medium} | |
| term: {term} Optional | |
| content: {content} Optional | |
| campaign_id: {campaign_id} | Wert aus dem SKAdNetwork-Postback |
| campaign: {campaign} (optional, wenn nicht angegeben, wird aber „nicht festgelegt“ angezeigt) |
Für Google Ads-Kampagnen decodieren wir die ID und geben den Kampagnennamen basierend auf der Verknüpfung von Google Analytics und Google Ads an. Die Parameter für Quelle und Medium werden angepasst. Falls die Konten nicht miteinander verknüpft sind, werden die Google-Kampagnen-IDs nicht decodiert, sondern wir verwenden die für Quelle und Medium angegebenen Parameter. Für Kampagnen von Drittanbietern können Sie den Parameter decodieren und Kampagnennamen angeben. Falls diese Informationen nicht bekannt sind, kopieren Sie einfach die SKAdNetwork-Kampagnen-ID. Hinweis: Wenn Sie diesen Wert nicht angeben, wird (nicht festgelegt) angezeigt. |
| source_platform: "apple_skan" | Wichtig: Dieser String muss genau unter Berücksichtigung der Groß- und Kleinschreibung angegeben werden. |
| app_id: {app_id} |
Wert aus dem SKAdNetwork-Postback, also Ihre App-Bundle-ID |
| transaction_id: {transaction_id} | Wert aus dem SKAdNetwork-Postback |
Erforderliche neue Parameter
Hinweis: Diese neuen Parameter können in der Google Analytics 4-Benutzeroberfläche eingerichtet werden. Sie sind aber nicht erforderlich. Wenn Sie anhand dieser Parameter Berichte für benutzerdefinierte Dimensionen erstellen möchten, müssen sie in Google Analytics 4 registriert werden.
| Parameter | Weitere Informationen |
| version: {version} | Wert aus dem SKAdNetwork-Postback |
| conversion_value: {conversion_value} | Wert aus dem SKAdNetwork-Postback |
| fidelity_type: {fidelity_type} | Wert aus dem SKAdNetwork-Postback |
| attribution_signature: {attribution_signature} |
Wert aus dem SKAdNetwork-Postback Hinweis: Dies ist eine Sicherheitsfunktion. SKAdNetwork-Postbacks werden kryptografisch signiert. |
| redownload: {redownload} | Wert aus dem SKAdNetwork-Postback |
| source_app_id: {source_app_id} |
Wert aus dem SKAdNetwork-Postback Hinweis: Das ist die ID der App, in der ein Nutzer auf die Anzeige geklickt und später die App installiert hat. |
| did_win: {did_win} |
Wert aus dem SKAdNetwork-Postback Hinweis: Werbetreibende empfangen nur erfolgreiche Postbacks und AdTechs zusätzlich die zweitplatzierten und vorbereitenden Postbacks.
|
|
ad_network_id: {ad_network_id} Dabei ist {ad_network_id} der Wert im Postback. |
Wert aus dem SKAdNetwork-Postback Damit wird das Werbenetzwerk angegeben, in dem die Anzeige ausgeliefert wurde. Auch für die Traffic-Dimension „Quelle“ sind diese Informationen nützlich. |
Schritt 4: Prüfen, ob Marketing Platform-Treffer empfangen werden
Ereignisse vom Typ campaign_details werden nicht direkt in Google Analytics angezeigt. Stattdessen werden SKAdNetwork-Postbacks in Ereignisse umgewandelt und in Schlüsselereignisse vom Typ first_open sowie in Ereignisberichte eingefügt. Sie können sie segmentieren, indem Sie die Dimension „Quellplattform“ (source_platform = SKAN) hinzufügen.
Wenn Sie prüfen möchten, ob Treffer gesendet werden, sollten Sie Testereignisse erfassen. Duplizieren Sie dazu die Ereignisse vom Typ campaign_details und weisen Sie den Duplikaten einen anderen Namen zu, etwa „campaign_details_skan_test“. Sehen Sie dann nach, ob die Testereignisse im Echtzeitbericht von Google Analytics 4 auftauchen. Wenn Sie das Testereignis und die Testparameter registrieren, werden sie nicht nur in Echtzeit-, sondern auch in Ad-hoc-Berichten aufgeführt.
- Wenn alle SKAdNetwork-Postbacks in Berichten berücksichtigt werden sollen, müssen Sie jeden davon als Ereignis vom Typ
campaign_detailssenden und zusätzlich das duplizierte Ereignis und die duplizierten Parameter wie oben beschrieben registrieren. In diesem Fall müssen SKAdNetwork-Postbacks aber trotzdem noch über das Ereignis vom Typcampaign_detailsgesendet werden. Sonst werden sie in Google Analytics nicht erkannt, sodass keine Conversion-Modellierung vorgenommen werden kann, um Ihre iOS-Berichte zufirst_openzu verbessern. - SKAdNetwork-Postbacks müssen innerhalb von 4 Tagen nach Empfang gesendet werden, damit sie in Google Analytics für die Conversion-Modellierung und Berichterstellung genutzt werden können.