Attribuzione app conforme alla privacy

Riepilogo

I consumer dell'API che utilizzano l'API di remarketing e monitoraggio delle conversioni nelle app di Google Ads per trasmettere direttamente le conversioni nelle app devono seguire le indicazioni per Android e iOS. In questo modo, i clic degli utenti che disattivano il monitoraggio degli annunci o la personalizzazione degli annunci vengono attribuiti solo utilizzando flussi di lavoro conformi alla privacy. Per ulteriori informazioni sulle definizioni dei parametri e sui valori previsti, consulta la sezione Panoramica delle specifiche di richiesta e risposta.

applicazioni Android

Ambito

Installazione e coinvolgimento delle app tramite tutte le campagne Google Ads

Sfondo

Al momento, gli utenti Android che hanno disattivato la personalizzazione degli annunci non possono essere monitorati utilizzando l'ID pubblicità Android (in base alle norme di Google). Google utilizza invece gclid, un parametro URL dei clic che non viene mantenuto con il dispositivo. Inoltre, Google può utilizzare gBraid, un parametro URL di clic aggregato, in altri scenari in cui non è stato concesso il consenso a livello di utente.

Consulenza

I consumer dell'API per il remarketing e il monitoraggio delle conversioni di app devono assicurarsi che gclid e gbraid siano memorizzati e trasmessi correttamente.

Scenari supportati

Scenario supportato: installazione (l'utente non ha mai installato l'app)

Quando un'installazione di app è generata da un link diretto che reindirizza al Google Play Store e l'utente apre l'app per la prima volta, analizza il valore gclid dal campo API Play Install Referrer install_referrer e memorizzalo sul dispositivo o sul lato server in base a un identificatore proprietario. Ogni valore deve essere memorizzato per 180 giorni o fino a quando non viene sostituito da un altro valore più recente. Il valore gclid deve essere trasmesso tramite il campo della richiesta di conversione market_referrer_gclid.

L'ID pubblicità è disponibile

Quando l'ID pubblicità Android è disponibile, il market_referrer_gclid deve essere inviato con l'evento first_open corrispondente e TUTTE le sessioni e gli eventi app downstream (ad es. session_start,add_to_cart, in_app_purchase e così via).

Esempio: Prima apertura
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
Esempio: eventi di sessione e app
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
L'ID pubblicità NON è disponibile

Quando l'ID pubblicità Android NON è disponibile, il market_referrer_gclid è obbligatorio da inviare con l'evento first_open corrispondente e TUTTE le sessioni e gli eventi app downstream (ad es. session_start, add_to_cart, in_app_purchase e così via), insieme al campo/valore aggiuntivo, gclid_only_request=1. Nota: il valore rdid deve essere tutti zeri (poiché l'utente non ha dato il consenso).

Esempio: Prima apertura
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
Esempio: eventi sessione e app
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

Scenario supportato: coinvolgimento nell'app (l'utente ha già installato l'app)

Quando una sessione dell'app è guidata da un link diretto, analizza i valori gclid e gbraid dall'URL di riferimento e memorizzali sul dispositivo o sul lato server in base a un identificatore proprietario. Ogni valore deve essere memorizzato per 180 giorni o fino a quando non viene sostituito da un altro valore più recente. Il valore del link diretto gclid deve essere passato tramite il campo della richiesta di conversione gclid e il valore del link diretto gbraid deve essere passato tramite il campo della richiesta di conversione gbraid.

L'ID pubblicità è disponibile

Quando l'ID pubblicità Android è disponibile, gclid e gbraid devono essere inviati con l'evento session_start corrispondente e TUTTE le sessioni e gli eventi delle app downstream (ad es. session_start,add_to_cart, in_app_purchase e così via).

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
Esempio: eventi app
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
Esempio: Sessione successiva/organica
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
L'ID pubblicità NON è disponibile

Quando l'ID pubblicità Android NON è disponibile, l'gclid è obbligatorio per essere inviato con l'evento session_start corrispondente e TUTTE le sessioni downstream e gli eventi app (ad es. session_start, add_to_cart, in_app_purchase e così via). Nota: il valore rdid deve essere composto da tutti zeri (poiché l'utente ha disattivato la personalizzazione degli annunci).

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
Esempio: eventi app
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
Esempio: Sessione successiva/organica
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

Scenario supportato: installazione + coinvolgimento

Quando l'installazione di un'app viene attivata da un link diretto al Google Play Store, seguita da una sessione dell'app attivata da un link diretto all'app, analizza sia il valore gclid dal campo install_referrer dell'API Play Install Referrer, sia i valori gclid e gbraid dall'URL di riferimento e memorizzali sul dispositivo o sul lato server in base a un identificatore proprietario. Ogni valore deve essere memorizzato per 180 giorni o fino a quando non viene sostituito da un altro valore più recente. Il valore gclid del referrer di installazione deve essere passato tramite il campo della richiesta di conversione market_referrer_gclid, il valore gclid del link diretto deve essere passato tramite il campo della richiesta di conversione gclid e il valore gbraid del link diretto deve essere passato tramite il campo della richiesta di conversione gbraid.

L'ID pubblicità è disponibile

Quando l'ID pubblicità Android è disponibile, è necessario inviare sia market_referrer_gclid CHE gclid con l'evento session_start e gli eventi app (ad es. add_to_cart, in_app_purchase e così via) corrispondenti. Per gli eventi session_start downstream, passa market_referrer_gclid, ma gclid (link diretto) NON deve essere passato.

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
Esempio: eventi app
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
Esempio: Sessione successiva/organica
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
L'ID pubblicità NON è disponibile

Quando l'ID pubblicità Android NON è disponibile, sia market_referrer_gclid CHE gclid devono essere inviati con l'evento session_start corrispondente e TUTTI gli eventi di sessione e app downstream (ad es. session_start, add_to_cart, in_app_purchase e così via). Nota:il valore rdid deve essere composto da tutti zeri (poiché l'utente ha disattivato la personalizzazione degli annunci).

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
Esempio: eventi app
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
Esempio: Sessione successiva/organica
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

Applicazioni iOS

Ambito

Coinvolgimento delle app tramite la rete di ricerca, Shopping e ACi per iOS di Google Ads + link diretti

Sfondo

Gli utenti di iOS 14.5 e versioni successive che non hanno attivato il monitoraggio delle app non possono essere monitorati utilizzando l'IDFA (in base alle norme ATT di Apple). Google utilizza invece gbraid, un parametro URL di clic aggregato. Inoltre, Google potrebbe utilizzare gbraid in altri scenari in cui non è stato concesso il consenso a livello di utente.

Consulenza

I consumatori dell'API Conversion Tracking and Remarketing devono assicurarsi che tutti i parametri relativi ai clic vengano passati correttamente, inclusi gclid e gbraid.

Scenari supportati

Scenario supportato: coinvolgimento nell'app (l'utente ha già installato l'app)

Quando una sessione dell'app è guidata da un link diretto, analizza i valori gclid e gbraid dall'URL di riferimento e memorizzali sul dispositivo o sul server in base a un identificatore proprietario. Ogni valore deve essere memorizzato per 180 giorni o fino a quando non viene sostituito da un altro valore più recente. Il valore gclid deve essere trasmesso tramite il campo della richiesta di conversione gclid e il valore gbraid deve essere trasmesso tramite il campo della richiesta di conversione gbraid.

IDFA disponibile

Quando l'IDFA è disponibile, sia gclid che gbraid devono essere inviati con l'evento session_start corrispondente, insieme al campo/valore aggiuntivo app_open_source=ad_click. gclid e gbraid devono essere inviati anche con le sessioni downstream e gli eventi delle app (ad es. session_start, add_to_cart, in_app_purchase e così via). Per le sessioni downstream successive, includi il campo/valore aggiuntivo app_open_source=organic.

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
Esempio: evento app
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
Esempio: Sessione successiva/organica
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
L'IDFA NON è disponibile

Quando l'IDFA NON è disponibile, l'gbraid è obbligatorio per essere inviato con l'evento session_start corrispondente insieme al campo/valore aggiuntivo app_open_source=ad_click. e TUTTI gli eventi app downstream (ad es. add_to_cart, in_app_purchase, ecc.). Nota: il campo gclid deve essere omesso e il valore rdid deve essere composto da tutti zeri (poiché l'utente non ha dato il consenso). È OBBLIGATORIO inviare anche gbraid con le sessioni downstream & gli eventi app corrispondenti (ad es. session_start, add_to_cart, in_app_purchase e così via). Per le sessioni downstream successive, includi un campo/valore aggiuntivo, app_open_source=organic.

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
Esempio: evento app
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
Esempio: Sessione successiva/organica
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