API del entorno de ejecución de SDK: Guía de integración

En este documento, se incluyen lineamientos que te ayudarán a prepararte para la integración del entorno de ejecución de SDK en casos de uso comunes.

Para ayudarte con la planificación de integración, este documento proporciona una vista integral del proceso de integración, que puede incluir funciones que aún no se implementaron en la etapa actual de Privacy Sandbox en la Vista previa para desarrolladores de Android. En estos casos, los detalles relacionados se marcarán como no implementados.

Objetivos de integración

En esta etapa de Privacy Sandbox en la Vista previa para desarrolladores de Android, los objetivos de la planificación de integración incluyen la capacidad de hacer lo siguiente:

  • Verificar la corrección técnica en el entorno de prueba
  • Verificar la compatibilidad con la infraestructura técnica existente
  • Definir y verificar los requisitos de integración

Casos de uso y funciones actualmente admitidas en la versión más reciente de la Vista previa para desarrolladores:

  • Carga remota y anuncios gráficos de banner
  • Escritura/lectura desde el almacenamiento
  • Comunicación bidireccional
  • Anuncios de video independientes

Próximamente, se lanzarán actualizaciones para la Vista previa para desarrolladores a fin de agregar compatibilidad con más casos de uso y funciones técnicas. A medida que estas funciones estén disponibles, se actualizará esta guía para reflejar los detalles relevantes.

  • Anuncios nativos 
  • Anuncios de pantalla completa

Requisitos previos

Pasos para la integración

1. Verifica la corrección técnica en el entorno de pruebas.

  • Crea una aplicación de prueba y un SDK de prueba para familiarizarte con Privacy Sandbox en el entorno de ejecución de SDK de Android. En esta etapa, también puedes comenzar con la app de ejemplo en GitHub.
  • Instala y ejecuta el SDK y la app en un dispositivo o emulador, y asegúrate de que WebView cargue la URL proporcionada.
  • Renderiza un anuncio en la app de forma remota desde el entorno de ejecución de SDK.
  • Agrega un punto de interrupción al código de SDK y conéctate al proceso para asegurarte de que sea depurable.

2. Verifica la compatibilidad con la infraestructura técnica existente.

  • Después de la Vista previa para desarrolladores, Privacy Sandbox en Android requerirá un nivel mínimo de API objetivo de 33. Identifica una ruta de migración para la base de código existente. Evalúa la compatibilidad de tu app o SDK con otros cambios introducidos en Android 13.
  • Verifica la compatibilidad de la cadena de herramientas de desarrollo con tu app, si corresponde.
  • Refactoriza tu base de código según sea necesario para reutilizar cualquier lógica común. Es posible que algunos desarrolladores prefieran tener una sola base de código. Si es tu caso, verifica la viabilidad de este enfoque.

3. Define y verifica los requisitos de integración.

  • Examina las necesidades de acceso a los datos de tu solución actual del SDK, el modelo de interacción con las apps cliente y los componentes del sistema en función del diseño del entorno de ejecución de SDK.
  • Verifica que el SDK se cargue; para ello, muestra uno de los tipos de anuncios compatibles del entorno de ejecución del SDK y verifica que el anuncio sea interactivo.
  • Si corresponde a tu caso de uso empresarial, verifica que las API de Topics, FLEDGE o Attribution Reporting se ejecuten desde el proceso del entorno de ejecución de SDK.
  • Verifica que el proceso del entorno de ejecución de SDK sea depurable adjuntando ADB o Android Studio y, luego, recorriendo tu código.