Datenschutzkonforme App-Attribution

Zusammenfassung

API-Nutzer, die die App Conversion Tracking and Remarketing API von Google Ads verwenden, um App-Conversions direkt zu übergeben, sollten die folgenden Android- und iOS-Anleitungen befolgen. So werden Klicks von Nutzern, die das Anzeigen-Tracking oder personalisierte Anzeigen deaktivieren, nur mithilfe datenschutzkonformer Workflows zugeordnet. Weitere Informationen zu Parameterdefinitionen und erwarteten Werten finden Sie in der Übersicht der Spezifikationen für Anfragen und Antworten.

Android-Apps

Umfang

App-Installationen und App-Engagement über alle Google Ads-Kampagnen

Hintergrund

Derzeit können Android-Nutzer, die personalisierte Werbung deaktiviert haben, gemäß der Google-Richtlinie nicht über die Android-Werbe-ID getrackt werden. Stattdessen verwendet Google den gclid, einen Klick-URL-Parameter, der nicht auf dem Gerät gespeichert wird. Außerdem kann Google den gbraid-Parameter, einen aggregierten Parameter für die Klick-URL, in anderen Szenarien verwenden, in denen keine Einwilligung auf Nutzerebene erteilt wurde.

Anleitung

Nutzer der App Conversion Tracking and Remarketing API müssen dafür sorgen, dass gclid und gbraid korrekt gespeichert und übergeben werden.

Unterstützte Szenarien

Unterstütztes Szenario: Installation (Nutzer hat die App noch nicht installiert)

Wenn eine App-Installation über einen Deeplink erfolgt, der zum Google Play Store weiterleitet, und der Nutzer die App zum ersten Mal öffnet, parsen Sie den gclid-Wert aus dem Feld install_referrer der Play Install Referrer API und speichern Sie ihn entweder auf dem Gerät oder serverseitig mit einem eigenen Identifier als Schlüssel. Jeder Wert sollte 180 Tage lang gespeichert werden oder bis er durch einen neueren Wert ersetzt wird. Der gclid-Wert sollte über das Feld market_referrer_gclid der Conversion-Anfrage übergeben werden.

Werbe-ID ist verfügbar

Wenn die Android-Werbe-ID verfügbar ist, muss die market_referrer_gclid mit dem entsprechenden „first_open“-Ereignis und ALLEN nachgelagerten Sitzungen und App-Ereignissen (z. B. session_start, add_to_cart, in_app_purchase) gesendet werden.

Beispiel: Erster Aufruf
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
Beispiel: Sitzungs- und App-Ereignisse
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
Werbe-ID ist NICHT verfügbar

Wenn keine Android-Werbe-ID verfügbar ist, muss die market_referrer_gclid mit dem entsprechenden first_open-Ereignis gesendet werden. Außerdem müssen ALLE nachgelagerten Sitzungen und App-Ereignisse (z. B. session_start, add_to_cart, in_app_purchase usw.) zusammen mit dem zusätzlichen Feld/Wert gclid_only_request=1 gesendet werden. Hinweis: Der Wert rdid sollte nur Nullen enthalten, da der Nutzer keine Einwilligung erteilt hat.

Beispiel: Erster Aufruf
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
Beispiel: Sitzungs- und App-Ereignisse
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

Unterstütztes Szenario: App-Interaktion (Nutzer hat die App bereits installiert)

Wenn eine App-Sitzung über einen Deeplink gestartet wird, müssen Sie die Werte gclid und gbraid aus der verweisenden URL parsen und entweder auf dem Gerät oder serverseitig mit einem Erstanbieter-Identifier speichern. Jeder Wert sollte 180 Tage lang gespeichert werden oder bis er durch einen neueren Wert ersetzt wird. Der Deeplink-Wert gclid sollte über das Feld gclid der Conversion-Anfrage und der Deeplink-Wert gbraid über das Feld gbraid der Conversion-Anfrage übergeben werden.

Werbe-ID ist verfügbar

Wenn die Android-Werbe-ID verfügbar ist, müssen gclid und gbraid mit dem entsprechenden session_start-Ereignis und ALLEN nachgelagerten Sitzungen und App-Ereignissen (z. B. session_start, add_to_cart, in_app_purchase) gesendet werden.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: App-Ereignisse
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: Nachfolgende/organische Sitzung
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Werbe-ID ist NICHT verfügbar

Wenn keine Android-Werbe-ID verfügbar ist, muss gclid mit dem entsprechenden session_start-Ereignis und ALLEN nachgelagerten Sitzungen und App-Ereignissen (z. B. session_start, add_to_cart, in_app_purchase) gesendet werden. Hinweis: Der rdid-Wert sollte nur Nullen enthalten, da der Nutzer die Personalisierung von Werbung deaktiviert hat.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: App-Ereignisse
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: Nachfolgende/organische Sitzung
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Unterstütztes Szenario: Installation + Interaktion

Wenn eine App-Installation durch einen Deeplink zum Google Play Store ausgelöst wird, gefolgt von einer App-Sitzung, die durch einen Deeplink zur App ausgelöst wird, parsen Sie sowohl den gclid-Wert aus dem Feld „install_referrer“ der Play Install Referrer API als auch die Werte gclid und gbraid aus der verweisenden URL und speichern Sie sie entweder auf dem Gerät oder serverseitig mit einem Erstpartei-Identifier als Schlüssel. Jeder Wert sollte 180 Tage lang gespeichert werden oder bis er durch einen neueren Wert ersetzt wird. Der Wert gclid für den Installations-Referrer sollte dann über das Feld market_referrer_gclid der Conversion-Anfrage übergeben werden, der Wert gclid für den Deeplink über das Feld gclid der Conversion-Anfrage und der Wert gbraid für den Deeplink über das Feld gbraid der Conversion-Anfrage.

Werbe-ID ist verfügbar

Wenn die Android-Werbe-ID verfügbar ist, müssen sowohl market_referrer_gclid als auch gclid mit dem entsprechenden session_start-Ereignis und App-Ereignissen (z. B. add_to_cart, in_app_purchase) gesendet werden. Übergeben Sie für Downstream-Ereignisse vom Typ „session_start“ die market_referrer_gclid, aber gclid (Deeplink) sollte NICHT übergeben werden.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: App-Ereignisse
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: Nachfolgende/organische Sitzung
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       <&gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Werbe-ID ist NICHT verfügbar

Wenn keine Android-Werbe-ID verfügbar ist, müssen sowohl market_referrer_gclid als auch gclid mit dem entsprechenden session_start-Ereignis und ALLEN nachgelagerten Sitzungs- und App-Ereignissen (z. B. session_start, add_to_cart, in_app_purchase) gesendet werden. Hinweis:Der Wert rdid sollte nur Nullen enthalten, da der Nutzer die Personalisierung von Anzeigen deaktiviert hat.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: App-Ereignisse
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: Nachfolgende/organische Sitzung
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

iOS-Apps

Umfang

App-Interaktion über Google Ads-Such-, Shopping- und iOS-App-Installationskampagnen – Deeplinks

Hintergrund

iOS 14.5-Nutzer, die dem App-Tracking nicht zugestimmt haben, können gemäß der ATT-Richtlinie von Apple nicht über die IDFA getrackt werden. Stattdessen verwendet Google den Parameter gbraid, einen aggregierten URL-Parameter für Klicks. Außerdem kann Google die gbraid in anderen Szenarien verwenden, in denen keine Einwilligung auf Nutzerebene erteilt wurde.

Anleitung

App Conversion Tracking and Remarketing API Nutzer müssen dafür sorgen, dass alle Klickparameter richtig übergeben werden, einschließlich gclid und gbraid.

Unterstützte Szenarien

Unterstütztes Szenario: App-Interaktion (Nutzer hat die App bereits installiert)

Wenn eine App-Sitzung über einen Deeplink gestartet wird, müssen die Werte gclid und gbraid aus der verweisenden URL geparst und entweder auf dem Gerät oder serverseitig mit einem selbst erhobenen Identifier gespeichert werden. Jeder Wert sollte 180 Tage lang gespeichert werden oder bis er durch einen neueren Wert ersetzt wird. Der gclid-Wert sollte über das Feld gclid der Conversion-Anfrage und der gbraid-Wert über das Feld gbraid der Conversion-Anfrage übergeben werden.

IDFA ist verfügbar

Wenn die IDFA verfügbar ist, müssen sowohl gclid als auch gbraid zusammen mit dem entsprechenden session_start-Ereignis gesendet werden, zusammen mit dem zusätzlichen Feld/Wert app_open_source=ad_click. Die gclid und gbraid müssen auch mit Downstream-Sitzungen und App-Ereignissen (z. B. session_start, add_to_cart, in_app_purchase) gesendet werden. Fügen Sie für nachfolgende Downstream-Sitzungen das zusätzliche Feld/den zusätzlichen Wert app_open_source=organic ein.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click
Beispiel: App-Ereignis
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: Nachfolgende/organische Sitzung
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic
IDFA ist NICHT verfügbar

Wenn keine IDFA verfügbar ist, muss gbraid mit dem entsprechenden session_start-Ereignis und dem zusätzlichen Feld/Wert app_open_source=ad_click gesendet werden. und ALLE Downstream-App-Ereignisse (z. B. add_to_cart, in_app_purchase). Hinweis: Das Feld gclid sollte weggelassen werden und der Wert rdid sollte nur Nullen enthalten, da der Nutzer keine Einwilligung erteilt hat. Die gbraid ist AUCH erforderlich, um mit Downstream-Sitzungen und entsprechenden App-Ereignissen (z. B. session_start, add_to_cart, in_app_purchase) gesendet zu werden. Fügen Sie für nachfolgende Downstream-Sitzungen das zusätzliche Feld/den zusätzlichen Wert app_open_source=organic ein.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click
Beispiel: App-Ereignis
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Beispiel: Nachfolgende/organische Sitzung
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic