Privacy Sandbox incluye una selección de propuestas para habilitar casos de uso de publicidad sin necesidad de realizar un seguimiento en sitios cruzados. Los orígenes de prueba brindan a los desarrolladores la oportunidad de evaluar nuevas tecnologías web y enviar comentarios sobre ellas a través de pruebas en el mundo real. La prueba de origen de Privacy Sandbox Relevance and Measurement proporciona una sola prueba que permite a los sitios ejecutar experimentos unificados en Attribution Reporting, la API de Protected Audience, Topics, los marcos protegidos y el almacenamiento compartido. Los desarrolladores pueden registrarse en esta única prueba de origen 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 recursos adicionales para realizar pruebas con las APIs.
Verifica el estado de la prueba de origen
Junio de 2023
Aumento gradual del 7% de Private Aggregation en la versión estable
La API de Private Aggregation estará disponible en el 7% del tráfico de Chrome estable 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% | El 6% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislado: 1%, solo para ARA | ||
| Marcos vallados | Unificado: 5% | El 7% del tráfico de la versión estable al 13 de marzo de 2023 |
| Aislamiento: 1% - Solo Shared Storage + Private Aggregation + Fenced Frames | ||
| Aislamiento: 1% - Solo Protected Audience + Private Aggregation + Fenced Frames | ||
| Protected Audience | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislamiento: 1% - Solo Protected Audience + Private Aggregation + Fenced Frames | ||
| Private Aggregation | Unificado: 5% | El 7% del tráfico de la versión estable al 6 de junio de 2023 |
| Aislamiento: 1% - Solo Protected Audience + Private Aggregation + Fenced Frames | ||
| Aislamiento: 1% - Solo Shared Storage + Private Aggregation + Fenced Frames | ||
| Shared Storage | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislamiento: 1% - Solo Shared Storage + Private Aggregation + Fenced Frames | ||
| Temas | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislamiento: 1% (solo temas) |
Actualizaciones anteriores
Consulta las actualizaciones anteriores de 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 Stable 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.
La asignación de tráfico se verá de la siguiente manera a partir del lunes 17 de abril:
| API | Asignación de tráfico | Estado |
| Informes de atribución | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislado: 1%, solo para ARA | ||
| Marcos vallados | Unificado: 5% | El 7% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislamiento: 1%, Shared Storage (selección de URL) y Fenced Frames únicamente | ||
| Aislamiento: 1%, solo API de Protected Audience y Fenced Frames | ||
| API de Protected Audience | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislamiento: 1%, solo API de Protected Audience y Fenced Frames | ||
| Private Aggregation | Unificado: 1% | El 1% del tráfico de la versión estable a partir del 17 de abril de 2023 |
| Shared Storage (selección de URL) | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislamiento: 1%, Shared Storage (selección de URL) y Fenced Frames únicamente | ||
| Temas | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 13 de marzo de 2023 |
| Aislamiento: 1% (solo temas) |
Marzo de 2023
Actualización del cronograma
En un principio, 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% al 5% en el incremento de la API de Protected Audience también se producirá el jueves 16 de marzo de 2023.
Reanudación gradual 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 realizar pruebas. Las pruebas iniciales concluyeron y planeamos aumentar el tráfico de la API de Protected Audience del 4% al 5% para el experimento unificado el jueves 16 de marzo de 2023.
Los usuarios que se agreguen de forma gradual serán el mismo conjunto de usuarios que se quitaron de forma gradual. Sin embargo, sus grupos de interés anteriores vencieron, ya que transcurrieron más de 30 días desde la reducción.
Experimentos aislados
Para mejorar nuestro proceso de pruebas y seguir observando las métricas de las APIs de la prueba de origen, crearemos experimentos aislados para cada API, además del experimento unificado existente. Se crearán experimentos nuevos 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 aislado del experimento |
|---|---|
| Informes de atribución | 1% |
| API de Protected Audience y Fenced Frames | 1% |
| Shared Storage (selección de URL) y Fenced Frames | 1% |
| Temas | 1% |
A partir del jueves 16 de marzo, comenzarás a recibir un 1% adicional del tráfico de Chrome estable 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 de tráfico actual de las pruebas de origen unificadas al 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% |
| Shared Storage (selección de URL) | 5% |
| Temas | 5% |
La asignación de tráfico será la siguiente a partir del jueves 16 de marzo, después de que se reactive la API de Protected Audience y comiencen los nuevos experimentos aislados:
| API | Nueva asignación de tráfico | Estado |
|---|---|---|
| Informes de atribución | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 16 de marzo de 2023 |
| Aislado: 1%, solo para ARA | ||
| Marcos vallados | Unificado: 5% | El 7% del tráfico de la versión estable a partir del 16 de marzo de 2023 |
| Aislamiento: 1%, Shared Storage (selección de URL) y Fenced Frames únicamente | ||
| Aislamiento: 1%, solo API de Protected Audience y Fenced Frames | ||
| API de Protected Audience | Unificado: 5% (4% de asignación actual + 1% de recuperación) | El 6% del tráfico de la versión estable a partir del 16 de marzo de 2023 |
| Aislamiento: 1%, solo API de Protected Audience y Fenced Frames | ||
| Shared Storage (selección de URL) |
Unificado: 5% | El 6% del tráfico de la versión estable a partir del 16 de marzo de 2023 |
| Aislamiento: 1%, Shared Storage (selección de URL) y Fenced Frames únicamente | ||
| Temas | Unificado: 5% | El 6% del tráfico de la versión estable a partir del 16 de marzo de 2023 |
| Aislamiento: 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 token nuevo.
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 tardará alrededor de un mes y te notificaremos cuando se restablezca el tráfico.
Este cambio se realizará automáticamente y no afectará tus tokens de prueba de origen existentes. En el caso de los usuarios que representan el 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 recuperación, y sus grupos de interés se podrán reutilizar. Sin embargo, los grupos de interés vencen en 30 días, y la investigación de regresión puede tardar más que eso.
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, y se reducirá temporalmente al 4% a partir del 26 de enero de 2023. |
| Marcos vallados | Disponible en la versión estable, con un aumento al 5% a partir del 9 de noviembre de 2022. |
| Shared Storage | 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 de Chrome Estable a partir del 9 de noviembre.
Como se anunció anteriormente en la entrada de blog Aumento al 5%de la prueba de origen de relevancia y medición de Privacy Sandbox, Attribution Reporting y Topics ahora están en el 5%, y la API de Protected Audience y los marcos protegidos también se unirá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, con un aumento al 5% a partir del 9 de noviembre. |
| Marcos vallados | Disponible en la versión estable, con un aumento al 5% a partir del 9 de noviembre. |
| Shared Storage | Estará disponible en la versión estable a partir del 9 de noviembre, con un lanzamiento inicial del 1%. |
Octubre de 2022: Aumento del 5%
Actualmente, Attribution Reporting, Topics, la API de Protected Audience y los marcos protegidos están disponibles en Chrome Estable y formarán parte del aumento del tráfico.
Comenzaremos a aumentar el tráfico para los Informes de atribución y la API de Topics a partir de esta semana, y para la API de Protected Audience y los marcos vallados a partir del 9 de noviembre.
Obtén más información en la entrada de blog Aumentamos al 5%la prueba de origen de relevancia y medición de Privacy Sandbox.
| API | Notas |
|---|---|
| Informes de atribución | Disponible en el canal estable, con un aumento al 5% después del 26 de octubre. |
| Temas | Disponible en el canal estable, con un aumento al 5% después del 26 de octubre. |
| API de Protected Audience | Disponible en la versión estable, con un aumento al 5% a partir del 9 de noviembre. |
| Marcos vallados | Disponible en la versión estable, con un aumento al 5% a partir del 9 de noviembre. |
| Shared Storage | Por el momento, solo está disponible en las versiones Canary, beta y para desarrolladores de M105 y versiones posteriores. |
Octubre de 2022
- La prueba de origen se extendió hasta Chrome 110.
- En Cómo comenzar a usar las pruebas de origen de Chrome, se explica cómo renovar la inscripción en las pruebas de origen. Esto incluye proporcionar un nuevo token a los orígenes participantes, que es el mismo proceso que se sigue para cualquier otra extensión de prueba de origen.
Esta extensión se otorgó para dar tiempo al ecosistema en el canal estable para seguir probando y validando las mejoras de la API, y, al mismo tiempo, proporcionar comentarios coherentes con nuestra cronología pública existente.
El cronograma general de Privacy Sandbox no se modificó.
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 vallados | Consulta la guía de la API de Protected Audience para obtener información sobre el uso de la prueba de origen. |
| Shared Storage | Por el momento, solo está disponible en las versiones Canary, beta y para desarrolladores de M105 y versiones posteriores. |
Agosto de 2022
- La disponibilidad de la prueba de origen aumenta hasta el 1% de los usuarios de escritorio a partir de Chrome estable 104.
- Se publicarán actualizaciones cuando la disponibilidad incluya a los usuarios de dispositivos móviles.
- Los canales previos a la versión estable (Canary y beta) siguen siendo del 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 hasta el 50% de los usuarios a partir 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 sobre la prueba de origen Topics se inhabilitó brevemente en la prueba de origen debido a un error que afectó la estabilidad del navegador. |
| Marcos vallados | Se agregaron Fenced Frames a la prueba de origen. Consulta la guía de la API de Protected Audience para obtener información sobre 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 sobre la intención de experimentar (I2E). Attribution Reporting también está disponible como prueba de origen individual. |
| API de Protected Audience | Publicación individual sobre la intención de experimentar (I2E). La API de Protected Audience solo está disponible en computadoras con un subconjunto de funciones. |
| Temas | Publicación individual sobre la intención de experimentar (I2E). |
Regístrate para la prueba de origen y configúrala
Para activar la prueba de origen en tu sitio, deberás registrarte y, luego, 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 código 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 debe proporcionarse dentro del iframe y coincidir con el origen del iframe.
Configura el seguimiento entre sitios con JavaScript
Si usas funciones de prueba de origen a través de JavaScript de sitios cruzados, 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 Third-party matching cuando te registres en la prueba de origen.
- El campo Origen web debe ser el origen de tu secuencia de comandos.
- Inserta la etiqueta
<meta>en la página de nivel superior (es decir, la página propia, no tu 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 fotograma en el que esperas establecer el token. Por ejemplo, el fotograma superior de la página de nivel superior o el iframe específico de las páginas incorporadas.
- En el panel de la derecha, desplázate hacia abajo hasta la sección Pruebas de origen.
- 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 experimental. Como resultado, es posible que veas un mensaje rojo TrialNotAllowed junto a PrivacySandboxAdsAPIs. Cuando expandas la entrada para verificar el estado del token, si se muestra un mensaje verde de Success, 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 Soluciona 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.
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 pertinente 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
}
Cómo determinar la elegibilidad del usuario
La prueba de origen se ejecuta para una fracción de los usuarios de Chrome. También deben tener habilitada la funcionalidad pertinente 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 ejecute 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 un usuario reúna los requisitos para la prueba, también debe cumplir con lo siguiente:
- tener habilitada la prueba de Privacy Sandbox en Configuración > Seguridad y privacidad > Privacy Sandbox, a la que también se puede acceder a través de
chrome://settings/adPrivacy - tener habilitadas las cookies de terceros en Configuración > Seguridad y privacidad > Cookies y otros datos de sitios, configurado como "Permitir todas las cookies" o "Bloquear las cookies de terceros en modo incógnito", también accesible a través de
chrome://settings/cookies - Estar en una sesión de navegación estándar y no en 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 población de pruebas ampliada, debes asegurarte de supervisar y controlar activamente el nivel de tráfico en el que elijas 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 funciones para verificar las APIs activas.
- Si las APIs están activas (y, por lo tanto, el navegador es apto para este experimento), elige si deseas usarlas según tus propios criterios del experimento. Por ejemplo, si ya tienes una infraestructura de pruebas A/B para experimentar con un porcentaje del tráfico, el muestreo o algún otro atributo, en este punto puedes decidir qué funciones usarás de forma activa.
Para evitar por completo la participación en la prueba de origen en cualquier instancia del navegador, no incluyas el token en la respuesta. 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 habrá funciones experimentales disponibles ni activas 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, incluido 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 la prueba de origen según 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 suplantar, por lo que esta no es una solución garantizada.
Sin embargo, un origen específico de una ubicación geográfica 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 las funciones (o las 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 solicitadas desde esa región.
Renueva tu token
Los tokens de prueba de origen 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 las funciones de la prueba de origen sin interrupciones.
La renovación de tokens solo tarda 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 token 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 realizar pruebas. Debes asegurarte de tener habilitados los mismos parámetros de configuración que se indicaron 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 Ad privacy en
chrome://settings/adPrivacy.
Consulta las guías para desarrolladores para conocer la disponibilidad de APIs y funciones específicas, y las marcas adicionales para una configuración más detallada.