Notas de la versión

Privacy Sandbox en Android ofrece programas de versión beta y una Versión preliminar para desarrolladores. Incorporaremos nuevas APIs y funciones en la Versión preliminar para desarrolladores con el tiempo y promoveremos las APIs estabilizadas en el programa de versión beta. Recomendamos compartir cualquier comentario pertinente.

Si aún no estás familiarizado con Privacy Sandbox en Android, consulta la Descripción general del programa. Para comenzar a compilar Privacy Sandbox en tu proyecto, configura tu entorno de desarrollo y obtén Privacy Sandbox en Android en tu dispositivo de prueba o emulador.

Versiones actuales

Versión preliminar de Android VanillaIceCream

Esta versión incluye las APIs de Privacy Sandbox en la versión preliminar de Android VanillaIceCream. Las imágenes del SDK y el emulador están disponibles para descargar en Android Studio como versión preliminar de Android VanillaIceCream. Esta versión incluye la misma funcionalidad que la Versión preliminar para desarrolladores 10 lanzada anteriormente, con los cambios adicionales que se enumeran a continuación.

API de Protected Audience

  • Se agregó la capacidad de pasar anuncios contextuales autenticados a una subasta protegida. Esto también incluye el filtrado negativo para las apps ya instaladas en el dispositivo, así como la limitación de frecuencia en la cantidad de clics, impresiones, vistas o victorias. La implementación difiere de las iteraciones anteriores, ya que es necesario que la tecnología publicitaria firme los anuncios contextuales. Obtén información para implementar esto en la guía para desarrolladores.
  • Se cambió el nombre de ContextualAds a SignedContextualAds junto con el método get y set relacionados en AdSelectionConfig; getPerBuyerSignedContextualAds y setPerBuyerSignedContextualAds.
  • Si se pasa una app contextual no autenticada, se quitará de la subasta.

API de Attribution Reporting

Actualización beta de noviembre de 2023 de Privacy Sandbox en Android

En esta versión de Privacy Sandbox en Android beta, se incluyeron actualizaciones de las APIs de Privacy Sandbox en dispositivos públicos con Android 14. El SDK y las imágenes del dispositivo están disponibles para descargar a través de SDK Manager de Android Studio como API 34 de Android y nivel 10 de extensión, y es funcionalmente similar a la Versión preliminar para desarrolladores 9, con un algunas modificaciones clave.

API de Protected Audience

  • Las tecnologías publicitarias ahora pueden usar la delegación de público personalizado para unirse a un público personalizado en nombre de un comprador que no tiene presencia en el dispositivo.
  • Android ahora admite la ejecución de una subasta en los servicios de ofertas y subastas.
  • Las subastas de Protected Audience admiten la facturación de CPC.
  • Las subastas y los informes de Protected Audience ahora admiten encabezados de versión de datos para los indicadores de ofertas confiables.
  • Las subastas de Protected Audience admiten el filtrado de limitación de frecuencia en eventos WIN.
  • Protected Audience ahora admite la integración con la API de Attribution Reporting.

API de Attribution Reporting

Entorno de ejecución de SDK

  • El SDK puede cargar otros SDKs dentro del entorno de ejecución de SDK para admitir casos de uso de mediación. ## Versiones anteriores

Versión preliminar para desarrolladores 10

Fecha de lanzamiento: 19 de diciembre de 2023

Limitaciones conocidas

  • Hay un problema que provoca que los Servicios de Google Play fallen en segundo plano y le informen al usuario de forma reiterada:
    • Reiniciar el dispositivo podría solucionar el problema.
    • Durante la prueba, si tienes problemas con el tiempo de espera de las llamadas asíncronas, intenta agregar el siguiente comando adb para alargar el umbral hasta que se agote el tiempo de espera:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Solo para dispositivos físicos: No se puede agregar una Cuenta de Google. Sigue estos pasos para llevar el dispositivo a la pantalla principal:
    • Instala la imagen de vista previa en el teléfono.
    • Sigue los pasos del asistente de configuración sin conectarte a Wi-Fi ni a datos móviles.
    • Cuando estés en la pantalla principal, conéctate a una red Wi-Fi o de datos móviles.
    • Reinicia el dispositivo.

API de Protected Audience

  • Estamos actualizando la forma en que los anuncios de la ruta contextual pueden participar en una subasta protegida. Se quitaron los siguientes métodos y clases de esta Versión preliminar para desarrolladores:
    • AdSelectionConfig.getBuyerContextualAds()
    • AdSelectionConfig.Builder.setBuyerContextualAds()
    • AdSelectionManager.setAppInstallAdvertisers()
    • ContextualAds
    • AdWithBid
    • AppInstallFilters
  • Se cambió el nombre de ReportInteractionRequest por ReportEventRequest
  • Presentamos nuevas funciones, los Indicadores de apps protegidas, para admitir la publicación de anuncios relevantes de instalación de aplicaciones. Con esta DP, lanzamos APIs para que las tecnologías publicitarias logren lo siguiente:
    • Selecciona indicadores mediante el almacenamiento de eventos de apps en un almacenamiento protegido en el dispositivo, que se usa para publicar anuncios relevantes de instalación de apps.
    • Ejecutar una subasta protegida en servicios de ofertas y subastas que se ejecuten en entornos de ejecución confiables en los que puedan acceder a sus respectivos indicadores para ayudar en la selección de anuncios y las ofertas

API de Attribution Reporting

  • Esta versión de la API de Attribution Reporting hace lo siguiente:
    • Agrega la integración de Protected Audience, que habilita dimensiones de públicos personalizados en los informes agregados de resumen.
    • Admite el proveedor de Google Cloud como un TEE para el servicio de agregación.
    • Se agregó el campo shared_debug_key para admitir la depuración de la atribución entre redes sin redireccionamientos.
    • Agrega encabezados de la versión en las solicitudes de informes detallados de depuración.

Personalización integrada en el dispositivo

  • Lanzamiento inicial para investigadores y etapas iniciales de desarrollo.
  • La personalización integrada en el dispositivo presenta una forma innovadora de personalizar productos y servicios, a la vez que proporciona una mejor protección de la privacidad del usuario final. La personalización integrada en el dispositivo proporciona un conjunto de servicios y algoritmos como componentes básicos para lograrlo, incluidos, sin limitaciones, los siguientes:
    • Procesamiento federado (FC) que permite entrenar, evaluar y personalizar modelos mediante aprendizaje federado. El uso de procesamiento federado por parte de la personalización integrada en el dispositivo se basará en el entrenamiento de modelos y la inferencia (opcional si es necesario).
    • Coincidencia basada en filtros de Cucú y coincidencia cruzada entre datos ubicados de manera diferenciada.
    • Entrenamiento con privacidad diferencial (DP) de modelos dispersos mediante técnicas nuevas como la minimización alternativa de DP (para entrenar con datos ubicados de manera dispar) y la personalización de modelos en billboard DP.

Versión preliminar para desarrolladores 9

Fecha de lanzamiento: 15 de agosto de 2023

Limitaciones conocidas

  • Los datos de subasta que se generan con una llamada a la API de Bidding and Auction no se borran automáticamente en la Versión preliminar para desarrolladores 9.
  • Llamar a getAdSelectionData y a persistAdSelectionResult cuando se revoca el consentimiento hace que falle el proceso.
  • La función de filtrado negativo no funciona con getAdSelectionData ni persistAdSelectionResult.

API de Protected Audience

  • Las tecnologías publicitarias ahora pueden usar la delegación de público personalizado para unir un público personalizado a un llamador integrado en el dispositivo.
  • Android ahora admite la ejecución de una subasta en los servicios de ofertas y subastas: las subastas de Protected Audience admiten la facturación de CPC.
  • La API de Report Interactions ahora se llama reportEvent.
  • El método de limitación de frecuencia y los tipos de contador cambiaron de nombre.
  • Los informes de depuración están disponibles para obtener información sobre por qué se perdió una subasta o para identificar problemas en la lógica de JavaScript.

API de Attribution Reporting

  • Esta versión mejora los informes de depuración de la API de Attribution Reporting de la siguiente manera:
    • Admiten los informes de depuración detallados que son compatibles con la Web.
    • Habilitan los informes de depuración de atribución en la Web y en apps (se requiere el ID del anuncio en el registro web y de apps).
  • La tecnología publicitaria puede configurar parámetros de ruido para diferentes casos de los informes.
  • Esta versión se traslada a la atribución basada en el origen, es decir:
    • El origen se usa para el registro.
    • Se aceptan múltiples orígenes en un solo sitio.
    • Un nuevo límite de frecuencia de un origen por app de origen o una inscripción.
  • Las tecnologías publicitarias ahora pueden inhabilitar la inscripción para probar casos de uso de Informes de atribución de forma local.

Entorno de ejecución de SDK

  • El SDK solo puede iniciarse o vincularse a una lista de entidades permitidas de servicios.
  • El SDK solo puede acceder a un subconjunto del sistema ContentProvider (como com.android.providers.settings.SettingsProvider), donde los datos obtenidos no tienen identificadores y no se pueden usar para crear una huella dactilar del usuario. Estas verificaciones también se aplican al acceso a ContentProvider con ContentResolver.
  • El SDK solo puede acceder a un subconjunto de receptores de emisión protegidos (como android.intent.action.AIRPLANE_MODE).
  • El SDK puede iniciar una actividad que pertenezca a otra app, pero con límites sobre lo que se puede enviar en el intent.

Actualización beta de marzo de 2023 de Privacy Sandbox en Android

En la versión de marzo de 2023 de Privacy Sandbox en Android beta, se incluyeron actualizaciones de las APIs de Privacy Sandbox en dispositivos públicos con Android 13. Esta versión incluye las APIs de Extensiones de servicios de anuncios 5 y es funcionalmente similar a la Versión preliminar para desarrolladores 6, con algunas modificaciones clave.

Limitaciones conocidas

  • El proceso de recuperación en segundo plano que se ejecuta de forma periódica para actualizar los públicos personalizados de FLEDGE hace que el proceso falle. Debido a este problema, FLEDGE está inhabilitado de forma predeterminada.

General

  • Puedes usar la API de Attribution Reporting a partir de esta versión. La API se inhabilitó con anterioridad. Si usaste la API de Attribution Reporting en la versión beta anterior, borra los datos de la app o del dispositivo antes de usar esta versión beta mediante uno de los siguientes pasos:
    • En un dispositivo o emulador, ve a Configuración y borra el almacenamiento específico de la app (no solo la caché) de las apps que se usen para pruebas.
    • Restablece la configuración de fábrica del dispositivo físico o emulado.
    • Para un dispositivo emulado, realiza una función Wipe Data.
  • Los Informes de atribución ahora admiten claves de depuración, lo que permite a los desarrolladores recibir informes sin cambios y, además, informes de privacidad mejorada de la API de Attribution. Las claves de depuración permiten obtener mayor visibilidad de la estructuración de los informes durante la transición a Privacy Sandbox.
  • Recientemente, los Informes de atribución experimentaron un error con los Servicios de anuncios en el que registerSource y registerTrigger fallaban con excepciones. Si experimentaste estos problemas durante el desarrollo, se lanzó una corrección y esos problemas deberían resolverse con el tiempo.
  • La función de vista previa de la API de Topics ahora tiene paridad con Privacy Sandbox en las Versiones preliminares para desarrolladores. Un llamador de la API de Topics puede obtener una vista previa de los temas sin incluir la llamada de recuperación de temas en el cálculo semanal del ciclo de entrenamiento o sin afectar la lista de temas observados del emisor. Consulta el campo shouldRecordObservation para obtener más detalles.
  • Para habilitar las pruebas de FLEDGE en Android, regístrate en el programa de versión beta y usa esa misma Cuenta de Google para acceder a tus dispositivos de prueba. De lo contrario, los intentos de llamar a las APIs generarán una IllegalStateException con el mensaje "Service is not available". FLEDGE debería restablecerse en la próxima versión beta.

    Mientras tanto, las pruebas con las Versiones preliminares para desarrolladores pueden continuar y se recomiendan, y FLEDGE se puede habilitar de forma manual en dispositivos con las siguientes advertencias:

    Puedes habilitar FLEDGE con los siguientes comandos adb. Sin embargo, esto hace que el proceso de recuperación en segundo plano falle, lo que afecta negativamente las métricas de estado del sistema. Esta no es una solución permanente, ya que la plataforma puede restablecer estos valores.

    adb shell device_config set_sync_disabled_for_tests persistent
    adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
    adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
    adb shell device_config put adservices fledge_background_fetch_enabled true
    

Versión preliminar para desarrolladores 8

Fecha de lanzamiento: 23 de mayo de 2023

Limitaciones conocidas

  • Si bien se pueden agregar filtros de limitación de frecuencia de tipo WIN a los anuncios de Protected Audience, el tipo WIN aún no se admite, y se ignoran los filtros de este tipo.
  • Para informar las impresiones ganadoras a los compradores ganadores de las subastas de Protected Audience, los compradores deben estar inscritos en Privacy Sandbox. Este requisito no se puede anular.
  • Para acceder a la configuración de Privacy Sandbox en un dispositivo que tenga disponible esta función, ve a Configuración > Google > Anuncios > Privacy Sandbox.
  • No se pueden implementar proyectos con emuladores en Android Studio Giraffe. Las otras versiones de Android Studio deberían funcionar bien. Se lanzará una solución para Android Studio Giraffe el 26 de mayo de 2023.

API de Protected Audience

API de Attribution Reporting

  • Se agregaron filtros del activador OR. Esto significa que los filtros ahora consisten en un conjunto de filtros, que es una lista de mapas de filtros. Si ninguno de los mapas de filtros del conjunto coincide con los datos de filtros de la fuente, se ignora el objeto event_trigger_data.
  • Se desacoplaron la ventana de informes y el vencimiento de impresión para las APIs a nivel de evento y las de agregación.
  • Se incorporó la compatibilidad con claves de anulación de duplicación en informes agregables.
  • Se agregó scheduled_report_time a los informes de eventos de paridad con Privacy Sandbox para la Web.
  • Se implementó la atribución de varias redes sin redireccionamientos.

Entorno de ejecución de SDK

Versión preliminar para desarrolladores 7

Fecha de lanzamiento: 26 de enero de 2023

FLEDGE en la API de Android

  • Se cambió el nombre del parámetro custom_audience_signals en los siguientes métodos de JavaScript:
    • Se cambió el nombre de generateBid() a custom_audience_bidding_signals.
    • Se cambió el nombre de scoreAd() a custom_audience_scoring_signals.
    • Se cambió el nombre de reportWin() a custom_audience_reporting_signals.
  • En esta versión, se agrega una anulación de selectAds nueva que toma AdSelectionFromOutcomeConfig para comparar los resultados de selectAds. Esto permite que los SDKs de AdTech que aprovechen esta API ejecuten la mediación en cascada. Puedes encontrar más detalles en la guía para desarrolladores.
  • La API de selectAds() ahora admite el almacenamiento en caché para la lógica de ofertas y puntuación que obtiene JavaScript durante el proceso de selección de anuncios.
    • La caché se puede controlar con los encabezados Cache-Control que muestran los servidores durante la llamada de recuperación de JavaScript. Usa no-cache o no-store para evitar que las respuestas de JavaScript se almacenen en caché y max-age para controlar la duración de la caché.
    • La entrada de caché actual max-age se establece en dos días de forma predeterminada.

Informes de atribución en la API de Android

  • Esta versión agrega compatibilidad con redireccionamientos de encadenamiento para registerSource() y registerTrigger(). El consumidor de la API ahora puede usar un redireccionamiento HTTP como respuesta del servidor.

Versión beta inicial, enero de 2023

Fecha de lanzamiento: 9 de enero de 2023

Privacy Sandbox en Android en la versión beta 1 representa la primera disponibilidad de las APIs de Privacy Sandbox en dispositivos públicos y agrega mejoras a las áreas que se enumeran a continuación.

General

  • Privacy Sandbox en Android versión beta 1 es equivalente en términos funcionales a la Versión preliminar para desarrolladores 5, con algunas funciones y limitaciones adicionales que se detallan a continuación.
  • Los desarrolladores deben completar un proceso de inscripción para usar las APIs relacionadas con los anuncios (incluidas Topics, FLEDGE y Attribution Reporting). El proceso de inscripción verifica la identidad del desarrollador y recopila los datos específicos del desarrollador que necesitan las APIs.
  • Con la versión beta 1 de Privacy Sandbox en Android, los desarrolladores que se hayan inscrito y enviado detalles a la lista de entidades permitidas tendrán la oportunidad de probarla en sus propios dispositivos físicos. Para desarrollar en función de las APIs estables en la versión, descarga las nuevas Extensiones de servicios de anuncios de SDK 4.

API de Topics

API de Attribution Reporting

  • La API de Attribution Reporting se inhabilitó y no está disponible para su uso en esta versión. Se debería volver a habilitar el acceso a esta API en la próxima versión beta. Te recomendamos que continúes realizando pruebas con la Versión preliminar para desarrolladores.

Entorno de ejecución de SDK

Se espera que las siguientes limitaciones se corrijan en la próxima versión importante de la plataforma de Android:

  • Actualmente, la renderización de anuncios dentro de una vista desplazable como RecyclerView no funciona correctamente. Es posible que se produzca un bloqueo si se cambia el tamaño del elemento. Los eventos de desplazamiento del usuario táctiles no se pasan correctamente al entorno de ejecución.
  • El procesamiento de WebView no está disponible en el proceso del entorno de ejecución de SDK.
  • El almacenamiento por SDK no está disponible.
  • La compatibilidad con las APIs de getAdId y getAppSetId aún no está activada.

Versión preliminar para desarrolladores 6

Fecha de lanzamiento: 31 de octubre de 2022

Privacy Sandbox en la Versión preliminar para desarrolladores de Android 6 agrega mejoras en las siguientes áreas:

General

  • Como preparación para el lanzamiento a producción, la Versión preliminar para desarrolladores 6 introdujo una marca para inhabilitar el acceso a la API que preserva la privacidad de forma predeterminada. Para realizar pruebas, habilita el acceso a la API que preserva la privacidad en la Versión preliminar para desarrolladores mediante la ejecución del siguiente comando:

    adb shell device_config put adservices global_kill_switch false
    
  • Las APIs de AdIdManager y AppSetIdManager requieren la versión 22.36.16 o una posterior de los Servicios de Google Play.

    • En un dispositivo Android, verifica que la versión correcta aparezca en Configuración > Apps > Servicios de Google Play.
    • Si necesitas actualizar los Servicios de Google Play a la versión adecuada, accede al emulador o al dispositivo de prueba Android con una Cuenta de Google. Luego, ve a Google Play Store > ícono de perfil > Configuración > Acerca de. Debajo del encabezado Versión de Play Store, presiona Actualizar Play Store.
    • Este paso solo es aplicable para el desarrollo y las pruebas, y no será necesario después de que se haya implementado Privacy Sandbox en los usuarios públicos.

API de Topics

  • Se agregó una API de Preview para activar o desactivar si getTopics se registra como observador
  • Se realizaron cambios menores en el código de inicialización para la clase GetTopicsRequest.
  • Lanzamiento de la Guía de integración de temas

FLEDGE en la API de Android

  • Si realizas pruebas en servidores reales, ahora se habilita la API. Sigue estos pasos para configurar tu dispositivo. Estos pasos no son necesarios si usas las anulaciones remotas presentes en la app de ejemplo.
  • Cambios rotundos:
    • Se reemplazó Url en los parámetros por Uri. Esto se aplica a todas las APIs de FLEDGE y JavaScript personalizado para las ofertas y la lógica de puntuación.
    • Se quitó el campo owner de las entradas de la API de Custom Audience.
  • Los públicos personalizados incompletos ahora son aptos de inmediato para la actualización en segundo plano.
  • El límite de memoria de JavaScript ahora está configurado en 10 MB. Esto se aplica a la lógica de las ofertas y la puntuación.

API de Attribution Reporting

  • Las tecnologías publicitarias deben inscribirse antes de que puedan usar la API de Attribution Reporting en la Versión preliminar para desarrolladores 6. Consulta Inscríbete para obtener una cuenta de Privacy Sandbox para obtener más información.
  • En esta versión, se presentan claves de depuración, que permiten a los desarrolladores recibir informes sin cambios junto con informes de privacidad mejorada de la API de Attribution Reporting. Las claves de depuración permiten obtener una mayor visibilidad de cómo se estructuran los informes durante la transición con Privacy Sandbox.

Versión preliminar para desarrolladores 5

General

  • Antes de acceder a las APIs de Privacy Sandbox en la Versión preliminar para desarrolladores 5, primero debes habilitar las APIs y configurar los permisos específicos de la API.
    • Los diseños para Privacy Sandbox en Android permiten a los usuarios controlar si sus APIs que preservan la privacidad y el entorno de ejecución del SDK están activos en sus dispositivos. Estos parámetros se configuran como inhabilitados de forma predeterminada en la Versión preliminar para desarrolladores 5. Puedes habilitar el acceso a la API mediante un comando adb.
    • La app que realiza la llamada debe especificar permisos específicos de la API en el manifiesto y las configuraciones de AdServices relacionadas que controlen el acceso de los SDKs incorporados.
  • Las apps deben llamar a las APIs que preservan la privacidad cuando se ejecutan en primer plano.
  • AdIdManager y AppSetIdManager no están funcionando en este momento. Se habilitarán en una versión posterior.

Entorno de ejecución de SDK

  • sendData() dejará de estar disponible en una versión futura.
  • loadSdk() ahora muestra un objeto IBinder para facilitar la comunicación bidireccional entre el SDK habilitado para el entorno de ejecución y las apps definidas en AIDL.
  • Las apps tienen acceso a eventos de ciclo de vida del SDK adicionales habilitados para el entorno de ejecución, como cuando finaliza el proceso del SDK.

API de Attribution Reporting

En esta versión, se presentan funciones adicionales en la API de Attribution Reporting, incluidas las siguientes:

  • Compatibilidad con informes de agregación encriptados.
  • Compatibilidad con mediciones web y entre aplicaciones.
  • Encabezados consolidados en las respuestas de registro de la fuente y el activador:
    • Fuente: Attribution-Reporting-Register-Aggregatable-Source ahora es parte de Attribution-Reporting-Register-Source
    • Activador: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data y Attribution-Reporting-Register-Aggregatable-Values se consolidaron en un solo encabezado llamado Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects sigue siendo un encabezado independiente

FLEDGE en la API de Android

Esta versión incluye varias funciones y mejoras nuevas, además de cambios rotundos:

  • Cambios rotundos:
    • Se cambió el nombre de runAdSelection() por selectAds().
    • Se reemplazó el parámetro de AdSelectionConfig.Builder.setAdSelectionSignals() por AdSelectionSignals, que representa un objeto JSON.
    • Se reemplazó el uso de String para representar a un comprador o vendedor de tecnología publicitaria con el objeto AdTechIdentifier.
    • Se agregaron las clases TestCustomAudienceManager y TestAdSelectionManager para anular la recuperación remota de JavaScript.
    • El propietario de un público personalizado debe ser el nombre del paquete de la app que realiza la llamada.
  • Las APIs de FLEDGE ahora validan la app que realiza la llamada con un conjunto de restricciones y limitaciones que se describen en la guía para desarrolladores. A continuación, se muestran algunos ejemplos notables.
    • selectAds y reportImpression ahora tienen límites de tiempo de ejecución. Después de esa fecha, se finalizará la llamada.
    • selectAds y reportImpression ahora tienen un límite para la memoria consumida durante la ejecución de JavaScript. Las APIs mostrarán un error si el consumo de memoria supera los límites configurados.
    • selectAds y reportImpression ahora validan el objeto AdSelectionConfig para garantizar que los campos sean sintácticamente válidos y que las URLs estén en el eTLD+1 que se usa en el campo del vendedor.
    • AdServices ahora valida los públicos personalizados en el momento de la creación. Parte de esta validación incluye garantizar que la hora de vencimiento sea válida y aplicar un límite a la cantidad de públicos personalizados que puede crear una app y el tamaño total de los anuncios que se proporcionan en la llamada joinCustomAudience. La validación también implica que los URIs proporcionados para la recuperación de la lógica de ofertas y de los indicadores y la recuperación en segundo plano se encuentran en el dominio del comprador.
  • Los metadatos de público personalizados se actualizan a diario con un proceso de recuperación en segundo plano.
  • Los públicos personalizados se quitan cuando se desinstala la app de "propietario".
  • Se agregó compatibilidad para especificar indicadores de puntuación y datos de ofertas de confianza durante la selección de anuncios. Consulta la muestra de código para conocer el formato de respuesta.
  • FLEDGE para las APIs de Android depende de la versión de WebView 105.0.5195.58 o una posterior. A fin de obtener más información, consulta la información de configuración en la guía para desarrolladores.
  • Problemas conocidos:

    • Por el momento, cuando te unes a un público personalizado, la plataforma no realiza actualizaciones en segundo plano de inmediato si alguno de los metadatos o los valores de AdData está vacío o es null. El público personalizado no será apto para las selecciones de anuncios hasta que se actualice un día después. Una versión futura hará que los públicos personalizados incompletos sean aptos de inmediato para actualizaciones en segundo plano. El límite de memoria predeterminado actual para la ejecución de JavaScript es demasiado bajo y puede provocar que las cargas de trabajo normales fallen en JavascriptEngine en los dispositivos. Tu ejecución de JavaScript puede terminar de forma inesperada con el mensaje de error "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      Puedes resolver esto de manera manual si configuras el umbral de memoria adecuado con el siguiente comando:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"
      
    • Los anuncios de público personalizados que no coinciden con la estructura JSON requerida se actualizan durante la recuperación en segundo plano.

API de Topics

  • Se actualizó la taxonomía a fin de clasificar las apps para dispositivos móviles.
  • Se actualizaron la propuesta de diseño y las apps de ejemplo con el lanzamiento de la IU de configuración para ver los temas asignados.

Actualizaciones de herramientas

Android Studio Canary es compatible con la compilación de APKs de SDK con un nuevo tipo de módulo. Se actualizó la Guía para desarrolladores del entorno de ejecución del SDK, y las apps de ejemplo de Privacy Sandbox en GitHub reflejan esta actualización.

Versión preliminar para desarrolladores 4

Fecha de lanzamiento: 14 de julio de 2022

Privacy Sandbox en la Vista previa para desarrolladores de Android 4 agrega mejoras a las siguientes áreas:

Entorno de ejecución de SDK

  • Las apps ahora pueden comunicarse con los SDKs habilitados para el entorno de ejecución (SDKs de RE) con la adición de sendData().
  • El almacenamiento local ahora está disponible en el proceso del entorno de ejecución de SDK.
  • Un SDK también puede renderizar anuncios o contenido de video independientes en el entorno de ejecución del SDK.
  • Se agregaron aclaraciones sobre el uso de reflejo para incluir la capacidad de usar la reflexión, siempre que el contenido no esté en otro SDK de RE.

API de Attribution Reporting

Esta versión introduce cambios para mejorar la claridad en lo que respecta al uso de la API de Attribution Reporting, como los siguientes:

  • Cambios en el formato de informe agregado para mejorar la legibilidad
  • Campos actualizados de encabezado de las funciones de filtrado de conversiones y ofertas
  • Aclaraciones añadidas en la referencia de la API de WebApp para explicar el registro fuente y de activación, así como la disponibilidad y privacidad de la API de consentimiento.

FLEDGE en la API de Android

Esta versión incluye nuevas funciones para ayudar en las pruebas y la depuración, así como mejoras internas:

  • Agregamos compatibilidad con la anulación de URL remotas para recuperar la lógica de JavaScript durante el desarrollo.
  • Mejoramos los informes de errores generados durante la selección de anuncios.
  • Los públicos personalizados inactivos ahora se filtran durante la selección de anuncios.

API de Topics

Esta versión incluye varios cambios significativos en la API de Topics, el más importante:

  • El tipo de datos que se muestra de la API de getTopics() se cambió al nuevo tipo de objeto Topic, que encapsula IDs enteros que corresponden a Topics en la taxonomía, la información sobre las versiones del clasificador y la taxonomía. Debes actualizar cualquier app existente con esta API.
  • La API de Topics ahora requiere un nuevo permiso normal.
  • Se agregó el sistema "Clasificador integrado en dispositivo" para asignar Topics de forma dinámica según la información disponible públicamente en la app.

Errores conocidos

  • La versión inicial de estas imágenes de dispositivos (revisión 6) no se carga en la versión 31.2.10 del emulador de Android. Las imágenes de dispositivos actualizadas que abordan el problema están disponibles desde el 27 de julio de 2022.

Versión preliminar para desarrolladores 3

Fecha de lanzamiento: 9 de junio de 2022

Privacy Sandbox en la Vista previa para desarrolladores 3 de Android agrega funcionalidad para la API de Attribution Reporting y FLEDGE en Android.

API de Attribution Reporting

La API de Attribution Reporting mejora la privacidad del usuario, ya que quita la dependencia de los identificadores de usuario entre varias partes y admite casos de uso clave para la medición de atribución y conversión en apps.

Esta versión incluye recursos para desarrolladores que te ayudarán a probar las siguientes funciones de la API de Attribution Reporting:

  • Registrar la fuente de atribución y los eventos del activador
  • Ejercer una atribución priorizada por la fuente y posterior a la instalación
  • Recibir informes de eventos
  • Recibir informes agregables, que no estén encriptados en esta versión

Se proporcionan una app de ejemplo y un servidor de tecnología publicitaria de referencia para ayudar en las pruebas.

Problemas conocidos:

FLEDGE en Android

FLEDGE en Android presenta una nueva forma de mostrar anuncios en función de públicos personalizados definidos por los desarrolladores de apps y las interacciones dentro de ellas. Esta solución almacena la información y los anuncios asociados de forma local, y proporciona un framework para organizar los flujos de trabajo de selección de anuncios.

Esta versión incluye recursos para desarrolladores que te ayudarán a probar las siguientes funciones de FLEDGE en Android:

  • Unirse a un público personalizado o abandonarlo y observar cómo los valores de los parámetros pueden afectar los resultados de la subasta
  • Obtener el código de subasta de JavaScript desde extremos remotos
  • Configurar e iniciar subastas de anuncios en el dispositivo
  • Controlar los informes de impresiones
  • Se proporcionan una app de ejemplo y parámetros de configuración de un servidor simulado para ayudar con las pruebas.

Problemas conocidos:

  • Un público personalizado puede participar en la selección de anuncios incluso antes de su "hora de activación".

Versión preliminar para desarrolladores 2

Fecha de lanzamiento: 17 de mayo de 2022

La Vista previa para desarrolladores 2 incluye vistas previas de las API de Informes de atribución de MeasurementManager.

  • Puedes llamar a registerSource() y registerTrigger() a fin de registrar eventos de anuncios de aplicación y recibir datos de informes a nivel del evento para la atribución entre apps. Nuestra implementación actual usa la atribución de último contacto. Los informes están programados para enviarse según lo definido por las ventanas de informes. Consulta la referencia de la API de MeasurementManager para obtener más información.
  • La carga real del informe se produce al final de intervalos fijos y no en la hora programada exacta. El intervalo para subir informes es de 4 horas de forma predeterminada, pero se puede anular con el siguiente comando adb:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>
    
  • Se publicará una app de ejemplo y un servidor de tecnología publicitaria para probar las APIs en una versión futura.

  • Otras funciones de la API de Attribution Reporting de MeasurementManager, como los informes agregados, la atribución posterior a la instalación y los redireccionamientos estarán disponibles en una versión posterior.

Versión preliminar para desarrolladores 1

Fecha de lanzamiento: 28 de abril de 2022

La Vista previa para desarrolladores 1 incluye vistas previas iniciales de la API de Topics y el entorno de ejecución del SDK. La funcionalidad para FLEDGE en Android y las API de Attribution Reporting estarán disponibles en una versión futura.

  • API de Topics
    • Por el momento, la API de getTopics() muestra valores de prueba basados en la clasificación sin conexión de un conjunto limitado de apps. Todavía no se implementaron las clasificaciones integradas en el dispositivo.
    • Puedes usar comandos adb para anular los intervalos de época y forzar o activar el cálculo de la época.
    • Consulta la Guía para desarrolladores de Topics a fin de obtener más detalles.
  • Entorno de ejecución del SDK
    • Puedes empaquetar y compilar SDKs habilitados para el entorno de ejecución (SDKs de RE) con el nuevo elemento <sdk-library> en el archivo de manifiesto de tu app del SDK. Instala los SDK de RE en un emulador o dispositivo de prueba compatible, de la misma forma que lo harías normalmente en una app durante el desarrollo.
    • Puedes integrar una app con los SDKs de RE, cargarlos en el entorno de ejecución de SDK y probar el impacto del acceso restringido en el código del SDK (permisos, memoria y comunicaciones de la app al SDK). Todavía no se implementaron las APIs de Storage para los SDKs de RE, pero estarán disponibles en una versión futura.
    • Un SDK puede renderizar anuncios de banner basados en WebView o contenido en el entorno de ejecución del SDK.
    • Si deseas obtener más información, consulta la guía para desarrolladores del entorno de ejecución del SDK.
  • Verificaciones de lint de Android
    • Las verificaciones de lint de Android pueden mostrar advertencias incorrectas en proyectos compilados con el nivel de API TiramisuPrivacySandbox. Por ejemplo, es posible que veas el mensaje de advertencia "La llamada requiere el nivel de API 33". Puedes solucionar de forma temporal este problema mediante la anotación @SuppressLint("NewApi").