La versión beta del programa Privacy Sandbox en Android proporciona APIs estables. Puedes usar las versiones del programa beta para compilar y probar soluciones para pruebas de producción limitadas en dispositivos móviles Android 13 y versiones posteriores para todas las APIs y Android 12 y versiones posteriores para la API de Attribution Reporting (ARA). 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 con el 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 con el nuevo método de lanzamiento de las extensiones del SDK de Android. Este método de lanzamiento habilita la versión estable de funciones de Android entre las versiones principales. Tiene 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 a usar Privacy Sandbox para Android, 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 registrarte 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 Si solo necesitas probar el entorno de ejecución de SDK en el dispositivo, este paso no es necesario.
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 del SDK a los recursos que administra la API de destino.
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
Configura 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 que ejecutan Android 12 y versiones anteriores, los desarrolladores que integren las APIs de servicios de anuncios para estos dispositivos deben hacer lo siguiente:
- Verifica que el archivo de manifiesto de la app cliente contenga la etiqueta extservices
<uses-library>. La etiqueta relevante es:
<uses-library
android:name="android.ext.adservices"
android:required="false" />
- Si usas la biblioteca de jetpack
androidx.privacysandbox.ads, 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 la API
La referencia de la API completa está disponible.
Asistencia y comentarios
A medida que realices pruebas y desarrollo con Privacy Sandbox en Android, revisa 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 recibir notificaciones sobre nuevos lanzamientos, regístrate para recibir actualizaciones por correo electrónico.