Questa pagina è stata tradotta dall'API Cloud Translation.

Configura i dispositivi per utilizzare Privacy Sandbox su Android

Puoi attivare o disattivare diverse impostazioni per i dispositivi che eseguono Privacy Sandbox su Android.

Visualizzare l'interfaccia utente per i controlli utente di Privacy Sandbox

Privacy Sandbox su Android consente agli utenti dei dispositivi di stabilire se le API PPAPI (Privacy-Privacy API, PPAPI) e SDK Runtime sono abilitate sui propri dispositivi. A partire dall'Anteprima per gli sviluppatori 5, l'impostazione per visualizzare l'UI dei controlli utente è disattivata per impostazione predefinita. A scopo di sviluppo e test, ti consigliamo di abilitare l'UI di controllo utente. Per abilitare l'UI del controllo utente, utilizza i comandi adb seguenti:

Per le build in versione beta e di produzione:

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

Per le anteprime per gli 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.

Diagramma — UI per il controllo degli utenti di Privacy Sandbox sul dispositivo Android.

Attivare Privacy Sandbox sul dispositivo

Sebbene la sezione precedente consentisse all'utente del dispositivo di scegliere se eseguire Privacy Sandbox sul proprio dispositivo, in questa sezione viene spiegato in che modo uno sviluppatore può attivare le API su un dispositivo utilizzando i comandi adb.

Attiva la PPAPI sul dispositivo

Abilita l'API 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 la PPAPI

A scopo di sviluppo e test, puoi attivare o disattivare l'accesso PPAPI sul dispositivo eseguendo questi 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

Abilita SDK Runtime sul dispositivo

adb shell device_config put adservices disable_sdk_sandbox false

Passaggi successivi alla registrazione

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

Devi scaricare il file di registrazione sul dispositivo seguendo questi passaggi:

Dovresti ricevere un'email dall'assistenza di Privacy Sandbox con il tuo ID account di registrazione e un URL che rimanda al file di registrazione.
Sul dispositivo che esegue la release di anteprima per gli sviluppatori, esegui l'override dell'elenco di registrazioni utilizzando questo comando.
```
adb shell device_config put adservices mdd_measurement_manifest_file_url
"<insert URL provided>"
```
(Facoltativo ma consigliato) La verifica dell'override restituisce il percorso impostato nel passaggio precedente.
```
adb shell device_config get adservices mdd_measurement_manifest_file_url
```
Attivare una chiamata API da una delle API Privacy Preserve. (ad esempio registerSource() dall'API Attribution Reporting, getTopics() dall'API Topics o joinCustomAudience() dall'API Protected Audience). È previsto che questa chiamata non vada a buon fine.

Forza l'esecuzione del job di download.

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

Ora puoi iniziare a chiamare le API Privacy Protection API in Anteprima per sviluppatori. La chiamata effettuata nel passaggio 4 dovrebbe avere esito positivo.

Disattiva registrazione

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

Protected Audience

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

Argomenti

adb shell setprop debug.adservices.disable_topics_enrollment_check true

Reporting sull'attribuzione

adb shell device_config put adservices disable_measurement_enrollment_check "true"