Temas, marcos protegidos y almacenamiento compartido. keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner
Privacy Sandbox incluye una selección de propuestas para habilitar casos de uso publicitario sin necesidad de realizar un seguimiento entre sitios. Las pruebas de origen brindan a los desarrolladores la oportunidad de evaluar y enviar comentarios sobre nuevas tecnologías web a través de pruebas en el mundo real. La prueba de origen de Relevancia y medición de Privacy Sandbox proporciona una sola prueba que permite que los sitios ejecuten experimentos unificados en Attribution Reporting, la API de Protected Audience, Topics, Fenced Frames y el almacenamiento compartido. Los desarrolladores pueden registrarse en esta prueba de origen único que te permite realizar pruebas en las APIs de Topics, Protected Audience y Attribution Reporting. En esta guía, se explican los pasos de configuración para acceder a las APIs, se indica cómo validar la configuración y se proporcionan más recursos para realizar pruebas en las APIs.
Verifica el estado de la prueba de origen
Junio de 2023
Aumento del 7% de Private Aggregation en la versión estable
La API de Private Aggregation estará disponible en el 7% del tráfico estable de Chrome a partir del martes 6 de junio de 2023. La API estará disponible en el grupo principal de la prueba de origen unificada (5%), el grupo aislado de Protected Audience (1%) y el grupo aislado de Shared Storage (1%). La asignación de tráfico para Protected Audience y Shared Storage no cambiará, ya que Private Aggregation se agregará a los experimentos aislados existentes.
Asignación de tráfico a partir del martes 6 de junio:
| API | Asignación de tráfico | Estado |
| Informes de atribución | Unificado: 5% | 6% del tráfico estable al 13 de marzo de 2023 |
| Aislado: 1% (solo ARA) | ||
| Marcos vallados | Unificado: 5% | 7% del tráfico estable al 13 de marzo de 2023 |
| Aislado: 1% (solo almacenamiento compartido, agregación privada y marcos vallados) | ||
| Aislado: 1%: Solo Protected Audience, Private Aggregation y Fenced Frames | ||
| Protected Audience | Unificado: 5% | 6% del tráfico estable al 13 de marzo de 2023 |
| Aislado: 1%: Solo Protected Audience, Private Aggregation y Fenced Frames | ||
| Agregación privada | Unificado: 5% | 7% del tráfico estable al 6 de junio de 2023 |
| Aislado: 1%: Solo Protected Audience, Private Aggregation y Fenced Frames | ||
| Aislado: 1% (solo almacenamiento compartido, agregación privada y marcos vallados) | ||
| Almacenamiento compartido | Unificado: 5% | 6% del tráfico estable al 13 de marzo de 2023 |
| Aislado: 1% (solo almacenamiento compartido, agregación privada y marcos vallados) | ||
| Temas | Unificado: 5% | 6% del tráfico estable al 13 de marzo de 2023 |
| Aislado: 1% (solo temas) |
Actualizaciones anteriores
Consulta las actualizaciones anteriores sobre la prueba de origen.
Abril de 2023
Aumento gradual del 1% de Private Aggregation en la versión estable
La prueba de origen de la API de Private Aggregation estará disponible en el 1% del tráfico del experimento unificado de Chrome estable a partir del lunes 17 de abril. La función sendHistogramReport() de Private Aggregation está disponible para usarse en los worklets de la API de Protected Audience y Shared Storage.
A partir del lunes 17 de abril, la asignación de tráfico se verá de la siguiente manera:
| API | Asignación de tráfico | Estado |
| Informes de atribución | Unificado: 5% | El 6% del tráfico estable a partir del 13 de marzo de 2023 |
| Aislado: 1% (solo ARA) | ||
| Marcos vallados | Unificado: 5% | El 7% del tráfico estable a partir del 13 de marzo de 2023 |
| Aislado: 1%, almacenamiento compartido (selección de URL) y solo marcos protegidos | ||
| Aislado: 1% (solo API de Protected Audience y marcos delimitados) | ||
| API de Protected Audience | Unificado: 5% | El 6% del tráfico estable a partir del 13 de marzo de 2023 |
| Aislado: 1% (solo API de Protected Audience y marcos delimitados) | ||
| Private Aggregation | Unificado: 1% | El 1% del tráfico estable a partir del 17 de abril de 2023 |
| Almacenamiento compartido (selección de URL) | Unificado: 5% | El 6% del tráfico estable a partir del 13 de marzo de 2023 |
| Aislado: 1%, almacenamiento compartido (selección de URL) y solo marcos protegidos | ||
| Temas | Unificado: 5% | El 6% del tráfico estable a partir del 13 de marzo de 2023 |
| Aislado: 1% (solo temas) |
Marzo de 2023
Actualización del cronograma
Inicialmente, comunicamos que comenzaríamos los experimentos aislados el lunes 13 de marzo de 2023, pero los nuevos experimentos comenzarán el jueves 16 de marzo de 2023 debido al tiempo adicional necesario para configurarlos. El aumento del 1% de la API de Protected Audience del 4% al 5% también se producirá el jueves 16 de marzo de 2023.
Reanudación del 1% de la API de Protected Audience
El mes pasado, reducimos temporalmente el tráfico de la prueba de origen de la API de Protected Audience del 5% al 4% de Chrome estable para las pruebas. Las pruebas iniciales concluyeron, y planeamos aumentar el uso de la API de Protected Audience del 4% al 5% para el experimento unificado el jueves 16 de marzo de 2023.
Los usuarios con aumento serán el mismo conjunto de usuarios que se redujeron. Sin embargo, sus grupos de intereses anteriores vencieron, ya que pasaron más de 30 días desde la baja gradual.
Experimentos aislados
Para mejorar nuestro proceso de prueba y seguir observando las métricas de las APIs de prueba de origen, creamos experimentos aislados para cada API, además del experimento unificado existente. Se crearán nuevos experimentos para Attribution Reporting, Topics, una combinación de la API de Protected Audience y Fenced Frames, y una combinación de la operación de selección de URL de Shared Storage y Fenced Frames. En cada experimento aislado, solo las APIs asignadas estarán disponibles para los usuarios de ese grupo.
| API | Asignación de tráfico del experimento aislado |
|---|---|
| Informes de atribución | 1% |
| API de Protected Audience y Fenced Frames | 1% |
| Almacenamiento compartido (selección de URL) + Marcos delimitados | 1% |
| Temas | 1% |
A partir del jueves 16 de marzo, comenzarás a recibir un 1% adicional del tráfico estable de Chrome para las APIs mencionadas anteriormente, además del 5% de tráfico que recibes del experimento unificado existente. Los usuarios nuevos se asignarán a cada experimento.
Asignación de tráfico
La asignación actual de tráfico de las pruebas de origen unificado a partir del martes 28 de febrero es la siguiente:
| API | Asignación de tráfico del experimento unificado actual |
|---|---|
| Informes de atribución | 5% |
| Marcos vallados | 5% |
| API de Protected Audience | 4% |
| Almacenamiento compartido (selección de URL) | 5% |
| Temas | 5% |
A partir del jueves 16 de marzo, después de que se vuelva a activar la API de Protected Audience y comiencen los nuevos experimentos aislados, la asignación de tráfico se verá de la siguiente manera:
| API | Nueva asignación de tráfico | Estado |
|---|---|---|
| Informes de atribución | Unificado: 5% | El 6% del tráfico estable a partir del 16 de marzo de 2023 |
| Aislado: 1% (solo ARA) | ||
| Marcos vallados | Unificado: 5% | El 7% del tráfico estable a partir del 16 de marzo de 2023 |
| Aislado: 1%, almacenamiento compartido (selección de URL) y solo marcos protegidos | ||
| Aislado: 1% (solo API de Protected Audience y marcos delimitados) | ||
| API de Protected Audience | Unificado: 5% (asignación actual del 4% + 1% de aumento) | El 6% del tráfico estable a partir del 16 de marzo de 2023 |
| Aislado: 1% (solo API de Protected Audience y marcos delimitados) | ||
| Almacenamiento compartido (selección de URL) |
Unificado: 5% | El 6% del tráfico estable a partir del 16 de marzo de 2023 |
| Aislado: 1%, almacenamiento compartido (selección de URL) y solo marcos protegidos | ||
| Temas | Unificado: 5% | El 6% del tráfico estable a partir del 16 de marzo de 2023 |
| Aislado: 1% (solo temas) |
Estos cambios no afectarán la configuración existente de tu token de prueba de origen, y no tendrás que renovar ni generar un nuevo token de prueba de origen.
Enero de 2023
Como parte de una investigación de regresión de Chrome, reduciremos temporalmente el tráfico de la prueba de origen de la API de Protected Audience del 5% al 4% de Chrome estable a partir del 26 de enero de 2023. Estimamos que la investigación llevará alrededor de un mes y te notificaremos cuando se restablezca el tráfico.
Este cambio se realizará automáticamente y no afectará a tus tokens de prueba de origen existentes. En el caso de los usuarios del 1% del tráfico que se reducirá, los grupos de interés permanecerán en sus navegadores. Los mismos usuarios formarán parte de la copia de seguridad de la rampa, y sus grupos de intereses se pueden volver a usar. Sin embargo, los grupos de intereses vencen en 30 días, y la investigación de regresión puede demorar más tiempo.
Además, la prueba de origen de la API de URL Selection de Shared Storage aumentará al 5% del tráfico de Chrome Stable a partir del 26 de enero de 2023.
| API | Notas |
|---|---|
| Informes de atribución | Disponible en la versión estable, aumentó al 5% a partir del 26 de octubre de 2022. |
| Temas | Disponible en la versión estable, aumentó al 5% a partir del 26 de octubre de 2022. |
| API de Protected Audience | Disponible en el canal estable, con una disminución temporal al 4% a partir del 26 de enero de 2023. |
| Marcos cercados | Disponible en la versión estable, aumentará al 5% a partir del 9 de noviembre de 2022. |
| Almacenamiento compartido | Disponible en la versión estable, con un aumento del 5% a partir del 26 de enero de 2023. |
Noviembre de 2022
La API de "selectURL" de Shared Storage se unirá a la prueba de origen en el 1% del tráfico estable de Chrome a partir del 9 de noviembre.
Como se anunció anteriormente en la entrada de blog Aumento del 5%de la prueba de origen de la relevancia y la medición de Privacy Sandbox, Attribution Reporting y Topics ahora están en un 5%, y la API de Protected Audience y los marcos protegidos también se agregarán el 9 de noviembre.
| API | Notas |
|---|---|
| Informes de atribución | Disponible en la versión estable, aumentó al 5% a partir del 26 de octubre. |
| Temas | Disponible en la versión estable, aumentó al 5% a partir del 26 de octubre. |
| API de Protected Audience | Disponible en la versión estable, aumentará al 5% a partir del 9 de noviembre. |
| Marcos cercados | Disponible en la versión estable, aumentará al 5% a partir del 9 de noviembre. |
| Almacenamiento compartido | Estará disponible en la versión estable a partir del 9 de noviembre, con un 1%. |
Octubre de 2022: Aumento del 5%
Actualmente, Attribution Reporting, Topics, la API de Protected Audience y Fenced Frames están disponibles en Chrome estable y serán parte del aumento del tráfico.
Comenzaremos a aumentar el tráfico de los Informes de atribución y Topics a partir de esta semana. La API de Protected Audience y los marcos vallados aumentarán a partir del 9 de noviembre.
Obtén más información en la entrada de blog Aumento de la prueba de origen de relevancia y medición de Privacy Sandbox al 5%.
| API | Notas |
|---|---|
| Informes de atribución | Disponible en la versión estable, aumentará al 5% después del 26 de octubre. |
| Temas | Disponible en la versión estable, aumentará al 5% después del 26 de octubre. |
| API de Protected Audience | Disponible en la versión estable, aumentará al 5% a partir del 9 de noviembre. |
| Marcos cercados | Disponible en la versión estable, aumentará al 5% a partir del 9 de noviembre. |
| Almacenamiento compartido | Por el momento, solo está disponible en Canary, Dev y Beta a partir de M105. |
Octubre de 2022
- La prueba de origen se prorrogó hasta Chrome 110.
- En Cómo comenzar a usar las pruebas de origen de Chrome, se explica cómo renovar la inscripción a las pruebas de origen. Esto incluye proporcionar un token nuevo a los orígenes participantes, que es el mismo proceso que se sigue para cualquier otra extensión de prueba de origen.
Se otorgó esta extensión para darle tiempo al ecosistema en el canal estable para que siga probando y validando las mejoras de la API, a la vez que proporciona comentarios coherentes con nuestro cronograma público existente.
El cronograma general de Privacy Sandbox no se modifica.
APIs incluidas en la prueba:
| API | Notas |
|---|---|
| Informes de atribución | Guía para desarrolladores sobre la prueba de origen. |
| API de Protected Audience | Guía para desarrolladores sobre la prueba de origen. |
| Temas | Guía para desarrolladores sobre la prueba de origen. |
| Marcos cercados | Consulta la guía de la API de Protected Audience para conocer el uso de la prueba de origen. |
| Almacenamiento compartido | Por el momento, solo está disponible en Canary, Dev y Beta a partir de M105. |
Agosto de 2022
- La disponibilidad de la prueba de origen aumenta al 1% de los usuarios de computadoras de escritorio a partir de Chrome estable 104.
- Se seguirán realizando actualizaciones cuando la disponibilidad incluya a los usuarios de dispositivos móviles.
- Los canales previos a la versión estable (Canary y beta) siguen teniendo el 50% de los usuarios.
- Las APIs no están disponibles en Chrome para iOS.
Mayo de 2022
La disponibilidad de la prueba de origen aumenta al 50% de los usuarios de Chrome 102 Beta.
APIs incluidas en la prueba:
| API | Notas |
|---|---|
| Informes de atribución | Guía para desarrolladores sobre la prueba de origen. |
| API de Protected Audience | Guía para desarrolladores sobre la prueba de origen. |
| Temas | Guía para desarrolladores de la prueba de origen. Topics se inhabilitó brevemente en la prueba de origen debido a un error que afectó la estabilidad del navegador. |
| Marcos cercados | Se agregaron marcos delimitados a la prueba de origen. Consulta la guía de la API de Protected Audience para el uso de experimentos. |
Abril de 2022
La prueba de origen comienza con una proporción limitada de usuarios de Chrome 102 Beta.
APIs incluidas en la prueba:
| API | Notas |
|---|---|
| Informes de atribución | Publicación individual de Intención de Experimentar (I2E). Los Informes de atribución también están disponibles como una prueba de origen individual. |
| API de Protected Audience | Publicación individual de Intención de Experimentar (I2E). La API de Protected Audience está disponible en computadoras de escritorio solo con un subconjunto de funciones. |
| Temas | Publicación individual de Intención de Experimentar (I2E). |
Regístrate en la prueba de origen y configúrala
Para activar la prueba de origen en tu sitio, deberás registrar e incorporar el token de prueba de origen asignado (una cadena basada en el tiempo para tu acceso específico a la prueba de origen). Obtén más información en Cómo comenzar a usar las pruebas de origen de Chrome.
Los tokens de prueba de origen se otorgan de inmediato, y puedes revocarlos o volver a crearlos en cualquier momento.
Para cada página en la que quieras usar la prueba de origen, deberás incluir un token de prueba con el HTML o la respuesta de esa página específica.
Usa una etiqueta <meta> en la sección <head> de la página:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
Como alternativa, incluye el siguiente encabezado HTTP en la respuesta de la página:
Origin-Trial: TOKEN_GOES_HERE
Configura con un iframe
Si usas funciones de prueba de origen dentro de un iframe (como joinAdInterestGroup() de la API de Protected Audience), el token se debe proporcionar dentro del iframe y coincidir con el origen del iframe.
Cómo configurar la implementación entre sitios con JavaScript
Si usas funciones de prueba de origen a través de JavaScript entre sitios, es decir, si eres el proveedor de JavaScript de terceros que se incluye en la página de nivel superior, deberás hacer lo siguiente:
- Selecciona la opción Coincidencia de terceros cuando te registres para la prueba de origen.
- El campo Origen web debe ser el origen de tu secuencia de comandos.
- Inyecta la etiqueta
<meta>en la página de nivel superior (es decir, la página propia, no tu propio contenido) desde tu secuencia de comandos. Por ejemplo:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Cómo depurar la prueba de origen
Puedes verificar el estado de una prueba de origen en el panel DevTools > Applications.
- Desplázate hacia abajo hasta el panel Frames.
- Selecciona el marco en el que deseas establecer el token. Por ejemplo, el marco superior de la página de nivel superior o el iframe específico para las páginas incorporadas.
- En el panel derecho, desplázate hacia abajo hasta la sección Origin Trials.
- Deberías ver una entrada para la prueba de
PrivacySandboxAdsAPIs. - Expande esta entrada para ver el estado de la prueba de origen y tus tokens específicos.
La prueba de origen se limita a una fracción de los usuarios de Chrome y es posible que tu navegador no esté en el grupo de experimentación. Como resultado, es posible que veas un mensaje TrialNotAllowed
en rojo junto a PrivacySandboxAdsAPIs. Cuando expandas la entrada para verificar el estado del token, si se muestra un mensaje Success verde, la configuración de la prueba de origen es correcta. Los usuarios aptos verán el mensaje establecido en Enabled.
Si ves mensajes diferentes, consulta Cómo solucionar problemas de las pruebas de origen de Chrome para obtener una lista de tareas detallada que te permita validar la configuración de la prueba de origen.
Cómo detectar atributos
Al igual que con todas las funciones web, debes verificar que se informen como disponibles en el navegador antes de intentar usarlas. Para ello, verifica la existencia de la API relevante en la ubicación correcta:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// Protected Audience API enabled
}
if ('browsingTopics' in document) {
// Topics enabled
}
if ('HTMLFencedFrameElement' in window) {
// Fenced Frames enabled
}
if ('sharedStorage' in window) {
// Shared Storage enabled
}
if (window?.sharedStorage?.selectURL instanceof Function) {
// optionally check specifically for the selectURL function in Shared Storage
}
Determina la elegibilidad del usuario
La prueba de origen se está ejecutando para una fracción de los usuarios de Chrome. También deben tener habilitada la funcionalidad relevante en su configuración para poder participar en la prueba:
Configuración del navegador
Para que un usuario sea apto para la prueba, debe cumplir con los siguientes requisitos:
Usar una versión y un canal de Chrome en los que se esté ejecutando la prueba de origen
- Consulta el Estado de la prueba de origen para conocer las configuraciones actuales.
Pertenecer al grupo experimental activo en Chrome
Configuración del usuario
Para que los usuarios reúnan los requisitos para la prueba, también deben cumplir con los siguientes requisitos:
- tener la prueba de Privacy Sandbox habilitada en Configuración > Seguridad y privacidad > Privacy Sandbox, a la que también se puede acceder a través de
chrome://settings/adPrivacy - Habilitar las cookies de terceros en Configuración > Seguridad y privacidad > Cookies y otros datos de sitios configurados en "Permitir todas las cookies" o "Bloquear cookies de terceros en modo Incógnito", a los que también se puede acceder a través de
chrome://settings/cookies - estar en una sesión de navegación estándar y no en el modo Incógnito.
Si bien la prueba de origen solo se mostrará como activa para los usuarios aptos, también puedes usar las marcas para desarrolladores para realizar pruebas en tu propio sitio de producción.
Controla tu participación en la prueba de origen
La mecánica de la prueba de origen sigue siendo la misma: obtienes tokens de prueba de origen para los contextos en los que deseas experimentar con las APIs. Con la expansión de la población de pruebas, debes asegurarte de supervisar y controlar de forma activa el nivel de tráfico en el que eliges habilitar la prueba.
Un buen enfoque aquí es el siguiente:
- Incluye los tokens de prueba de origen de forma predeterminada en todos los contextos en los que desees realizar experimentos.
- Usa la detección de atributos para verificar si hay APIs activas.
- Si las APIs están activas (y, por lo tanto, el navegador es apto para este experimento), elige si deseas usarlas o no en función de tus propios criterios experimentales. Por ejemplo, si ya tienes la infraestructura de pruebas A/B para experimentar con un porcentaje de tráfico, muestreos o algún otro atributo, en este punto puedes decidir qué funciones usarás de forma activa.
Si no incluyes el token en la respuesta, puedes evitar que cualquier instancia de navegador participe por completo en la prueba de origen. Por ejemplo, si alcanzaste tu propia cuota para un experimento o necesitas abordar un problema durante la prueba, no incluir el token garantiza que no haya ninguna funcionalidad experimental disponible o activa en la página.
Control de la prueba de origen por región geográfica
No puedes inhabilitar una prueba de origen para regiones específicas. Las pruebas de origen están activas en las páginas que contienen el token, que se incluye a través de encabezados HTTP (del servidor) o metaetiquetas HTML (del cliente).
Si puedes determinar la ubicación del usuario, podrías escribir código para incluir el token de prueba de origen en función de esa información de ubicación. Por ejemplo, podrías intentar usar direcciones IP para determinar la ubicación de un usuario. Las direcciones IP se pueden falsificar, por lo que esta no es una solución garantizada.
Sin embargo, un origen geográfico específico puede establecer una política de permisos para controlar qué funciones se pueden usar. Por ejemplo, us.example.com y uk.example.com son orígenes específicos de la ubicación geográfica que se pueden controlar. Esto no significa que una región haya inhabilitado la prueba de origen.
Con una Política de Permisos, un sitio agrega un pequeño fragmento de código a sus páginas que proporciona instrucciones al navegador. Cuando se carga la página, el navegador lee las instrucciones de la Política de Permisos y permite o bloquea funciones (o APIs) según se describe en la Política de Permisos. Si un sitio desea restringir una API en una región específica, el desarrollador puede establecer una política para todas las páginas que se soliciten desde esa región.
Cómo renovar tu token
Los tokens de prueba de Origin vencen seis semanas después de la fecha de emisión (o al final de la prueba, si es antes).
Es fundamental que renueves y, luego, implementes tus tokens nuevos dentro de ese período para usar sin interrupciones las funciones de la prueba de origen.
La renovación de tokens solo demora unos minutos, y puedes implementar varios tokens para la misma prueba en la misma página. Puedes implementar un token renovado antes de que venza el existente, de modo que no haya interrupciones en el servicio para los usuarios.
Realiza pruebas locales
Para obtener orientación específica sobre las pruebas locales para desarrolladores, consulta los siguientes recursos:
Las APIs no están activadas de forma predeterminada y deben habilitarse con marcas para las pruebas. Debes asegurarte de tener habilitada la misma configuración que se mencionó anteriormente y, luego, hacer lo siguiente:
- Usa una versión y un canal de Chrome en los que las funciones estén disponibles.
- Habilita todas las APIs de privacidad en los anuncios en
chrome://settings/adPrivacy.
Consulta las guías para desarrolladores para conocer la disponibilidad de APIs y funciones específicas, y marcas adicionales para una configuración más detallada.