Обзор API защищенной аудитории

Аукционы рекламы на устройствах для ремаркетинга и индивидуальных аудиторий без межсайтового отслеживания третьими лицами.

Для кого предназначен этот документ?

В этом документе рассматриваются основы API защищенной аудитории и объясняются некоторые базовые концепции, но не вдаются в технические подробности.

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

Ознакомьтесь с терминами, используемыми в документации по программе Protected Audience, в глоссарии . В конце этого документа вы узнаете, как получать и отправлять отзывы .

Что такое API защищенной аудитории?

Protected Audience API — это технология Privacy Sandbox, предназначенная для обслуживания случаев ремаркетинга и использования индивидуальных аудиторий, разработанная таким образом, чтобы третьи стороны не могли отслеживать поведение пользователей при просмотре веб-сайтов.

API защищенной аудитории позволяет браузеру проводить аукционы на устройстве, чтобы выбирать релевантные рекламные объявления с веб-сайтов, которые пользователь посещал ранее.

API защищенной аудитории (Protected Audience API) — первый экспериментальный проект, реализованный в Chromium в рамках семейства предложений TURTLEDOVE . Различия между Protected Audience и TURTLEDOVE в первую очередь заключаются в разделении ролей покупателя и продавца рекламы на устройстве. В следующих разделах объясняется, как работает API защищенной аудитории (Protected Audience API).

Защищенный API аудитории за одну минуту

Более подробный обзор API защищенной аудитории см. в руководстве разработчика API защищенной аудитории .

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

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

• Название группы интересов: например, «кастом-байки».
• Владелец группы интересов: например, «https://dsp.example».
• Информация о конфигурации группы интересов, позволяющая браузеру получать доступ к коду ставок, рекламному коду и данным в реальном времени, если владелец группы приглашен для участия в аукционе объявлений.

Позже, когда пользователь посещает сайт с доступным рекламным местом, продавец рекламного места ( поставщик услуг (SSP) или сам сайт) может использовать функцию Protected Audience для проведения аукциона объявлений, чтобы выбрать наиболее подходящие объявления для показа пользователю. Продавец вызывает функцию navigator.runAdAuction() , которая предоставляет список владельцев групп интересов, приглашенных к участию в торгах.

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

Код назначения ставок извлекается из URL-адреса, указанного в конфигурации группы интересов. Этот код предоставляет данные о группе интересов и информацию от продавца, а также контекстные данные о странице и из браузера.

Каждая группа интересов, подавшая заявку, называется покупателем.

Когда браузер вызывает функцию для запуска аукциона объявлений, код каждого покупателя генерирует ставку, используя данные в режиме реального времени, предоставляемые его сервисом Protected Audience Key/Value . Затем продавец получает эти ставки, а также собственные данные в режиме реального времени и оценивает каждую ставку. Ставка с наивысшим рейтингом выигрывает аукцион.

Победившее объявление отображается в рамке . URL-адрес рекламного креатива указан в заявке, а источник должен соответствовать одному из вариантов в списке, предоставленном конфигурацией группы интересов.

Продавец может сообщить о результатах аукциона ( reportResult() ), а покупатели могут сообщить о своих победах ( reportWin() ).

Узнайте больше об отчетах по аукционам Protected Audience .

Зачем нам нужен API защищенной аудитории?

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

Традиционно рекламные платформы изучали интересы пользователей, отслеживая их поведение на разных сайтах. Браузерам необходимо предоставить рекламным платформам возможность выбирать релевантные объявления, чтобы издатели контента могли получать доход от рекламы без межсайтового отслеживания.

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

Как я могу попробовать API защищенной аудитории?

• В руководстве разработчика API защищенной аудитории описывается, как использовать API и как проводить локальное тестирование.

• protected-audience-demo.web.app представляет собой пошаговое руководство по базовому развертыванию защищенной аудитории на сайтах рекламодателей и издателей. В демонстрационном видеоролике о защищенной аудитории объясняется работа этого кода и демонстрируется использование Chrome DevTools для отладки.

Какая конфигурация браузера доступна?

Пользователи могут настроить своё участие в пробных версиях Privacy Sandbox в Chrome, включив или отключив соответствующий параметр верхнего уровня на chrome://settings/adPrivacy . Во время первоначального тестирования пользователи могут отказаться от API Protected Audience, используя настройки Privacy Sandbox.

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

Мы будем обновлять доступные настройки в Chrome по мере развития API Protected Audience, основываясь на результатах тестирования и отзывов . В будущем мы предложим более детальные настройки для управления Protected Audience и связанными с ним данными.

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

Могу ли я отказаться от API защищенной аудитории?

Узнайте, как можно заблокировать доступ к API защищенной аудитории , будь то владелец сайта или отдельный пользователь.

Ключевые концепции

Хотите узнать больше о терминологии «Защищённая аудитория»? Обратитесь к глоссарию Privacy Sandbox .

Что такое группа интересов?

Группа интересов API защищенной аудитории представляет собой группу людей с общими интересами, соответствующую списку ремаркетинга .

У каждой группы интересов API Protected Audience есть владелец. Разные типы владельцев создают разные типы групп интересов с разными вариантами использования.

Владелец запрашивает у браузера пользователя добавление членства в группе интересов, вызывая функцию JavaScript navigator.joinAdInterestGroup() , предоставляя информацию, такую ​​как данные о рекламных объявлениях, релевантных группе интересов, и URL для JavaScript, используемого при торгах. Данные группы интересов (например, сами объявления) можно обновлять, а сама группа интересов может быть включена на срок до 30 дней.

Типы групп интересов

В следующей таблице приведены примеры различных типов групп интересов и владельцев API защищенной аудитории.

Chrome позволяет создать до 1000 групп по интересам на одного владельца и до 1000 владельцев групп по интересам. Эти ограничения являются лишь ограничивающими и не должны нарушаться при обычной работе.

Кто такой покупатель?

В API защищенной аудитории покупатель — это сторона, которая владеет группой интересов и делает ставки на аукционе рекламы.

Например:

• Рекламодатель : действует в своих интересах.
• Платформа спроса (DSP): действует в интересах рекламодателей.
• Владелец группы по интересам : работает с несколькими рекламодателями.

У покупателей есть три задачи:

• Выберите, хотите ли вы участвовать в аукционе.
• Выбирайте объявления и рассчитывайте ставку.
• Сообщите результаты аукциона.

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

Когда покупатель просит браузер пользователя добавить группу по интересам к группам, в которых он состоит (вызывая функцию JavaScript navigator.joinAdInterestGroup() ), покупатель предоставляет браузеру:

• URL-адрес для кода торгов, который будет использоваться, когда продавец проводит аукцион объявлений .
• Потенциально URL-адреса рекламных объявлений для группы по интересам. (URL-адреса рекламных объявлений могут быть добавлены позже с обновлением.)
• Список ключей данных, которые необходимо запросить, и URL-адрес службы «ключ/значение» покупателя, чтобы код торгов мог получать данные в режиме реального времени во время аукциона.

Код покупателя также может включать функцию reportWin() для сообщения о результатах аукциона.

Кто проводит аукцион рекламы?

Есть несколько сторон, которые могут проводить аукцион по продаже рекламного пространства.

Например:

• Издатель контента : действующий в своих интересах с целью размещения рекламного контента на своем веб-сайте.
• Платформа предложения (SSP): работа с издателем и предоставление других услуг.
• Сторонний скрипт : действующий от имени издателя и позволяющий участвовать в аукционах рекламы.

Благодаря API защищенной аудитории продавец рекламного пространства выполняет три задачи:

• Обеспечить соблюдение правил издателя: указать, какие покупатели и какие ставки имеют право на участие.
• Запуск логики аукциона: запуск JavaScript в рабочих программах для расчета показателя желательности для каждой ставки.
• Сообщите результаты аукциона.

Эти задачи выполняются программно, в коде, предоставляемом продавцом, когда он инициирует аукцион объявлений путем вызова функции JavaScript navigator.runAdAuction() .

Как работает аукцион рекламы Protected Audience API?

На следующей диаграмме показан каждый этап аукциона рекламы API защищенной аудитории:

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

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

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

1. Пользователь посещает сайт, на котором отображается реклама.
2. Код продавца запускает аукцион. Продавец указывает, какое рекламное место продаётся и кто может делать ставки, а также метод оценки этих ставок.
3. Код приглашенного покупателя выполняется для генерации ставки, URL-адреса соответствующего рекламного объявления и других данных. Скрипт назначения ставок может запрашивать данные в режиме реального времени, например, об оставшемся бюджете рекламной кампании, из сервиса «ключ-значение» покупателя.
4. Код продавца оценивает каждую ставку и выбирает победителя. Эта логика использует значение ставки и другие данные для определения привлекательности ставки и отклонения объявления, которое не может превзойти победителя по контекстной рекламе. Продавец может использовать собственный сервис «ключ-значение» для получения данных в режиме реального времени. Перед началом аукциона продавец подбирает лучшее контекстное объявление для доступного рекламного места.
5. Победившее объявление возвращается в виде объекта конфигурации огороженного фрейма, если в конфигурации аукциона установлен флаг resolveToConfig . Этот объект конфигурации используется для навигации между огороженным фреймом и креативом, а URL-адрес креатива скрыт как от продавца, так и от издателя. Если флаг resolveToConfig установлен в false или не передан, победившее объявление возвращается в виде непрозрачного URN , который можно использовать для отображения объявления в iframe. Объект конфигурации огороженного фрейма доступен, начиная с версии M114.
6. О результатах аукциона сообщается продавцу и победившим покупателям.

Обсуждается механизм информирования о потерях покупателей.

Что такое служба «ключ/значение API защищенной аудитории»?

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

Сервис Key/Value развёрнут в собственной облачной инфраструктуре рекламного специалиста и работает в доверенной среде выполнения . Запрос к сервису Key/Value не может привести к регистрации событий на уровне журнала или иметь другие побочные эффекты. Сервис Key/Value также поддерживает пользовательские функции (UDF) , позволяющие рекламным специалистам реализовывать собственную логику в сервисе Key/Value.

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

Код сервиса «Ключ/значение» защищенного API аудитории теперь доступен в репозитории Privacy Sandbox на GitHub . Этот сервис может использоваться разработчиками Chrome и Android.

Дополнительную информацию о сервисе «ключ/значение API» защищенной аудитории можно получить из объяснения API и объяснения модели доверия .

Как данные в реальном времени используются в аукционах?

Покупателям или продавцам на аукционе рекламы может потребоваться доступ к данным в режиме реального времени. Например, покупателям может потребоваться рассчитать оставшийся бюджет рекламной кампании, а продавцу — сверить рекламные материалы с политикой издателя.

Для соответствия требованиям конфиденциальности API Protected Audience данные в режиме реального времени, необходимые во время аукциона рекламы, предоставляются службой Key/Value . Когда каждый покупатель вызывает navigator.joinAdInterestGroup() , он указывает URL-адрес службы Key/Value и указывает ключи, которые будут запрашиваться в службе во время аукциона. Аналогично, когда продавец проводит аукцион рекламы, вызывая navigator.runAdAuction() , он предоставляет URL-адрес своей службы Key/Value. Служба Key/Value продавца будет запрошена с URL-адресом рендеринга креатива.

Для начального тестирования используется модель «Bring Your Own Server» (Принеси свой сервер) . В долгосрочной перспективе специалистам по рекламе потребуется использовать службы Key/Value API Protected Audience с открытым исходным кодом, работающие в доверенных средах выполнения для получения данных в режиме реального времени.

Чтобы обеспечить экосистеме достаточно времени для тестирования, мы не планируем требовать использования открытых сервисов Key/Value или доверенных сред выполнения до тех пор, пока не будет прекращена поддержка сторонних файлов cookie. Мы заблаговременно уведомим разработчиков о начале тестирования и внедрения до начала этого перехода.

Как используются данные первой стороны в аукционе защищенной аудитории?

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

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

Например, если рекламодатель знает любимый цвет пользователя, значение можно задать в конфигурации группы интересов как userBiddingSignals при добавлении пользователя в группу интересов:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

Издатель также может передавать свои собственные данные, устанавливая сигналы в конфигурации аукциона при его запуске, и может контролировать, кто получает эти данные. Когда издатель передает собственные данные как auctionSignals , они доступны как покупателям, так и продавцам. Когда данные передаются как sellerSignals , они доступны только продавцу, а когда передаются как perBuyerSignals , они доступны только указанным покупателям. Издатель также может передавать собственные данные в аукционы компонентов. Издатель и участники аукциона должны заранее договориться о том, какие именно собственные данные должны быть переданы и как эти данные должны быть отформатированы.

В следующем примере описывается, как издатель может передавать собственные данные различным участникам аукциона:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

Узнать больше

Более подробный обзор API защищенной аудитории см. в руководстве разработчика API защищенной аудитории .

Разработчики

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

Мы написали руководство для разработчиков API и создали демонстрационную версию API Protected Audience , которая предлагает пошаговое руководство по базовому развертыванию API Protected Audience. В демонстрационном видеоролике Protected Audience API объясняется работа демо-кода и показано, как использовать Chrome DevTools для отладки API Protected Audience.

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

• GitHub : прочитайте пояснение , задайте вопросы и следите за обсуждениями .
• Объявления : присоединяйтесь или просматривайте прошлые объявления в списке рассылки Protected Audience API .
• W3C : Обсудите варианты использования в отрасли в группе по улучшению веб-рекламы .
• Текущая реализация : По вопросам реализации защищенной аудитории в Chrome: сообщите об ошибке Chromium .