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

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

Для кого эта статья?

В этой статье рассматриваются основы API Protected Audience и объясняются некоторые основные концепции, но не вдаются в подробности.

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

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

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

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

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

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

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

Обзор каждого этапа жизненного цикла API Protected Audience.
Жизненный цикл API защищенной аудитории:.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • В руководстве разработчика API Protected Audience описано, как использовать 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 на основе тестов и отзывов . В будущем мы предложим более детальные настройки для управления Защищенной аудиторией и связанными с ней данными.

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

Могу ли я отказаться от API Protected Audience?

Узнайте, как заблокировать доступ к API Protected Audience как владельца сайта, так и отдельного пользователя.

Ключевые идеи

Ищете дополнительную информацию о терминологии защищенной аудитории? См. глоссарий Privacy Sandbox .

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

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

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

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

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

Владелец Пример Интерес Пример Случаи использования
Рекламодатель Производитель велосипедов Продукты Люди, просматривавшие страницы товаров определенной категории велосипедов. Ремаркетинг для людей, которые ранее взаимодействовали с брендом.
Издатель Новостной сайт Содержание Люди, которые читают о велоспорте. Издатели могут использовать собственные данные, чтобы рекламодатели могли покупать на их сайте рекламу, которая интересна читателям. Группа интересов, принадлежащая издателям, может позволить издателям делать то же самое, даже когда эти люди просматривают другие сайты. Издатели могут иметь возможность взимать плату за возможность показывать рекламу определенным сегментам своей аудитории.
Рекламные технологии ЦСП Категория продукции Люди, проявившие интерес к велосипедному снаряжению. Компания, занимающаяся рекламными технологиями, может создавать и управлять группой людей по интересам, которые, по их мнению, ищут на рынке определенную категорию товаров. Эту группу интересов можно затем использовать для рекламы продуктов на сайтах, которые продают товары этой категории (и которые сотрудничают с рекламной технологической компанией).

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

Что такое покупатель?

В API Protected Audience покупателем является сторона, которая владеет группой интересов и делает ставки на аукционе рекламы.

Например:

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

У покупателей есть три работы:

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

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

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

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

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

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

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

Например:

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

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

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

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

Как работает аукцион объявлений Protected Audience API?

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

Шесть этапов рекламного аукциона API Protected Audience API

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

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

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

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

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

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

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

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

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

Код службы ключей и значений API Protected Audience теперь доступен в репозитории Privacy Sandbox GitHub . Этот сервис могут использовать разработчики Chrome и Android.

Узнайте больше о службе «ключ-значение API защищенной аудитории» в пояснении API и пояснении модели доверия .

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

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

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

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

Чтобы гарантировать, что у экосистемы будет достаточно времени для тестирования, мы не планируем требовать использования служб «ключ-значение» с открытым исходным кодом или доверенных сред выполнения до тех пор, пока не произойдет прекращение поддержки сторонних файлов 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 Protected Audience можно найти в руководстве разработчика API Protected Audience .

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

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

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

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