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
API de Protected Audience
- Se agregó la capacidad de pasar anuncios contextuales autenticados en 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 para 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 los métodos get y set relacionados en AdSelectionConfig. getPerBuyerSignedContextualAds y setPerBuyerSignedContextualAds.
- Si se pasa una app contextual no autenticada, esta se quitará de la subasta.
API de Attribution Reporting
- Se agregó la capacidad de descartar una fuente si la app ya está instalada en el dispositivo.
- Se actualizaron los informes de eventos parcialmente flexibles a informes de eventos completamente flexibles.
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
- La API de Attribution Reporting ahora admite la integración con Protected Audience.
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
- Existe un problema que causa que los Servicios de Google Play fallen en la
antecedentes y le informan repetidamente al usuario:
- Reiniciar el dispositivo podría solucionar el problema.
- Durante la prueba, si tienes problemas con el tiempo de espera de las llamadas asíncronas, agrega el siguiente comando adb para alargar el umbral hasta 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
- Presentamos nuevas funciones, [indicadores de apps protegidos][dp98],
para admitir la publicación
de anuncios de instalación de aplicación relevantes. Con esta DP, lanzaremos
APIs para permitir que las tecnologías publicitarias hagan lo siguiente:
- Selecciona indicadores guardando eventos de apps en un almacenamiento integrado y protegido en el dispositivo que se usan para publicar anuncios de instalación de aplicación relevantes.
- Ejecuta una subasta protegida en los servicios de ofertas y subastas que se ejecutan en entornos de ejecución confiables en los que pueden acceder a sus respectivos indicadores para ayudar en la selección y las ofertas de anuncios.
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 el público personalizado. dimensiones en los informes agregados de resumen.
- Admite el proveedor de Google Cloud como un TEE para el servicio de agregación.
- Agrega el campo shared_debug_key para admitir la depuración de atribuciones entre varias 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 brinda una protección mejorada 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:
- El procesamiento federado (FC), que permite entrenar, evaluar y personalizar modelos con el aprendizaje federado; Uso de federación por parte de la personalización integrada en el dispositivo El procesamiento se basará en el entrenamiento de modelos y la inferencia (opcional, si es necesario).
- La coincidencia basada en el filtro Cuckoo y la coincidencia cruzada entre los datos que se ubicados de manera dispar.
- Entrenamiento con privacidad diferencial (DP) de modelos dispersos a través de nuevas técnicas como la minimización alternada con DP (para entrenar en objetos datos ubicados) y la personalización de modelos en la DP de billboard.
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 apersistAdSelectionResult
cuando se revoca el consentimiento hace que falle el proceso. - La función de filtrado negativo no funciona con
getAdSelectionData
nipersistAdSelectionResult
.
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
(comocom.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 aContentProvider
conContentResolver
. - 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
yregisterTrigger
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
Versiones anteriores
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 tipoWIN
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
- Se cambió el nombre de FLEDGE a API de Protected Audience.
- Protected Audience se desactivó de forma predeterminada en la versión beta de marzo de 2023. Se resolvió este problema y se lanzó Protected Audience a una cantidad limitada de usuarios.
- Se agregaron las siguientes funciones nuevas:
- Limitación de frecuencia
- Informes de interacción
- Agregado de anuncios contextuales en una subasta
- Filtrado negativo de anuncios de instalación de aplicaciones
- URI compilados previamente, una biblioteca de lógica predefinida que las AdTech usan en el proceso de subasta en lugar de su JavaScript
- Control de versiones para funciones de licitación y puntuación de JavaScript
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
- Se implementó la comunicación de SDK a SDK para el proceso de la app y el de entorno de ejecución de SDK.
- Se personalizó la compatibilidad con actividades 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()
acustom_audience_bidding_signals
. - Se cambió el nombre de
scoreAd()
acustom_audience_scoring_signals
. - Se cambió el nombre de
reportWin()
acustom_audience_reporting_signals
.
- Se cambió el nombre de
- En esta versión, se agrega una anulación de
selectAds
nueva que tomaAdSelectionFromOutcomeConfig
para comparar los resultados deselectAds
. 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. Usano-cache
ono-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.
- La caché se puede controlar con los encabezados
Informes de atribución en la API de Android
- Esta versión agrega compatibilidad con redireccionamientos de encadenamiento para
registerSource()
yregisterTrigger()
. 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 beta 1 representa la primera disponibilidad de Privacy Sandbox APIs de 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 tienen Es posible que puedas aprovechar la oportunidad para quienes te inscribiste y enviaron detalles a la lista de entidades permitidas para probarlas 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
- El Colab del clasificador de Topics de Android permite a los desarrolladores comprender mejor cómo funciona el modelo de clasificación.
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
ygetAppSetId
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
yAppSetIdManager
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 a tu cuenta. en tu emulador o 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 porUri
. 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.
- Se reemplazó
- 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
yAppSetIdManager
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 de 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 deAttribution-Reporting-Register-Source
- Activador:
Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data
yAttribution-Reporting-Register-Aggregatable-Values
se consolidaron en un solo encabezado llamadoAttribution-Reporting-Register-Event-Trigger
Attribution-Reporting-Redirects
sigue siendo un encabezado independiente
- Fuente:
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()
porselectAds()
. - Se reemplazó el parámetro de
AdSelectionConfig.Builder.setAdSelectionSignals()
porAdSelectionSignals
, que representa un objeto JSON. - Se reemplazó el uso de
String
para representar a un comprador o vendedor de tecnología publicitaria con el objetoAdTechIdentifier
. - Se agregaron las clases
TestCustomAudienceManager
yTestAdSelectionManager
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.
- Se cambió el nombre de
- 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. Los siguientes son
algunos ejemplos notables.
selectAds
yreportImpression
ahora tienen límites de tiempo de ejecución. Después de esa fecha, se finalizará la llamada.selectAds
yreportImpression
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
yreportImpression
ahora validan el objetoAdSelectionConfig
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 llamadajoinCustomAudience
. La validación también exige que los URI proporcionados para los indicadores y la recuperación de lógica de ofertas la recuperación en segundo plano está dentro del 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 el "propietario" no se instaló la app.
- 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. Para obtener más detalles, consulta la información de configuración en la guía para desarrolladores.
Problemas conocidos:
Cuando te unes a un público personalizado, la plataforma no realiza se actualiza en segundo plano de inmediato, si alguno de los metadatos o valores de
AdData
están vacíos onull
. El público personalizado no será apto para 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 objetoTopic
, 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.
Problemas 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:
- La API de Attribution Reporting todavía no encripta los informes agregados según la propuesta de diseño. Para fines de pruebas, las cargas útiles de informes se envían en texto simple hasta que se implemente la encriptación.
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()
yregisterTrigger()
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 deMeasurementManager
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 Versión preliminar para desarrolladores 1 incluye vistas previas anticipadas de la API de Topics y Entorno de ejecución de 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.
- Por el momento, la API de
- 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.
- Puedes empaquetar y compilar SDKs habilitados para el entorno de ejecución (SDKs de RE) con el nuevo elemento
- 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")
.
- Las verificaciones de lint de Android pueden mostrar advertencias incorrectas en proyectos compilados con el nivel de API