Questa pagina è stata tradotta dall'API Cloud Translation.

Attribuzione app conforme alla privacy

Riepilogo

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

App Android

Ambito

Installazione di app e coinvolgimento con le app tramite tutte le campagne Google Ads

Contesto

Attualmente, gli utenti Android che hanno disattivato la personalizzazione degli annunci non possono essere monitorati usando l'ID pubblicità Android (come stabilito dalle norme di Google). Google utilizza invece gclid, un parametro URL di clic che non viene mantenuto insieme al dispositivo.

Consulenza

I consumatori dell'API App Conversion Tracking and Remarketing devono assicurarsi che gclid sia archiviato e trasmesso correttamente.

Scenari supportati

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

Quando un'app installata è guidata da un link diretto che reindirizza al Google Play Store e l'utente apre per la prima volta l'app, analizza il valore gclid dal campo API Play Install Referrer install_referrer e archivialo sul dispositivo o lato server protetto da un identificatore proprietario. Questo gclid deve essere archiviato per 180 giorni o fino a quando non verrà sostituito da un altro referrer installazione di Play gclid.Questo gclid può essere trasmesso tramite il campo di richiesta di conversione market_referrer_gclid.

L'ID pubblicità è disponibile

Quando l'ID pubblicità Android è disponibile, l'elemento market_referrer_gclid deve essere inviato con l'evento first_open corrispondente. market_referrer_gclid può essere inviato con sessioni downstream e eventi app (ad esempio 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
       &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 app e sessioni

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

L'ID pubblicità NON è disponibile

Quando l'ID pubblicità Android NON è disponibile, market_referrer_gclid deve essere inviato con l'evento first_open corrispondente e TUTTE le sessioni downstream e gli eventi app (ad esempio session_start, add_to_cart, in_app_purchase e così via), insieme al valore/campo aggiuntivo gclid_only_request=1. Nota: il valore rdid deve essere tutto zero (dato che 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
       &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: sessioni ed 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
       &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 in-app (l'utente ha già installato l'app)

Quando una sessione dell'app è guidata da un link diretto, analizza il valore gclid e archivialo sul dispositivo o lato server con un identificatore proprietario.
L'elemento gclid dovrebbe essere archiviato per 180 giorni o fino a quando non verrà sostituito da un altro gclidrecente. Questo valore può quindi essere trasmesso tramite il campo gclid della richiesta di conversione.

L'ID pubblicità è disponibile

Quando l'ID pubblicità di Android è disponibile, gclid deve essere inviato con l'evento session_start corrispondente. L'elemento gclid può essere inviato con gli eventi dell'app (ad esempio add_to_cart, in_app_purchase e così via). L'elemento gclid NON deve essere passato con eventi session_start a valle.

Esempio: sessione di link diretti

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

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

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

L'ID pubblicità NON è disponibile

Se l'ID pubblicità di Android NON è disponibile, gclid deve essere inviato con l'evento session_start corrispondente e tutte le sessioni e gli eventi di app downstream (ad esempio session_start, add_to_cart, in_app_purchase e così via). Nota: il valore rdid deve essere tutto zero (poiché l'utente ha disattivato la personalizzazione degli annunci).

Esempio: sessione di link diretti

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

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

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

Scenario supportato: Installazione + Coinvolgimento

Quando un'installazione di app è guidata da un link diretto a Google Play Store, seguito da una sessione di app guidata da un link diretto all'app, analizza sia i valori gclid dell'API referrer installazione di Play sia i valori link diretti gclid e archiviali sul dispositivo o lato server inseriti da un identificatore proprietario. Questi valori di gclid devono essere archiviati per 180 giorni o fino a quando un altro link diretto più recente gclid non sostituisce il link diretto esistente gclid, oppure un'API Play Install Referrer gclid sostituisce l'API Play Install Referrer esistente gclid. L'API Play Install gclid deve essere trasmessa tramite il campo market_referrer_gclid field, E il link diretto gclid deve essere passato tramite il campo gclid.

L'ID pubblicità è disponibile

Quando l'ID pubblicità Android è disponibile, sia l'market_referrer_gclid che il gclid devono essere inviati con l'evento session_start e gli eventi dell'app corrispondenti (ad esempio add_to_cart, in_app_purchase e così via). Per gli eventi downstream session_start, passa il market_referrer_gclid, ma il (link diretto) gclid NON deve essere trasmesso.

Esempio: sessione di link diretti

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

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

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

L'ID pubblicità NON è disponibile

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

Esempio: sessione di link diretti

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

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

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

Importante: l'API Play Install Referrer gclid (trasmessa come market_referrer_gclid) e il link diretto gclid (superato come gclid) sono due origini separate per gclid e non devono essere utilizzate in modo intercambiabile. Ti ricordiamo che questi valori gclid devono essere archiviati per 180 giorni, o fino a quando un altro link diretto più recente gclid non sostituirà il link diretto esistente gclid, oppure un'API referrer Installazione di Google Play sostituisce l'API esistente gclid.

App per iOS

Ambito

Coinvolgimento in app tramite Google Ads sulla rete di ricerca, Shopping e ACI iOS + link diretti

Contesto

Gli utenti iOS 14.5 e versioni successive che non hanno attivato il monitoraggio delle app non possono essere monitorati utilizzando l'IDFA (secondo le norme ATT di Apple). Google utilizza invece gbraid, un parametro URL di clic aggregato.

Consulenza

I consumatori delle API di monitoraggio delle conversioni di app e di remarketing devono garantire che tutti i parametri di clic siano trasmessi correttamente, inclusi gclid e gbraid.

Scenari supportati

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

Quando una sessione dell'app è guidata da un link diretto, analizza i valori gclid e gbraid e archiviali sul dispositivo o lato server con un identificatore proprietario. Questi valori devono essere conservati per 180 giorni o finché non vengono sostituiti con un valore più recente. Il valore gclid può quindi essere trasmesso tramite il campo di richiesta di conversione gclid, mentre il valore gbraid può quindi essere trasmesso tramite il campo di richiesta di conversione gbraid.

IDFA è disponibile

Quando IDFA è disponibile, sia gclid E gbraid devono essere inviati con l'evento session_start corrispondente, insieme al campo/valore aggiuntivo, app_open_source=ad_click. gclid e gbraid possono essere inviati con sessioni downstream e eventi app (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.

Esempio: sessione di link diretti

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

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

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

L'IDFA NON è disponibile

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

Esempio: sessione di link diretti

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

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

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

Nota: non è possibile usare gbraid negli scenari di installazione dato che gli utenti vengono reindirizzati per la prima volta a iTunes.