Existen varios parámetros de configuración que puedes activar o desactivar para los dispositivos con Privacy Sandbox en Android.
Muestra la IU de control de usuario de Privacy Sandbox
Privacy Sandbox en Android permite a los usuarios controlar si las APIs que preservan la privacidad (PPAPI) y el entorno de ejecución de SDK están habilitados en sus propios dispositivos o no. A partir de la Versión preliminar para desarrolladores 5, la configuración para mostrar la IU de control de usuario está desactivada de forma predeterminada. Para fines de desarrollo y prueba, habilita la IU de control de usuario. Para habilitar la IU de control de usuario, usa
los siguientes comandos adb
:
Para compilaciones beta y de producción:
adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity
Para las Versiones preliminares para desarrolladores:
adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity
De forma predeterminada, el control de usuario está desactivado en el dispositivo. Para habilitar la API de Privacy Sandbox y el entorno de ejecución de SDK, presiona el interruptor de activación en el dispositivo.
![Diagrama](https://developers.google.cn/static/privacy-sandbox/assets/images/TurnOnDevicePrivacyAPIs.png?authuser=3&hl=es-419)
Habilita Privacy Sandbox en el dispositivo
En la sección anterior, se permitía que el usuario del dispositivo eligiera si deseaba que Privacy Sandbox se ejecutara en su dispositivo. En esta sección, se explica cómo un desarrollador puede usar comandos adb
para habilitar las APIs en un dispositivo.
Habilitar la PPAPI en el dispositivo
Cómo habilitar 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
Cómo desactivar la PPAPI
Para fines de desarrollo y prueba, puedes activar o desactivar el acceso a la PPAPI en el dispositivo con los siguientes comandos:
Configúralo en false
para activarlo:
adb shell device_config put adservices global_kill_switch false
Configúralo en true
para desactivarlo:
adb shell device_config put adservices global_kill_switch true
Habilita el entorno de ejecución de SDK en el dispositivo
adb shell device_config put adservices disable_sdk_sandbox false
Pasos posteriores a la inscripción
Una vez que completes la inscripción, deberás seguir algunos pasos adicionales para preparar tu dispositivo para usar las APIs de Privacy Sandbox.
Debes forzar la descarga del archivo de inscripción en tu dispositivo con los siguientes pasos:
- Recibirás un correo electrónico del equipo de asistencia de Privacy Sandbox con el ID de tu cuenta de inscripción y una URL que dirija al archivo de inscripción.
En tu dispositivo que ejecuta la Versión preliminar para desarrolladores, anula la lista de inscripción con este comando.
adb shell device_config put adservices mdd_measurement_manifest_file_url "<insert URL provided>"
(Opcional pero recomendado) La anulación de verificación muestra la ruta establecida en el paso anterior.
adb shell device_config get adservices mdd_measurement_manifest_file_url
Activa una llamada a la API desde una de las APIs que preservan la privacidad. (p. ej.,
registerSource()
de la API de Attribution Reporting,getTopics()
de la API de Topics ojoinCustomAudience()
de la API de Protected Audience). Se espera que la llamada falle.Fuerza la ejecución del trabajo de descarga.
adb shell cmd jobscheduler run -f com.google.android.adservices.api 14
Ahora puedes comenzar a llamar a las APIs de preservación de la privacidad en la Versión preliminar para desarrolladores. La llamada que realizaste en el paso 4 debería completarse correctamente.
Cómo desactivar la inscripción
En las versiones preliminares para desarrolladores, puedes acceder a las APIs de Protected Audience y Topics sin necesidad de inscribirte si ejecutas los siguientes comandos de desactivación de adb
.
Protected Audience
adb shell setprop debug.adservices.disable_fledge_enrollment_check true
Topics
adb shell setprop debug.adservices.disable_topics_enrollment_check true
Informes de atribución
adb shell device_config put adservices disable_measurement_enrollment_check "true"