Cómo configurar dispositivos para usar Privacy Sandbox en Android

A medida que leas la documentación de Privacy Sandbox en Android, usa el botón Versión preliminar para desarrolladores o Beta para seleccionar la versión del programa con la que estás trabajando, ya que las instrucciones pueden variar.


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 el siguiente comando adb:

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

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
Figura 1: IU de control de usuario de Privacy Sandbox en un dispositivo Android.

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:

  1. 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.
  2. 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>"
    
  3. (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
    
  4. 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 o joinCustomAudience() de la API de Protected Audience). Se espera que la llamada falle.

  5. Fuerza la ejecución del trabajo de descarga.

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14
    
  6. 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"