Temas, marcos vallados y almacenamiento compartido. palabras clave: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Principiante
Privacy Sandbox incluye una selección de propuestas para permitir el uso publicitario sin necesidad de hacer un seguimiento entre sitios. Origen las pruebas proporcionan una oportunidad a los desarrolladores para evaluar y hacer comentarios sobre nuevas tecnologías web a través de pruebas reales. El Relevancia de Privacy Sandbox y Prueba de origen de medición proporciona una única prueba que permite a los sitios ejecutar experimentos unificados en Attribution Reporting, API de Protected Audience, Topics, Fenced Frames y Shared Almacenamiento. Los desarrolladores pueden registrarse en esta prueba de origen único que les permite probar en las APIs de Topics, la API de Protected Audience y las APIs de Attribution Reporting. Esta te guía a través de los pasos de configuración para acceder a las APIs, te indica cómo validar tu configuración y te brinda más recursos para realizar pruebas con las APIs.
Verifica el estado de la prueba de origen
Junio de 2023
Aumento del 7% de la agregación privada en el canal estable
API de Private Aggregation se aplicará disponible para el 7% del tráfico estable de Chrome a partir del martes 6 de junio de 2023. La API estarán disponibles en el grupo de prueba principal de origen unificado (5%), Grupo aislado de público (1%) y grupo aislado de almacenamiento compartido (1%). El no cambiará la asignación de tráfico para Protected Audience y el almacenamiento compartido ya que la agregación privada se agrega a 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% | Un 6% del tráfico estable al 13 de marzo de 2023 |
| Aislamiento, 1%, solo ARA | ||
| Marcos cercados | Unificado: 5% | Un 7% del tráfico estable al 13 de marzo de 2023 |
| Aislado - 1% - Almacenamiento compartido + agregación privada + marcos vallados únicamente | ||
| Aislado - 1% - Público protegido + Agregación privada + Marcos cercados únicamente | ||
| Protected Audience | Unificado: 5% | Un 6% del tráfico estable al 13 de marzo de 2023 |
| Aislado - 1% - Público protegido + Agregación privada + Marcos cercados únicamente | ||
| Agregación privada | Unificado: 5% | Un 7% del tráfico estable desde el 6 de junio de 2023 |
| Aislado - 1% - Público protegido + Agregación privada + Marcos cercados únicamente | ||
| Aislado - 1% - Almacenamiento compartido + agregación privada + marcos vallados únicamente | ||
| Almacenamiento compartido | Unificado: 5% | Un 6% del tráfico estable al 13 de marzo de 2023 |
| Aislado - 1% - Almacenamiento compartido + agregación privada + marcos vallados únicamente | ||
| Temas | Unificado: 5% | Un 6% del tráfico estable al 13 de marzo de 2023 |
| Aislamiento - 1% - Solo temas |
Actualizaciones anteriores
Consulta las actualizaciones anteriores sobre la prueba de origen.
Abril de 2023
Aumento del 1% de la agregación privada en el canal estable
En la sección Privada
La prueba de origen de la API de Aggregation estará disponible en el 1% de la versión estable de Chrome.
el tráfico del experimento unificado a partir del lunes 17 de abril. El sendHistogramReport()
de Private Aggregation se puede usar en la API de Protected Audience
y almacenamiento compartido
compartimientos de trabajo.
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 |
| Aislamiento, 1%, solo ARA | ||
| Marcos cercados | Unificado: 5% | El 7% del tráfico estable a partir del 13 de marzo de 2023 |
| Aislado - 1% - Almacenamiento compartido (selección de URL) + Marcos cercados únicamente | ||
| Aislado - 1% - API de Protected Audience + Solo marcos vallados | ||
| API de Protected Audience | Unificado: 5% | El 6% del tráfico estable a partir del 13 de marzo de 2023 |
| Aislado - 1% - API de Protected Audience + Solo marcos vallados | ||
| Agregación privada | 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) + Marcos cercados únicamente | ||
| Temas | Unificado: 5% | El 6% del tráfico estable a partir del 13 de marzo de 2023 |
| Aislamiento - 1% - Solo temas |
Marzo de 2023
Actualización de Rutas
Inicialmente, informamos que iniciaremos 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 configurar los experimentos. El 1% El aumento de la API de Protected Audience del 4 al 5% también ocurrirá el jueves, 16 de marzo de 2023.
Aumento del 1% de la API de Protected Audience
El mes pasado, redujimos temporalmente el tráfico de las pruebas de origen de la API de Protected Audience del 5% al 4% de la versión estable de Chrome para pruebas. Concluyeron las pruebas iniciales, y planeamos volver a aumentar la API de Protected Audience hasta un 5%, del 4% para el experimento unificado el jueves 16 de marzo de 2023.
Los usuarios que aumentaron su actividad serán los mismos que ellos. Sin embargo, sus grupos de interés anteriores vencieron, ya que pasaron más de 30 días desde la reducción.
Experimentos aislados
Para mejorar nuestro proceso de prueba y seguir observando las métricas de las APIs de 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 Marcos vallados, además de la operación de selección de URLs del almacenamiento compartido y Marcos vallados. En cada experimento aislado, solo las APIs asignadas estarán disponibles para los usuarios de ese grupo.
| API | Asignación de tráfico de experimento aislado |
|---|---|
| Informes de atribución | 1% |
| API de Protected Audience + Fenced Frames | 1% |
| Almacenamiento compartido (selección de URL) + marcos vallados | 1% |
| Temas | 1% |
A partir del jueves 16 de marzo, comenzarás a recibir un 1% adicional del El tráfico estable de Chrome para las APIs mencionadas anteriormente, además del 5% del tráfico que que reciben del experimento unificado existente. Se asignarán usuarios nuevos a cada experimento.
Asignación de tráfico
La asignación de tráfico actual de pruebas de origen unificadas hasta el martes 28 de febrero es la siguiente:
| API | Asignación de tráfico del experimento unificado actual |
|---|---|
| Informes de atribución | 5% |
| Marcos cercados | 5% |
| API de Protected Audience | 4% |
| Almacenamiento compartido (selección de URL) | 5% |
| Temas | 5% |
La asignación de tráfico se verá de la siguiente manera a partir del jueves 16 de marzo, después del período de adaptación de la API de Protected Audience y del comienzo de los nuevos experimentos aislados:
| 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 |
| Aislamiento, 1%, solo ARA | ||
| Marcos cercados | Unificado: 5% | El 7% del tráfico estable a partir del 16 de marzo de 2023 |
| Aislado - 1% - Almacenamiento compartido (selección de URL) + Marcos cercados únicamente | ||
| Aislado - 1% - API de Protected Audience + Solo marcos vallados | ||
| API de Protected Audience | Unificado: 5% (4% de asignación actual + 1% de aumento) | El 6% del tráfico estable a partir del 16 de marzo de 2023 |
| Aislado - 1% - API de Protected Audience + Solo marcos vallados | ||
| 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) + Marcos cercados únicamente | ||
| Temas | Unificado: 5% | El 6% del tráfico estable a partir del 16 de marzo de 2023 |
| Aislamiento - 1% - Solo temas |
Estos cambios no afectarán la configuración de tu token de prueba de origen existente, y no tendrás que renovar ni generar un token de prueba de origen nuevo.
Enero de 2023
Como parte de una investigación de regresión de Chrome, reduciremos temporalmente el tráfico de las pruebas de origen de la API de Protected Audience del 5% al 4% de la versión estable de Chrome a partir del 26 de enero de 2023. Estimamos que la investigación tardará aproximadamente un mes. Te notificaremos cuando el tráfico vuelva a aumentar.
Este cambio se realizará automáticamente y no afectará tus tokens de prueba de origen existentes. En el caso de los usuarios del 1% del tráfico que disminuirá, los grupos de interés permanecerán en sus navegadores. Los mismos usuarios formarán parte del período de adaptación, y sus grupos de interés se pueden reutilizar. Sin embargo, los grupos de interés vencen en 30 días, y la investigación de la regresión puede demorar más que eso.
Además, la prueba de origen de la API de selección de URL de Shared Storage aumentará al 5% del tráfico estable de Chrome a partir del 26 de enero de 2023.
| API | Notas |
|---|---|
| Informes de atribución | Disponible en el canal estable; aumentó al 5% a partir del 26 de octubre de 2022. |
| Temas | Disponible en el canal 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 el canal estable, aumentando al 5% a partir del 9 de noviembre de 2022. |
| Almacenamiento compartido | Disponible en el canal estable, con un aumento del 5% a partir del 26 de enero de 2023. |
Noviembre de 2022
A partir del 9 de noviembre, la API "selectURL" del almacenamiento compartido se unirá a la prueba de origen con el 1% del tráfico estable de Chrome.
Como se anunció anteriormente en la entrada de blog Aumenta la relevancia de Privacy Sandbox y la prueba de origen de la medición al 5%, Attribution Reporting y Topics ahora están en un 5% con la API de Protected Audience y Fenced Frames el 9 de noviembre.
| API | Notas |
|---|---|
| Informes de atribución | Disponible en el canal estable; aumentó al 5% a partir del 26 de octubre. |
| Temas | Disponible en el canal estable; aumentó al 5% a partir del 26 de octubre. |
| API de Protected Audience | Disponible en el canal estable; aumentará al 5% a partir del 9 de noviembre. |
| Marcos vallados | Disponible en el canal estable; aumentará al 5% a partir del 9 de noviembre. |
| Almacenamiento compartido | Estará disponible en la versión estable a partir del 1% a partir del 9 de noviembre. |
Octubre de 2022: Aumento del 5%
Actualmente, Attribution Reporting, Topics, la API de Protected Audience y Fenced Frames están disponibles en la versión estable de Chrome y formarán parte del aumento del tráfico.
Comenzaremos a aumentar el tráfico para Attribution Reporting 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 Aumenta la relevancia de Privacy Sandbox y la prueba de origen de medición al 5%.
| API | Notas |
|---|---|
| Informes de atribución | Disponible en el canal estable y aumentará al 5% después del 26 de octubre. |
| Temas | Disponible en el canal estable y aumentará al 5% después del 26 de octubre. |
| API de Protected Audience | Disponible en el canal estable; aumentará al 5% a partir del 9 de noviembre. |
| Marcos vallados | Disponible en el canal estable; aumentará al 5% a partir del 9 de noviembre. |
| Almacenamiento compartido | Por el momento, solo está disponible en versiones beta y para desarrolladores de M105 y versiones posteriores. |
Octubre de 2022
- La prueba de origen se amplió a Chrome 110.
- En Comienza con las pruebas de origen de Chrome, se explica cómo renovar la inscripción a estas pruebas. Esto incluye proporcionar un token nuevo a los orígenes participantes, lo cual es el mismo proceso que sigue cualquier otra extensión de prueba de origen.
Se concedió esta extensión para darle tiempo al ecosistema en el canal estable para que continúa probando y validando las mejoras de la API y, al mismo tiempo, proporciona comentarios coherente con nuestro cronograma público existente.
No se modificó el cronograma general de Privacy Sandbox.
APIs incluidas en la prueba:
| API | Notas |
|---|---|
| Atribución Informes | Desarrollador de la prueba de origen. |
| API de Protected Audience | Desarrollador de la prueba de origen. |
| Temas | Desarrollador de la prueba de origen. |
| Cerrada Marcos | Consulta la guía de la API de Protected Audience para obtener información sobre el uso de la prueba de origen. |
| Compartidos Almacenamiento | Por el momento, solo está disponible en versiones beta y para desarrolladores de M105 y versiones posteriores. |
Agosto de 2022
- La disponibilidad de las pruebas de origen aumenta hasta el 1% de los usuarios de computadoras a partir de la versión 104 de la versión estable de Chrome.
- Las actualizaciones se realizarán cuando la disponibilidad incluya a los usuarios de dispositivos móviles.
- Los canales preestablecidos (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 las pruebas de origen aumenta hasta el 50% de los usuarios que usan la versión beta de Chrome 102.
APIs incluidas en la prueba:
| API | Notas |
|---|---|
| Atribución Informes | Desarrollador de la prueba de origen. |
| API de Protected Audience | Desarrollador de la prueba de origen. |
| Temas | Guía para desarrolladores del prueba de origen. Topics se inhabilitó brevemente en la prueba de origen debido a un error que afectaba la estabilidad del navegador. |
| Cerrada Marcos | Se agregaron marcos vallados a la prueba de origen. Consulta la guía de la API de Protected Audience para el uso del experimento. |
Abril de 2022
La prueba de origen comienza con una proporción limitada de usuarios de la versión beta de Chrome 102.
APIs incluidas en la prueba:
| API | Notas |
|---|---|
| Atribución Informes | Intención individual al experimento (I2E). Attribution Reporting también está disponible como una prueba de origen individual. |
| API de Protected Audience | Intención individual al experimento (I2E). La API de Protected Audience está disponible en computadoras solo con una subconjunto de funcionalidades. |
| Temas | Intención individual al experimento (I2E). |
Regístrate en la prueba de origen y configúrala
Para activar la prueba de origen en tu sitio, deberás registrarte e incorporarla el token de prueba de origen asignado (una cadena basada en tiempo para tu acceso específico a la prueba de origen). Obtén más información en el artículo Comienza a usar el origen de Chrome pruebas.
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">
También puedes incluir el siguiente encabezado HTTP en la respuesta de la página:
Origin-Trial: TOKEN_GOES_HERE
Configurar con un iframe
Si usas funciones de prueba de origen en un iframe (como las APIs de Protected Audience
joinAdInterestGroup()), se debe proporcionar el token dentro del iframe.
y que coincidan con el origen del iframe.
Cómo configurar entre sitios con JavaScript
Si usas funciones de prueba de origen a través de JavaScript entre sitios, como si el proveedor de JavaScript de terceros que se incluye en la página de nivel superior Luego, deberás hacer lo siguiente:
- Selecciona la opción Coincidencia de terceros cuando te registres para el origen. de Google Cloud.
- El campo Web Origin debe ser el origen de la secuencia de comandos.
- Inserta la etiqueta
<meta>en la página de nivel superior (es decir, la fuente página, no tu propio contenido) de tu guion. 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 DevTools > Aplicaciones panel.
- Desplázate hacia abajo hasta el panel Frames.
- Selecciona el marco en el que esperas establecer el token. Por ejemplo, el botón top marco para la página de nivel superior o el iframe específico para 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 tu tokens.
La prueba de origen se limita a una fracción de los usuarios de Chrome, y es posible que el navegador
no estar en el grupo experimental. Como resultado, es posible que veas una TrialNotAllowed roja.
mensaje contra PrivacySandboxAdsAPIs. Cuando expandas la entrada para verificar
Estado del token, si hay un mensaje Success verde, significa que tu prueba de origen
configuración sea correcta. Los usuarios aptos verán el mensaje como Enabled.
Si ves mensajes diferentes, consulta Solución de problemas del origen de Chrome pruebas para un lista de tareas detallada para validar tu configuración de la prueba de origen.
Detecta atributos
Al igual que con todas las funciones web, debe comprobar que informen como disponibles en el navegador antes de intentar usarlos. Para ello, verifica si hay 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
}
Determinar la elegibilidad de los usuarios
La prueba de origen se está ejecutando para una fracción de los usuarios de Chrome. También deben tener que la funcionalidad relevante habilitada en su configuración sea apta para prueba:
Configuración del navegador
Para que los usuarios sean aptos para la prueba, deben cumplir con los siguientes requisitos:
Debes usar una versión y un canal de Chrome en los que esté vigente la prueba de origen. en ejecución.
- Consulta Estado de la prueba de origen para conocer los parámetros de configuración actuales.
Pertenecer al grupo experimental activo en Chrome
Configuración del usuario
Para que los usuarios sean aptos para la prueba, también deben cumplir con los siguientes requisitos:
- tener la prueba habilitada de Privacy Sandbox en Configuración > Seguridad y
privacidad > Privacy Sandbox, también accesible 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 configurados en "Permitir todas las cookies" o "Bloquear
cookies de terceros en modo incógnito", a las que también se puede acceder mediante
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 que cumplan con los requisitos, también puedes Usa las marcas de desarrollador para probarlas en tu propio entorno de producción. .
Controla tu participación en la prueba de origen
Los mecanismos de la prueba de origen son los mismos: se obtiene una prueba de origen. para los contextos en los que quieres experimentar con las APIs. Con la población de pruebas ampliada, debes asegurarte de que estás supervisando activamente y controlar el nivel de tráfico en el que eliges habilitar la prueba.
Un buen enfoque aquí es:
- Incluye los tokens de prueba de origen de forma predeterminada en todos los contextos en los que desees experimento.
- Usa la detección de funciones para buscar APIs activas.
- Si las APIs están activas (y, por lo tanto, el navegador es apto para esta experimento), elija si desea usarlos o no en función de su propio experimento con tus criterios. Por ejemplo, si ya tienes una infraestructura de pruebas A/B para experimentar con un porcentaje de tráfico, muestreo o algún otro atributo, En este punto, puedes decidir qué funciones usarás de forma activa.
Puedes impedir la participación en la prueba de origen por completo para cualquier navegador la instancia si no incluye el token en la respuesta. Por ejemplo, si tienes alcanzaste tu propia cuota para un experimento o necesitas solucionar un problema durante prueba, no incluir el token garantiza que ninguna funcionalidad experimental estar disponible o activo 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 tienen las siguientes características: activas en páginas que contienen 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 prueba de origen según esa información de ubicación. Por ejemplo, puede intentar usar direcciones IP para determinar la ubicación de un usuario. Direcciones IP por lo que esta no es una solución garantizada.
Sin embargo, un origen geográfico específico puede establecer una configuración de permisos
Política para controlar qué funciones
utilizable. Por ejemplo, us.example.com y uk.example.com son
desde una ubicación geográfica
específica y que se puede controlar. Esto no significa que un
región inhabilitó 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 lea las instrucciones de la Política de Permisos y permitirá o bloqueará funciones (o APIs), como se describe en la Política de Permisos. Si un sitio quiere restringir una API en una región específica, el desarrollador podría establecer una política para todas las páginas solicitadas de esa región.
Renueva tu token
Los tokens de prueba de origen vencen seis semanas después de su fecha de emisión (o al final del si es antes).
Es fundamental que renoves e implementes tu nueva tokens dentro de esa ventana por uso ininterrumpido de las funciones de prueba de origen.
La renovación de tokens solo toma unos minutos y puedes implementar varios tokens para la misma prueba dentro de la misma página. Puedes implementar un token renovado antes de que el token existente venza, por lo que no hay interrupción en el servicio para los usuarios.
Realiza pruebas locales
Para obtener orientación específica sobre las pruebas para desarrolladores locales, consulta lo siguiente:
Las APIs no están activadas de forma predeterminada y deben habilitarse con marcas para y pruebas. Debes asegurarte de tener habilitados los mismos parámetros de configuración. arriba y luego:
- Usa una versión y un canal de Chrome donde estén disponibles las funciones.
- Habilita todas las APIs de privacidad en los anuncios de
chrome://settings/adPrivacy.
Consulta las guías para desarrolladores para conocer la disponibilidad de APIs y funciones específicas. marcas adicionales para obtener una configuración más detallada.