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.
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 ojoinCustomAudience()
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"