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

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

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

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

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

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

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

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

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

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

API для защиты аудитории за одну минуту

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

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

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

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

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

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

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

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

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

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

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

Узнайте о отчетах по аукционам с участием защищенной аудитории .

Зачем нам нужен API для работы с защищенной аудиторией?

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

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

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

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

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

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

Какие настройки браузера доступны?

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

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

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

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

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

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

Ключевые понятия

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

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

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

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

Владелец запрашивает у браузера пользователя добавление членов в группу интересов, вызывая функцию 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() .

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

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

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

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

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

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

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

Что такое сервис API Key/Value с защитой аудитории?

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

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

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

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

Подробнее о сервисе «Защищенная аудитория: ключ/значение API» можно узнать из пояснения к API и пояснения к модели доверия .

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

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

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

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

Чтобы гарантировать наличие достаточного времени для тестирования в экосистеме, мы не ожидаем, что нам потребуется использовать сервисы 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 для защищенной аудитории , который предлагает пошаговое руководство по развертыванию базового API для защищенной аудитории. Видеодемонстрационный ролик объясняет, как работает демонстрационный код, и показывает, как использовать инструменты разработчика Chrome для отладки API для защищенной аудитории.

Принимайте участие и делитесь отзывами.

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