Configurare i dispositivi per utilizzare Privacy Sandbox su Android

bookmark_border Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Esistono diverse impostazioni che puoi attivare o disattivare per i dispositivi su cui è in esecuzione Privacy Sandbox su Android.

Mostrare l'interfaccia utente di controllo utente di Privacy Sandbox

Privacy Sandbox su Android consente agli utenti dei dispositivi di controllare se le API incentrate sulla tutela della privacy (PPAPI) e SDK Runtime sono attivate o meno sui propri dispositivi. A partire da Developer Preview 5, l'impostazione per visualizzare l'UI di controllo utente è disattivata per impostazione predefinita. Per scopi di sviluppo e test, potrebbe essere opportuno attivare l'interfaccia utente di controllo utente. Per attivare l'interfaccia utente di controllo utente, utilizza i seguenti comandi adb:

Per le build beta e di produzione:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity

Per le anteprime per sviluppatori:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity

Per impostazione predefinita, il controllo utente è disattivato sul dispositivo. Per attivare l'API Privacy Sandbox e l'SDK Runtime sul dispositivo, tocca l'opzione di attivazione/disattivazione.

Attivare Privacy Sandbox sul dispositivo

Mentre la sezione precedente consentiva all'utente del dispositivo di scegliere se eseguire Privacy Sandbox sul proprio dispositivo, questa sezione spiega come uno sviluppatore può attivare le API su un dispositivo utilizzando i comandi adb.

Attivare la PPAPI sul dispositivo

Attivare la PPAPI

adb shell device_config put adservices ppapi_app_allow_list \"\*\"
adb shell device_config put adservices ppapi_app_signature_allow_list \"\*\"
adb shell device_config put adservices msmt_api_app_allow_list \"\*\" // for attribution
adb shell device_config put adservices adservice_system_service_enabled true
adb shell device_config put adservices adservice_enabled true
adb shell device_config put adservices adservice_enable_status true

Disattivare PPAPI

Per scopi di sviluppo e test, puoi attivare o disattivare l'accesso all'API PP sul dispositivo eseguendo i seguenti comandi:

Imposta su false per attivare:

adb shell device_config put adservices global_kill_switch false

Imposta su true per disattivare:

adb shell device_config put adservices global_kill_switch true

Attivare il runtime dell'SDK sul dispositivo

adb shell device_config put adservices disable_sdk_sandbox false

Passaggi successivi alla registrazione

Una volta completata la registrazione, devi svolgere alcuni passaggi aggiuntivi per preparare il tuo dispositivo all'utilizzo delle API Privacy Sandbox.

Devi forzare il download del file di registrazione sul tuo dispositivo seguendo questi passaggi:

1. Dovresti ricevere un'email dall'assistenza di Privacy Sandbox con l'ID account della registrazione e un URL che rimanda al file di registrazione.

2. Sul dispositivo su cui è in esecuzione la release Developer Preview, sostituisci l'elenco di registrazione utilizzando questo comando.

   adb shell device_config put adservices mdd_measurement_manifest_file_url
   "<insert URL provided>"

3. (Facoltativo, ma consigliato) Verifica che l'override restituisca il percorso impostato nel passaggio precedente.

   adb shell device_config get adservices mdd_measurement_manifest_file_url

4. Attiva una chiamata API da una delle API che rispettano la privacy. ad es.registerSource() dall'API Attribution Reporting, getTopics() dall'API Topics o joinCustomAudience() dall'API Protected Audience). Questa chiamata dovrebbe non andare a buon fine.

5. Esegui forzatamente il job di download.

   adb shell cmd jobscheduler run -f com.google.android.adservices.api  14

6. Ora puoi iniziare a chiamare le API incentrate sulla tutela della privacy nell'anteprima per gli sviluppatori. La chiamata effettuata nel passaggio 4 dovrebbe ora riuscire.

Disattivare la registrazione

Nelle release di anteprima per gli sviluppatori, puoi accedere alle API Protected Audience e Topics senza registrarti eseguendo i seguenti comandi di disattivazione della registrazione adb.

Protected Audience

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

Argomenti

adb shell setprop debug.adservices.disable_topics_enrollment_check true

Report sull'attribuzione

adb shell device_config put adservices disable_measurement_enrollment_check "true"