Diese Seite wurde von der Cloud Translation API übersetzt.

Datenschutzkonforme App-Attribution

Zusammenfassung

API-Nutzer, die App-Conversion-Tracking und Remarketing API von Google Ads verwenden, um App-Conversions direkt weiterzuleiten, sollten die folgenden Android- und iOS-Richtlinien beachten. So wird sichergestellt, dass Klicks von Nutzern, die das Anzeigen-Tracking oder personalisierte Anzeigen deaktivieren, nur über datenschutzkonforme Workflows zugeordnet werden. Weitere Informationen zu Parameterdefinitionen und erwarteten Werten finden Sie in der Übersicht der Anfragespezifikationen.

Android-Apps

Umfang

App-Installationsanzeigen und -Interaktionen über alle Google Ads-Kampagnen

Hintergrund

Android-Nutzer, die personalisierte Werbung deaktiviert haben, können derzeit kein Tracking mithilfe der Android-Werbe-ID (gemäß den Richtlinien von Google) durchführen. Stattdessen verwendet Google den Parameter gclid der Klick-URL, der auf dem Gerät nicht erhalten bleibt.

Anleitung

Nutzer der App Conversion Tracking and Remarketing API müssen darauf achten, dass gclid korrekt gespeichert und übergeben wird.

Unterstützte Szenarien

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

Wenn eine App-Installation von einem Deeplink stammt, der Nutzer zum Google Play Store weiterleitet, und der Nutzer die App zum ersten Mal öffnet, parst du den gclid-Wert aus dem Feld Play Install Referrer API install_referrer und speicherst ihn entweder auf dem Gerät oder serverseitig durch eine eigene Kennung. gclid sollte 180 Tage oder so lange gespeichert werden, bis eine neuere Empfehlung vom Typ „Play-Installation“ gclid ersetzt.Diese gclid kann über das Conversion-Anfragefeld market_referrer_gclid übergeben werden.

Werbe-ID ist verfügbar

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

Beispiel: Erstes Öffnen

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
       &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
       &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 die Android-Werbe-ID NICHT verfügbar ist, muss das market_referrer_gclid mit dem entsprechenden Ereignis first_open, ALLE nachgelagerten Sitzungen &App-Ereignisse (z. B. session_start, add_to_cart, in_app_purchase) sowie dem zusätzlichen Feld/Wert gclid_only_request=1 gesendet werden. Hinweis: Der Wert für rdid sollte alle Nullen betragen, da der Nutzer keine Einwilligung erteilt hat.

Beispiel: Erstes Öffnen

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
       &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: Sitzung &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
       &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-Engagement (Nutzer hat die App bereits installiert)

Wenn eine App-Sitzung über einen Deeplink gesteuert wird, parsen Sie den Wert gclid und speichern Sie ihn entweder auf dem Gerät oder serverseitig über eine eigene ID.
gclid sollte 180 Tage lang oder so lange gespeichert werden, bis eine neuere gclid ersetzt wird. Dieser Wert kann dann über das Conversion-Anfragefeld gclid übergeben werden.

Werbe-ID ist verfügbar

Wenn die Android-Werbe-ID verfügbar ist, muss die gclid mit dem entsprechenden session_start-Ereignis gesendet werden. gclid kann mit App-Ereignissen gesendet werden, z. B. add_to_cart, in_app_purchase usw. Die gclid sollte NICHT mit nachgelagerten session_start-Ereignissen übergeben werden.

Beispiel: Deeplink-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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

Werbe-ID ist NICHT verfügbar

Wenn die Android-Werbe-ID NICHT verfügbar ist, muss das gclid zusammen mit dem entsprechenden Ereignis session_start und allen nachgelagerten Sitzungen und App-Ereignissen (z.B. session_start, add_to_cart, in_app_purchase usw.) gesendet werden. Hinweis: Der Wert für „rdid“ muss null sein, da der Nutzer personalisierte Anzeigen deaktiviert hat.

Beispiel: Deeplink-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
       &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

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
       &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

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
       &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

Unterstütztes Szenario: Installation und Interaktion

Wenn eine App-Installation über einen Deeplink zum Google Play Store und anschließend eine App-Sitzung mit einem Deeplink zur App führt, werden sowohl die Play Install Referrer API gclid als auch die Deeplink-gclid-Werte geparst und entweder auf dem Gerät oder serverseitig in Form einer eigenen ID gespeichert. Diese gclid-Werte sollten 180 Tage gespeichert werden oder so lange, bis ein neuerer Deeplink gclid den vorhandenen Deeplink gclid ersetzt oder eine Play Install Referrer API gclid die vorhandene Play Install Referrer API gclid ersetzt. Die Play Install Referrer API gclid sollte über das market_referrer_gclid field weitergegeben werden UND der Deeplink gclid sollte über das Feld gclid weitergegeben werden.

Werbe-ID ist verfügbar

Wenn die Android-Werbe-ID verfügbar ist, müssen sowohl das market_referrer_gclid UND das gclid mit dem entsprechenden session_start-Ereignis und den entsprechenden App-Ereignissen gesendet werden, z. B. add_to_cart, in_app_purchase usw. Für nachgelagerte „session_start“-Ereignisse muss „market_referrer_gclid“ übergeben werden. Der (Deeplink) gclid darf jedoch NICHT weitergegeben werden.

Beispiel: Deeplink-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
       &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

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
       &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

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
       &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

Werbe-ID ist NICHT verfügbar

Wenn die Android-Werbe-ID NICHT verfügbar ist, müssen sowohl das market_referrer_gclid UND das gclid mit dem entsprechenden session_start-Ereignis als auch ALLE nachgelagerten Sitzungs- und App-Ereignisse (d.h. session_start, add_to_cart, in_app_purchase usw.) gesendet werden. Hinweis: Der Wert rdid muss null sein, da der Nutzer personalisierte Werbung deaktiviert hat.

Beispiel: Deeplink-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
       &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

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
       &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

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
       &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

Wichtig:Die Play Install Referrer API gclid (als market_referrer_gclid übergeben) und der Deeplink gclid (als gclid übergeben) sind zwei separate Quellen für gclid und sollten nicht austauschbar verwendet werden. Zur Erinnerung: Diese gclid-Werte sollten 180 Tage lang gespeichert werden oder so lange, bis ein neuerer Deeplink gclid den vorhandenen Deeplink gclid ersetzt oder eine Play Installation Referrer API gclid die vorhandene Play Install Referrer API gclid ersetzt.

iOS-Apps

Umfang

App-Interaktionsanzeigen über die Google Ads-Suche, Google Shopping, &iOS ACi + Deeplinks

Hintergrund

Nutzer mit iOS 14.5 oder höher, die App-Tracking nicht aktiviert haben, können den IDFA nicht gemäß der ATT-Richtlinie von Apple verwenden. Stattdessen verwendet Google den Parameter gbraid für die aggregierte Klick-URL.

Anleitung

Nutzer der App Conversion Tracking and Remarketing API müssen sicherstellen, dass alle Klickparameter korrekt übergeben werden, einschließlich gclid und gbraid.

Unterstützte Szenarien

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

Wenn eine App-Sitzung über einen Deeplink gesteuert wird, parsen Sie die Werte gclid und gbraid und speichern Sie diese entweder auf dem Gerät oder serverseitig durch eine eigene ID. Diese Werte sollten 180 Tage gespeichert oder so lange ersetzt werden, bis sie durch einen neueren Wert ersetzt werden. Der Wert gclid kann dann über das Conversion-Anfragefeld gclid und der Wert gbraid über das Conversion-Anfragefeld gbraid übergeben werden.

IDFA ist verfügbar

Wenn IDFA verfügbar ist, müssen sowohl das gclid UND das gbraid mit dem entsprechenden Ereignis „session_start“ zusammen mit dem zusätzlichen Feld bzw. Wert app_open_source=ad_click gesendet werden. gclid und gbraid können mit nachgelagerten Sitzungen und App-Ereignissen (z. B. session_start, add_to_cart, in_app_purchase) gesendet werden. Fügen Sie bei nachfolgenden nachgelagerten Sitzungen das zusätzliche Feld/den Wert app_open_source=organic ein.

Beispiel: Deeplink-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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u
       &app_open_source=organic

IDFA ist NICHT verfügbar

Wenn IDFA NICHT verfügbar ist, muss die gbraid mit dem entsprechenden session_start-Ereignis zusammen mit dem zusätzlichen Feld bzw. Wert app_open_source=ad_click gesendet werden. und ALLE nachgelagerten App-Ereignisse (z.B. add_to_cart, in_app_purchase usw.). Hinweis: Das Feld gclid sollte weggelassen werden und der Wert rdid sollte alle Nullen sein, da der Nutzer nicht eingewilligt hat. Die Authentifizierung gbraid ist auch erforderlich mit nachgelagerten Sitzungen und den entsprechenden App-Ereignissen (z.B. session_start, add_to_cart, in_app_purchase usw.). Geben Sie für nachfolgende nachgelagerte Sitzungen das zusätzliche Feld/den zusätzlichen Wert app_open_source=organic an.

Beispiel: Deeplink-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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M

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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=organic

Hinweis: gbraid kann nicht für Installationsszenarien verwendet werden, da Nutzer zuerst zu iTunes weitergeleitet werden.