Descripción general del almacenamiento compartido

La API de Shared Storage permite que los sitios web almacenen datos y accedan a ellos sin estar aislados por el sitio de nivel superior. Esto habilita y facilita los casos de uso entre sitios y, al mismo tiempo, respeta la privacidad del usuario.

Si bien Chrome tiene almacenamiento particionado y está avanzando hacia una nueva experiencia que mejora la elección del usuario en relación con las cookies de terceros, existen varios casos de uso legítimos que dependen del almacenamiento sin particionar, lo que no sería posible sin la ayuda de las nuevas APIs web. Por ejemplo, un productor de contenido puede querer medir el alcance del contenido en diferentes sitios sin depender de identificadores de sitios cruzados. La API de Shared Storage aborda esta necesidad, ya que proporciona un mecanismo más privado para almacenar y acceder a datos sin particionar en todos los sitios.

¿Qué es la API de Shared Storage?

La API de Shared Storage es una herramienta de almacenamiento de uso general diseñada para habilitar casos de uso entre sitios que preservan la privacidad. Con funciones similares a las APIs de localStorage y sessionStorage, Shared Storage es un almacén de clave-valor en el que se pueden escribir datos en cualquier momento. A diferencia de otras APIs de Web Storage, los datos de Shared Storage se pueden compartir en diferentes sitios de nivel superior. Sin embargo, solo se pueden leer desde un entorno seguro y generar con APIs de Output restringidas.

Diagrama que muestra el iframe de shoes.example incorporado en los sitios de diferentes publicadores, incluidos news.example y blog.example. El sitio shoes.com puede acceder a su propio almacenamiento no particionado desde cada sitio de nivel superior.

En el diagrama anterior, el sitio shoes.example se puede incorporar en otros sitios de publicadores, como news.example, y seguir accediendo a los mismos datos.

Esta capacidad de Shared Storage habilita las funciones entre sitios y, al mismo tiempo, mejora la privacidad del usuario, ya que evita el seguimiento de los visitantes individuales del sitio y restringe el acceso a los datos. Solo se puede acceder a los datos en un entorno seguro con capacidades de salida limitadas (worklets).

Diagrama que muestra que los sitios inscritos pueden escribir cualquier tipo de datos de clave/valor en el almacenamiento compartido, pero la lectura de los datos está restringida a APIs de salida específicas.

Shared Storage es la infraestructura de almacenamiento subyacente para una cantidad limitada de APIs de Output. Una API de salida es la única forma de usar los datos de Shared Storage. Las APIs de salida son las siguientes:

  • Seleccionar URL: Selecciona una URL de una lista proporcionada, según los datos almacenados, y, luego, renderiza ese contenido en un iframe delimitado.
  • Private Aggregation: Envía datos entre sitios a través de la API de Private Aggregation para generar un informe de resumen.

¿Por qué necesitamos Shared Storage?

La API de Shared Storage es un mecanismo de almacenamiento flexible que los desarrolladores web pueden usar en combinación con las APIs de salida para abordar muchos casos de uso, incluido el reemplazo de varios usos existentes de las cookies de terceros. Consulta más detalles sobre los posibles casos de uso de las APIs de salida: Select URL y Private Aggregation.

¿Tu empresa busca soluciones de almacenamiento en varios sitios que aún no se han abordado? Puedes compartir tu caso de uso y crear un problema en el repositorio de GitHub de Shared Storage de código abierto.

APIs de salida y casos de uso compatibles con Shared Storage

API de salida Caso de uso Descripción
Seleccionar URL Rotar creatividades de los anuncios Puedes almacenar datos, como el ID de la creatividad, los recuentos de vistas y la interacción del usuario, para determinar qué creatividad ven los usuarios en los diferentes sitios. Esto te permite equilibrar las vistas y evitar la sobresaturación de cierto contenido, y, de esta manera, evitar una posible experiencia del usuario negativa.
Seleccionar URL Ejecuta pruebas A/B Una prueba A/B compara dos o más versiones de una configuración para determinar cuál tiene el mejor rendimiento. Puedes asignar un usuario a un grupo de experimento y, luego, almacenar ese grupo en Shared Storage para el acceso entre sitios.
Seleccionar URL Personaliza la experiencia del usuario para los clientes conocidos Puedes compartir contenido personalizado y llamados a la acción en función del estado de registro de un usuario o de otros estados del usuario.
Seleccionar URL, Agregación privada Mitigaciones contra el abuso Las organizaciones de seguridad web, antifraude y contra el abuso suelen usar técnicas patentadas para detectar usuarios maliciosos, ya sean bots automatizados o personas reales que intentan causar daño. En este caso de uso, es posible probar muchas estrategias diferentes, ya sea usando la API de Select URL para codificar una calificación de confiabilidad del usuario o usando la API de Private Aggregation para compilar conjuntos de datos para la detección de anomalías.
Agregación privada Cómo medir el alcance único Muchos productores de contenido y anunciantes suelen querer saber cuántas personas únicas vieron su contenido mostrado. Puedes usar Shared Storage para informar la primera vez que un usuario ve tu anuncio, video incorporado o publicación. Puedes evitar el recuento duplicado del mismo usuario en un sitio diferente y generar un informe agregado con ruido para tu alcance aproximado de contenido único.
Agregación privada Cómo medir los datos demográficos de los usuarios Los productores de contenido desean comprender los datos demográficos de su público. Shared Storage te permite capturar datos demográficos del usuario en tu sitio de origen y aprovechar los informes agregados para analizar esta información en otras plataformas, como el contenido incorporado.
Agregación privada Cómo medir el alcance de frecuencia superior a K A veces se describe como "frecuencia efectiva", y suele haber una cantidad mínima de vistas antes de que un usuario reconozca o recuerde cierto contenido (a menudo, en el contexto de las vistas de anuncios). Puedes usar Shared Storage para generar informes de los usuarios únicos que vieron un contenido al menos K veces.

¿Cómo funciona Shared Storage?

Shared Storage te permite tomar decisiones fundamentadas basadas en datos de varios sitios, sin compartir información del usuario (como el historial del navegador o cualquier otro detalle personal) con un sitio incorporado ni filtrar datos a tus propios servidores.

Puedes escribir en el almacenamiento compartido en cualquier momento, pero solo puedes leer los valores de Shared Storage en un entorno seguro, conocido como worklet.

Los worklets de Shared Storage son donde agregas tu lógica de negocios y, luego, lees y procesas un valor de Shared Storage sin devolver directamente el valor exacto al llamador del worklet. Puedes usar las APIs de Private Aggregation o Select URL Output para extraer información del worklet. Es posible que haya APIs de salida adicionales disponibles a medida que se informen nuevos casos de uso.

Estado de la API

La API de Shared Storage está en disponibilidad general. Sigue las instrucciones para inscribirte en Privacy Sandbox y usar la API o habilitarla para el desarrollo local.

Propuesta Estado
Permite la escritura desde encabezados de respuesta
Explicación
Problema de GitHub
Disponible en M124. Se puede habilitar de forma manual en M119-M123.
Depuración de worklets de almacenamiento compartido con DevTools
Sección
Disponible en M120
Actualización del límite de almacenamiento de datos del almacenamiento compartido a 5 MB
Explicación
Disponible en M124
createWorklet() para crear worklets de origen cruzado sin un iframe Disponible en M125
Permite la secuencia de comandos de origen cruzado en addModule() y alinea createWorklet() para que coincida con el comportamiento Disponible en M130
Permitir que el worklet de almacenamiento compartido lea grupos de intereses
Explicación
Disponible en M134
Compatibilidad con orígenes de datos personalizados en createWorklet()
Explicación
Disponible en M135
Cómo depurar worklets de almacenamiento compartido con DevTools
Explicación
Error de GitHub
Se espera para el segundo trimestre de 2025

Interactúa y comparte comentarios

Ten en cuenta que la propuesta de la API de Shared Storage está en debate y desarrollo activos, por lo que está sujeta a cambios.

Nos encantaría conocer tu opinión sobre la API de Shared Storage.