Comienza a usar Privacy Sandbox para Android

El programa de versiones beta de Privacy Sandbox en Android proporciona APIs estables. Somos y planificas varios lanzamientos beta a lo largo de 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 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 paso del 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.

Para el entorno de ejecución de SDK, tenemos una versión beta cerrada para que los desarrolladores la prueben. Distribución del SDK habilitado para el entorno de ejecución para seleccionar apps.

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

Extensiones del SDK de Android

Las APIs estables en versiones beta se entregan a través de las nuevas extensiones del SDK de Android método de lanzamiento. Este método permite lanzar versiones 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

  • Inscribirse: Completa el proceso de inscripción para usan las APIs relacionadas con anuncios.
  • Regístrate: Debes registrarte para participar en el programa de versión beta. El registro te permite:
    • 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 API y configura el acceso al SDK para recursos administrados por la API objetivo.

Paso 4: Configura un dispositivo o una imagen del emulador

Para realizar pruebas de extremo a extremo, debes interactuar con un Android 13 compatible dispositivo o usa una imagen de emulador para la extensión del 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 con Android 12 y versiones anteriores, los desarrolladores que integren las APIs de servicios de anuncios para dispositivos Android 12 y versiones anteriores deben hacer lo siguiente:

  1. Verifica que el archivo de manifiesto de la app cliente contenga la etiqueta extservices <uses-library>. La etiqueta relevante es la siguiente:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. 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 la versión notas 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 más recientes parches de seguridad y que tu entorno es compatible con los de tus dependencias. Para recibir notificaciones sobre los lanzamientos nuevos, regístrate para recibir actualizaciones por correo electrónico.