Эта страница переведена с помощью Cloud Translation API.

Настройте пользовательский интерфейс для известных клиентов

Используйте рабочийлет общего хранилища для идентификации известных клиентов.

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

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

Установить известных клиентов

Чтобы поэкспериментировать с идентификацией известных клиентов в общем хранилище, подтвердите, что вы используете Chrome 104.0.5086.0 или более поздней версии. Затем включите флаг эксперимента Privacy Sandbox Ads API на chrome://flags/#privacy-sandbox-ads-apis .

Установите для эксперимента API Privacy Sandbox Ads значение «Включено», чтобы использовать эти API.

Вы также можете включить общее хранилище с помощью флага --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames в командной строке.

Экспериментируйте с примерами кода

Возможно, вы захотите отобразить другой элемент в зависимости от того, был ли пользователь замечен на другом сайте. Например, поставщик платежей может захотеть отобразить кнопку «Зарегистрироваться» или «Купить сейчас» в зависимости от того, зарегистрировался ли пользователь на сайте поставщика платежей. Общее хранилище можно использовать для установки статуса пользователя и настройки его взаимодействия с пользователем на основе этого статуса.

В этом примере:

known-customer.js встроен в фрейм. Этот скрипт задает параметры, какая кнопка должна отображаться на сайте: «Зарегистрироваться» или «Купить сейчас».
known-customer-worklet.js — это рабочий модуль общего хранилища, который определяет, известен ли пользователь. Если пользователь известен, информация возвращается. Если пользователь неизвестен, эта информация возвращается для отображения кнопки «Зарегистрироваться», и пользователь помечается как известный на будущее.

известный-клиент.js

// The first URL for the "register" button is rendered for unknown users.
const BUTTON_URLS = [
  { url: `https://${advertiserUrl}/ads/register-button.html` },
  { url: `https://${advertiserUrl}/ads/buy-now-button.html` },
];

async function injectButton() {
  // Load the worklet module
  await window.sharedStorage.worklet.addModule('known-customer-worklet.js');

  // Set the initial status to unknown ('0' is unknown and '1' is known)
  window.sharedStorage.set('known-customer', 0, {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation to choose the button based on the user status
  const fencedFrameConfig = await window.sharedStorage.selectURL('known-customer', BUTTON_URLS, {
    resolveToConfig: true
  });

  // Render the opaque URL into a fenced frame
  document.getElementById('button-slot').src = fencedFrameConfig;
}

injectButton();

известный-клиент-worklet.js

class SelectURLOperation {
  async run(urls) {
    const knownCustomer = await this.sharedStorage.get('known-customer');

    // '0' is unknown and '1' is known
    return parseInt(knownCustomer);
  }
}

register('known-customer', SelectURLOperation);

Случаи использования

Это лишь некоторые из возможных вариантов использования общего хранилища. Мы продолжим добавлять примеры по мере получения отзывов и обнаружения новых вариантов использования.

Выбор контента

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

Ротация креативов . Сохраняйте такие данные, как идентификатор креатива, количество просмотров и взаимодействие с пользователем, чтобы определить, какие креативы пользователи видят на разных сайтах.
A/B-тестирование . Вы можете назначить пользователя в экспериментальную группу, а затем сохранить эту группу в общем хранилище для доступа к ней между сайтами.
Пользовательский интерфейс : делитесь персонализированным контентом и призывами к действию на основе статуса регистрации пользователя или других состояний пользователя.

Создание сводных отчетов

Соберите информацию с помощью Shared Storage и создайте зашумленный агрегированный сводный отчет. Выходным шлюзом для этих вариантов использования является Private Aggregation API .

Измерение уникального охвата . Многие производители контента и рекламодатели хотят знать, сколько уникальных людей просмотрело их контент. Используйте общее хранилище, чтобы записать, когда пользователь впервые увидел вашу рекламу, встроенное видео или публикацию, и предотвратить повторный учет одного и того же пользователя на разных сайтах. Затем вы можете использовать Private Aggregation API для вывода сводного отчета для вашего охвата.
Измерение демографии . Производители контента часто хотят понять демографию своей аудитории. Вы можете использовать общее хранилище для записи демографических данных пользователей в контексте, в котором они у вас есть, например на вашем собственном сайте, и использовать агрегированные отчеты для составления отчетов по ним на многих других сайтах, таких как встроенный контент.
Измерение частоты K+ : иногда описываемое как «эффективная частота». Часто бывает минимальное количество просмотров, прежде чем пользователь узнает или вспомнит определенный контент (часто в контексте просмотров рекламы). Вы можете использовать общее хранилище для создания отчетов об уникальных пользователях, которые просмотрели часть контента не менее K раз.

Случаи использования

Выбор контента

Ротация креативов . Сохраняйте такие данные, как идентификатор креатива, количество просмотров и взаимодействие с пользователем, чтобы определить, какие креативы пользователи видят на разных сайтах.
A/B-тестирование . Вы можете назначить пользователя в экспериментальную группу, а затем сохранить эту группу в общем хранилище для доступа к ней между сайтами.
Пользовательский интерфейс : делитесь персонализированным контентом и призывами к действию на основе статуса регистрации пользователя или других состояний пользователя.

Создание сводных отчетов

Измерение уникального охвата . Многие производители контента и рекламодатели хотят знать, сколько уникальных людей просмотрело их контент. Используйте общее хранилище, чтобы записать, когда пользователь впервые увидел вашу рекламу, встроенное видео или публикацию, и предотвратить повторный учет одного и того же пользователя на разных сайтах. Затем вы можете использовать Private Aggregation API для вывода сводного отчета для вашего охвата.
Измерение демографии . Производители контента часто хотят понять демографию своей аудитории. Вы можете использовать общее хранилище для записи демографических данных пользователей в контексте, в котором они у вас есть, например на вашем собственном сайте, и использовать агрегированные отчеты для составления отчетов по ним на многих других сайтах, таких как встроенный контент.
Измерение частоты K+ : иногда описываемое как «эффективная частота». Часто бывает минимальное количество просмотров, прежде чем пользователь узнает или вспомнит определенный контент (часто в контексте просмотров рекламы). Вы можете использовать общее хранилище для создания отчетов об уникальных пользователях, которые просмотрели часть контента не менее K раз.

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

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

GitHub : Прочитайте предложение , задайте вопросы и участвуйте в обсуждении .
Объявления об API общего хранилища : присоединяйтесь или просматривайте прошлые объявления в нашем списке рассылки.
Поддержка разработчиков : задавайте вопросы и присоединяйтесь к обсуждениям в репозитории поддержки разработчиков Privacy Sandbox .