Configura i dispositivi per utilizzare Privacy Sandbox su Android

Esistono diverse impostazioni che puoi attivare o disattivare per i dispositivi. che esegue Privacy Sandbox su Android.

Visualizzare l'interfaccia utente del 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 abilitati su sui propri dispositivi. A partire da Anteprima per gli sviluppatori 5, l'impostazione per visualizzare l'interfaccia utente di controllo è disattivata per impostazione predefinita. A scopo di sviluppo e test, potresti voler abilitare l'interfaccia utente del controllo degli utenti. Per abilitare l'interfaccia utente di controllo degli utenti, 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

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 il API Privacy Sandbox e SDK Runtime sul dispositivo: tocca l'opzione di attivazione/disattivazione.

UI del controllo utente di Privacy Sandbox su un dispositivo Android.

Attiva Privacy Sandbox sul dispositivo

La sezione precedente consentiva all'utente del dispositivo di scegliere se Privacy Sandbox in esecuzione sul dispositivo, questa sezione spiega come uno sviluppatore può abilitare le API su un dispositivo utilizzando i comandi adb.

Attiva il PPAPI sul dispositivo

Abilita il 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:

Impostalo su false per attivare:

adb shell device_config put adservices global_kill_switch false

Impostalo su true per disattivare:

adb shell device_config put adservices global_kill_switch true

Attiva SDK Runtime sul dispositivo

adb shell device_config put adservices disable_sdk_sandbox false

Passaggi successivi alla registrazione

Una volta completata la registrazione, ci sono alcuni passaggi aggiuntivi da eseguire per preparare il dispositivo all'uso delle API Privacy Sandbox.

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

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

2. Sul dispositivo su cui è in esecuzione la release di Anteprima per gli sviluppatori, esegui l'override della registrazione utilizzando questo comando.

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

3. (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
   

4. Attivare una chiamata API da una delle API incentrate sulla tutela della privacy. (ad es. registerSource() dell'API Attribution Reporting, getTopics() del gruppo API Topics o joinCustomAudience() dell'API Protected Audience). Questo si prevede che la chiamata non vada a buon fine.

5. Forza l'esecuzione del 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 in Anteprima per gli sviluppatori. La chiamata effettuata nel passaggio 4 dovrebbe avere esito positivo.

Disattiva registrazione

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

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"