Обзор общего хранилища

API общего хранилища позволяет веб-сайтам хранить и получать доступ к данным, которые не изолированы основным сайтом. Это обеспечивает и упрощает сценарии использования между сайтами, соблюдая при этом конфиденциальность пользователей.

Хотя Chrome использует разделение хранилища и переходит к новому интерфейсу, расширяющему возможности пользователя в отношении сторонних файлов cookie , существует ряд законных сценариев использования, которые зависят от неразделенного хранилища и которые были бы невозможны без помощи новых веб-API. Например, производитель контента может захотеть измерить охват контента на разных сайтах, не полагаясь на межсайтовые идентификаторы. API общего хранилища решает эту задачу, предоставляя более конфиденциальный механизм для хранения и доступа к неразделенным данным на разных сайтах.

Что такое API общего хранилища?

API Shared Storage — это универсальное хранилище данных, предназначенное для обеспечения конфиденциальности при работе в различных средах. Обладая функциями, аналогичными API localStorage и sessionStorage, Shared Storage представляет собой хранилище типа «ключ-значение», в которое можно записывать данные в любое время. В отличие от других API веб-хранилищ, данные Shared Storage могут совместно использоваться на разных сайтах верхнего уровня; однако чтение данных Shared Storage возможно только из защищенной среды, а вывод — с использованием ограниченных API вывода.

Диаграмма, показывающая iframe shoes.example, встроенный в сайты различных издателей, включая news.example и blog.example. Сайт shoes.com может получать доступ к собственному неразделённому хранилищу с каждого из сайтов верхнего уровня.

На приведенной выше диаграмме показано, что сайт shoes.example может быть встроен в другие сайты издателей, такие как news.example , и при этом получать доступ к тем же данным.

Функция общего хранилища обеспечивает межсайтовую совместимость, одновременно повышая уровень конфиденциальности пользователей за счет предотвращения отслеживания отдельных посетителей сайта и ограничения доступа к данным. Доступ к данным возможен только в защищенной среде с ограниченными возможностями вывода (рабочие модули).

На диаграмме показано, что зарегистрированные сайты могут записывать в общее хранилище любые типы данных типа ключ/значение, но чтение данных ограничено определенными API для вывода.

Shared Storage — это базовая инфраструктура хранения данных для ограниченного числа Output API. Output API — единственный способ использовать данные из Shared Storage. К Output API относятся:

  • Выберите URL : выберите URL из предоставленного списка на основе сохраненных данных, а затем отобразите это содержимое в рамке, заключенной в рамку.
  • Частная агрегация : Отправляйте данные между сайтами через API частной агрегации для создания сводного отчета .

Зачем нам нужно общее хранилище данных?

API общего хранилища — это гибкий механизм хранения, который веб-разработчики могут использовать в сочетании с API вывода для решения множества задач, включая замену ряда существующих способов использования сторонних файлов cookie. Подробнее о потенциальных вариантах использования API вывода см.: Выбор URL-адреса и частная агрегация .

Ваша компания ищет решения для межсайтового хранения данных, которые еще не были предложены? Вы можете поделиться своим примером использования и создать заявку в репозитории GitHub с открытым исходным кодом Shared Storage .

API для вывода данных и сценарии использования, совместимые с общим хранилищем.

API вывода Вариант использования Описание
Выберите URL Поворот рекламных креативов Вы можете хранить данные, такие как идентификатор креатива, количество просмотров и взаимодействие с пользователями, чтобы определить, какой креатив пользователи видят на разных сайтах. Это позволяет сбалансировать просмотры и избежать перенасыщения определенным контентом, тем самым предотвращая возможное негативное взаимодействие с пользователями.
Выберите URL Проведите A/B-тестирование A/B-тестирование сравнивает две или более версий конфигурации, чтобы определить, какая из них работает лучше всего. Вы можете назначить пользователя в экспериментальную группу, а затем сохранить эту группу в общем хранилище для доступа между сайтами.
Выберите URL Настройка пользовательского интерфейса для постоянных клиентов Вы можете делиться пользовательским контентом и призывами к действию в зависимости от статуса регистрации пользователя или других состояний пользователя.
Выберите URL , Частная агрегация Меры по предотвращению злоупотреблений Организации, занимающиеся борьбой со злоупотреблениями, мошенничеством и веб-безопасностью, часто используют собственные методы для выявления злонамеренных пользователей, будь то автоматизированные боты или реальные люди, пытающиеся причинить вред. В этом случае можно протестировать множество различных стратегий, будь то использование API выбора URL-адреса для кодирования рейтинга доверия пользователя или использование API частной агрегации для создания наборов данных для обнаружения аномалий.
Частная агрегация Измерьте уникальный охват Многие создатели контента и рекламодатели часто хотят знать, сколько уникальных пользователей просмотрели их контент. Вы можете использовать Shared Storage для составления отчетов о первом просмотре пользователем вашей рекламы, встроенного видео или публикации. Это позволит избежать дублирования подсчета одного и того же пользователя на разных сайтах и ​​позволит создать сводную, но неполную отчетность по приблизительному охвату уникального контента.
Частная агрегация Измерение демографических данных пользователей Производители контента стремятся понять демографические характеристики своей аудитории. Shared Storage позволяет собирать демографические данные пользователей на вашем собственном сайте и использовать агрегированные отчеты для анализа этой информации на различных других платформах, например, во встроенном контенте.
Частная агрегация Измерение диапазона частот K+ Иногда это называют «эффективной частотой», и часто существует минимальное количество просмотров, прежде чем пользователь узнает или вспомнит определенный контент (часто в контексте просмотра рекламы). Вы можете использовать Shared Storage для создания отчетов об уникальных пользователях, которые просмотрели контент не менее K раз.

Как работает общее хранилище данных?

Общее хранилище позволяет принимать обоснованные решения на основе данных, полученных с разных сайтов, без передачи информации о пользователях (например, истории браузера или других личных данных) на сайт, на который вы внедряете контент, и без утечки данных на ваши собственные серверы.

Запись в общее хранилище возможна в любое время, но чтение значений из общего хранилища возможно только в защищенной среде, известной как рабочий модуль (worklet).

В рабочих процессах с общим хранилищем вы добавляете свою бизнес-логику, а затем считываете и обрабатываете значение из общего хранилища, не возвращая напрямую точное значение вызывающему рабочему процессу. Для извлечения информации из рабочего процесса можно использовать либо API частной агрегации, либо API выбора URL-адреса. Дополнительные API вывода могут стать доступны по мере появления новых вариантов использования.

статус API

API общего хранилища находится в стадии общедоступности . Следуйте инструкциям, чтобы зарегистрироваться в «песочнице конфиденциальности» , использовать API или включить его для локальной разработки.

Предложение Статус
Разрешить запись из заголовков ответов
Объяснитель
Проблема с GitHub
Доступен в исполнении М124. Можно включить вручную в M119-M123.
Отладка рабочих модулей общего хранилища с помощью DevTools
Раздел
Доступен в M120
Обновить лимит хранилища данных общего хранилища до 5 МБ.
Объяснитель
Доступен в M124
createWorklet() для создания рабочих модулей из разных источников без iframe Доступен в M125
Разрешите скрипт перекрестного происхождения в addModule() и выровняйте createWorklet() в соответствии с поведением. Доступен в M130
Разрешить рабочему элементу Shared Storage читать группы по интересам
Объяснитель
Доступен в M134
Поддержка пользовательского происхождения данных в createWorklet()
Объяснитель
Доступен в M135
Отладка рабочих модулей общего хранилища с помощью DevTools
Объяснитель
Проблема с GitHub
Ожидается во втором квартале 2025 г.

Привлекайте и делитесь отзывами

Обратите внимание, что предложение API общего хранилища находится в стадии активного обсуждения и разработки и поэтому может быть изменено.

Мы с нетерпением ждем вашего мнения об API общего хранилища.