Prueba de origen unificada de relevancia y medición

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.

Término clave: El tráfico se refiere al porcentaje de instancias del navegador Chrome. incluidos en la prueba, no el porcentaje de solicitudes realizadas a sitios individuales.

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.

Nota: Regístrese en el programa Relevancia y medición de Privacy Sandbox de prueba.

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.

Estado de éxito del token y habilitado.

1. Desplázate hacia abajo hasta el panel Frames.
2. 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.
3. En el panel de la derecha, desplázate hacia abajo hasta la sección Pruebas de origen.
4. Deberías ver una entrada para la prueba de PrivacySandboxAdsAPIs.
5. 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.

Estado de éxito del token y no habilitado.

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.

Nota: El 5% del tráfico de la versión estable de Chrome no corresponderá directamente al 5% del tuyo tráfico. La proporción real de tráfico que reciben tus sitios y servicios dependerá de la composición de tus visitantes.

Un buen enfoque aquí es:

1. Incluye los tokens de prueba de origen de forma predeterminada en todos los contextos en los que desees experimento.
2. Usa la detección de funciones para buscar APIs activas.
3. 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.

Advertencia: Los usuarios pueden elegir visitar un origen de una región diferente. del lugar en el que están. En otras palabras, un usuario de los Estados Unidos puede puedan visitar uk.example.com. Esos usuarios verían características y funciones para el sitio de Estados Unidos que estaban bloqueados para el sitio del Reino Unido.

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.

Precaución: La renovación de un token a fines de octubre solo te llevará hasta principios de diciembre. Si se bloquea el código durante el final del año, asegurarse de que aún puedes implementar un token actualizado o un plan para detener la participación en la prueba de origen durante ese período.

Realiza pruebas locales

Para obtener orientación específica sobre las pruebas para desarrolladores locales, consulta lo siguiente:

• Temas
• API de Protected Audience
• Informes de atribución

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.