Comienza a usar Privacy Sandbox para Android

Privacy Sandbox en el programa de versiones beta de Android proporciona APIs estables. Planeamos lanzar varias versiones beta durante 2023. Puedes usar las versiones del programa beta para compilar y probar soluciones para pruebas de producción limitadas en dispositivos móviles Android 13. Empezaremos a admitir un pequeño porcentaje de dispositivos y aumentaremos la cantidad con el tiempo. Para participar, las organizaciones pueden solicitar acceso a una cantidad limitada de dispositivos, además de registrar cualquier app que use las APIs de Privacy Sandbox.

En el entorno de ejecución de SDK, tendremos una versión beta cerrada para que los desarrolladores prueben la distribución del SDK habilitado para el entorno de ejecución a fin de seleccionar apps.

Para usar la versión beta, los desarrolladores deben compilar sus soluciones con una actualización de la extensión del SDK de nivel de API 33.

Extensiones del SDK de Android

Las APIs estables en versiones beta se entregan usando el nuevo método de lanzamiento de las extensiones del SDK de Android. Este método de lanzamiento habilita el lanzamiento de funciones estables de Android entre las versiones principales. Presenta un nuevo mecanismo de control de versiones que pone nuevas APIs a disposición de las apps en varios niveles de API mediante las actualizaciones del sistema de Google Play. Privacy Sandbox en la extensión del SDK de Android se llama Extensiones de servicios de anuncios. Obtén más información sobre las extensiones del SDK de Android.

Comenzar

Para comenzar, sigue estos pasos:

Paso 1: Inscríbete en el programa de versión beta y regístrate

  • Inscripción: Completa el proceso de inscripción para usar las APIs relacionadas con los anuncios.
  • Regístrate: Debes register para participar en el programa de versión beta. El registro te permite hacer lo siguiente:
    • Habilitar tus propios dispositivos para realizar pruebas internas
    • Especificar un número limitado de apps publicadas en Google Play Store que puedan integrar directamente las APIs que preservan la privacidad o integrar soluciones del SDK que usen las APIs
    • Probar la distribución de SDK habilitados para el entorno de ejecución mediante Google Play Store (este paso no es necesario si solo quieres probar el entorno de ejecución de SDK en el dispositivo)

Paso 2: Configura tu entorno de desarrollo

Configura Privacy Sandbox en el SDK de Android en Android Studio.

Paso 3: Configura los permisos de AdServices

Declara permisos específicos de la API y configura el acceso al SDK para los recursos que administra la API objetivo.

Paso 4: Configura un dispositivo o una imagen del emulador

Si quieres realizar pruebas de extremo a extremo, debes interactuar con un dispositivo compatible con Android 13 o usar una imagen de emulador para la extensión de SDK adecuada.

Paso 5: Configura dispositivos para usar Privacy Sandbox en Android

Establece la configuración para habilitar (o inhabilitar) Privacy Sandbox en Android para que se ejecute en dispositivos.

Soluciona problemas conocidos

Para evitar problemas conocidos con la integración de la API de PP en dispositivos con Android 12 y versiones anteriores, los desarrolladores que integren APIs de servicios de anuncios para Android 12 y dispositivos anteriores deben hacer lo siguiente:

  1. Verifica que el archivo de manifiesto de la app cliente contenga la etiqueta <uses-library> de extservices. La etiqueta relevante es la siguiente:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Si usas la biblioteca androidx.privacysandbox.ads de Jetpack, asegúrate de usar la versión 1.1.0-beta05 o una posterior.

¿Qué recursos para desarrolladores hay disponibles?

Privacy Sandbox en el Programa de versiones beta de Android incluye los siguientes recursos y herramientas.

Imágenes del sistema para el SDK y el emulador

Con Android Studio, puedes descargar la versión más reciente de las extensión de servicios de anuncios y las imágenes del sistema del emulador a través de SDK Manager. Obtén más información para configurar tu entorno de desarrollo y configurar el acceso a las APIs.

Referencia de las APIs

La referencia de la API completa está disponible.

Asistencia y comentarios

A medida que realices pruebas y desarrollo con Privacy Sandbox en Android, consulta las notas de la versión y usa la Herramienta de seguimiento de errores para informar problemas y enviar comentarios.

Mantén tu entorno de desarrollo actualizado

Te recomendamos que mantengas tu entorno de desarrollo actualizado con la versión más reciente. Esto garantiza que tengas las funciones y los parches de seguridad más recientes, y que tu entorno sea compatible con las versiones más recientes de tus dependencias. Si quieres mantenerte al tanto de los nuevos lanzamientos, regístrate para recibir actualizaciones por correo electrónico.