Узнайте, как определить целевую аудиторию, создав группу интересов с помощью API защищенной аудитории. Ознакомьтесь с руководством для разработчиков , чтобы узнать о полном жизненном цикле API защищенной аудитории, и обратитесь к пояснению к API защищенной аудитории для более подробного описания того, как браузеры записывают группы интересов .
Не являетесь разработчиком? Ознакомьтесь с обзором API для защищенной аудитории .
Группы интересов API защищенной аудитории
Группа интересов в рамках API защищенной аудитории представляет собой группу людей с общими интересами, соответствующую списку ремаркетинга . Каждая группа интересов в рамках API защищенной аудитории имеет владельца .
В аукционе рекламы с использованием API защищенной аудитории владельцы групп интересов выступают в роли покупателей. Информация о принадлежности к группе интересов хранится браузером на устройстве пользователя и не передается поставщику браузера или кому-либо еще.
Функции API
joinAdInterestGroup()
Платформа рекламодателя (DSP) или сам рекламодатель вызывает navigator.joinAdInterestGroup() , чтобы запросить у браузера добавление группы интересов в список участников браузера.
Источник контекста вызова функции joinAdInterestGroup() должен совпадать с источником владельца группы интересов, поэтому joinAdInterestGroup() необходимо вызывать из iframe (например, из DSP), если только источник владельца группы интересов не совпадает с источником текущего документа (например, веб-сайта со своими собственными группами интересов).
Для joinAdInterestGroup() требуется разрешение от:
- Посещаемый сайт
- Владелец группы интересов
Это означает, что malicious.example не может вызвать функцию joinAdInterestGroup() для группы интересов, принадлежащей dsp.example.com , без разрешения dsp.example.com .
Разрешение от посещаемого сайта
Разрешение может быть предоставлено как с того же источника, так и с другого. По умолчанию разрешение предоставляется для вызовов joinAdInterestGroup() с того же источника, что и посещаемый сайт (другими словами, с того же источника, что и фрейм верхнего уровня текущей страницы).
Пример использования
Вот пример того, как можно определить группу по интересам и предложить пользователю присоединиться к ней.
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
biddingLogicUrl: ...,
biddingWasmHelperUrl: ...,
updateUrl: ...,
trustedBiddingSignalsUrl: ...,
trustedBiddingSignalsKeys: ['key1', 'key2'],
userBiddingSignals: {...},
ads: [bikeAd1, bikeAd2, bikeAd3],
adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
Объект interestGroup передаваемый в функцию, не должен превышать 50 киБ, иначе вызов завершится неудачей. Второй параметр задает продолжительность группы интересов, ограниченную 30 днями. Последующие вызовы перезаписывают ранее сохраненные значения.
Необходимые свойства
Единственными обязательными свойствами для групп по интересам являются owner и name :
| Свойство | Пример | Роль |
|---|---|---|
owner | https://dsp.example | Происхождение владельца группы интересов. |
name | custom-bikes | Название группы по интересам. |
Дополнительные свойства
Остальные свойства являются необязательными:
-
biddingLogicUrl1 , 2 - Пример:
https://dsp.example/bid/custom-bikes/bid.js - Роль: URL для запуска JavaScript-кода в рабочем модуле.
-
biddingWasmHelperUrl1 , 2 - Пример:
https://dsp.example/bid/custom-bikes/bid.wasm - Роль: URL-адрес для кода WebAssembly, управляемый из
biddingLogicUrl. -
updateUrl2 - Пример:
https://dsp.example/bid/custom-bikes/update - Роль: URL-адрес, возвращающий JSON для обновления атрибутов группы интересов. (См. Обновление данных аудитории и обновление объявлений .)
-
trustedBiddingSignalsUrl2 - Пример:
https://dsp.example/trusted/bidding-signals - Роль: Базовый URL для запросов типа «ключ-значение» к доверенному сервису «ключ/значение» участника торгов.
-
trustedBiddingSignalsKeys - Пример:
['key1', 'key2' ...] - Роль: Ключи для запросов к доверенному сервису «ключ-значение» (Key/Value).
-
userBiddingSignals - Пример:
{...} - Роль: Дополнительные метаданные, которые владелец может использовать во время торгов.
-
ads1 - Пример:
[bikeAd1, bikeAd2, bikeAd3] - Роль: Реклама, которая может быть показана для данной целевой группы.
-
adComponents - Пример:
[customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2] - Роль: Компоненты для рекламных объявлений, состоящих из нескольких частей .
1. Свойства biddingLogicUrl и ads являются необязательными, но необходимы для участия в аукционе. Могут быть сценарии использования, когда группа интересов создается без этих свойств: например, владелец группы интересов может захотеть добавить браузер в группу интересов для кампании, которая еще не запущена, или для какого-либо другого будущего использования, или у него временно закончился рекламный бюджет.
2. В текущей реализации API защищенной аудитории значения biddingLogicUrl , biddingWasmHelperUrl , updateUrl и trustedBiddingSignalsUrl должны иметь тот же источник, что и владелец. Это может не быть долгосрочным ограничением, и для URL-адресов ads и adComponents такого ограничения нет.
Укажите целевую аудиторию для показа рекламы.
Объекты ads и adComponents содержат URL-адрес рекламного креатива и, при необходимости, произвольные метаданные, которые могут использоваться во время торгов.
Например:
{
renderUrl: 'https://cdn.example/.../bikeAd1.html',
metadata: bikeAd1metadata // optional
}
leaveAdInterestGroup()
Владелец группы по интересам может запросить удаление браузера из группы по интересам. Браузер удаляет группу по интересам из списка своих участников.
navigator.leaveAdInterestGroup({
owner: 'https://dsp.example',
name: 'custom-bikes'
});
Если пользователь возвращается на сайт, который запросил у браузера добавление группы интересов, владелец группы интересов может вызвать функцию navigator.leaveAdInterestGroup() , чтобы запросить у браузера удаление группы интересов.
Код рекламного объявления также может вызывать эту функцию для своей целевой группы.
Часто задаваемые вопросы
Каково максимальное количество групп интересов, которые может создать один пользователь, являющийся владельцем группы?
Chrome позволяет создавать до 1000 групп интересов на одного владельца и до 1000 владельцев групп интересов. Эти ограничения предназначены в качестве мер предосторожности и не должны превышаться в процессе обычной работы.
Как я могу максимально эффективно использовать рекламу для целевых групп, соответствующих пороговым значениям анонимности (k-anon)?
Как отмечается в пояснительной записке, поскольку одна группа интересов может показывать несколько вариантов рекламы, у группы будет возможность повторно выставить на аукцион другую свою рекламу в качестве «резервной» всякий раз, когда ее наиболее предпочтительный вариант окажется ниже порогового значения. Это означает, что небольшая специализированная реклама, которая все еще находится ниже порога анонимности (k), может участвовать в аукционах, и у ее группы интересов есть возможность вернуться к более общей рекламе, пока у более специализированной не будет достаточно большой аудитории.
С тактической точки зрения, вы можете рассмотреть следующее:
- Чтобы новое объявление начало показываться, просто начните делать ставки в тех случаях, когда вы хотите, чтобы оно отображалось. Ничего дополнительного делать не нужно.
- Вы можете использовать резервное объявление, когда новые объявления не являются анонимными (k-anon). Существует некоторый риск того, что само резервное объявление не является анонимным, поэтому вы можете рассмотреть возможность иногда просто использовать резервное объявление в качестве ставки. Например, делайте это в 1% случаев, если это хороший уровень, чтобы гарантировать, что резервное объявление будет оставаться выше порогового значения.
В последнее время обсуждались и другие варианты работы, поэтому, если у вас есть сценарий использования, для которого этот механизм может представлять проблему, продолжайте участвовать в публичном обсуждении способов улучшения API.
Все ссылки на API защищенной аудитории
Справочные руководства по API доступны:
- Руководство разработчика по API Protected Audience .
- Руководство для покупателей рекламы по группам интересов защищенной аудитории и формированию ставок .
- Руководство для продавцов рекламы по рекламным аукционам для защищенной аудитории.
- Руководство по сообщению о результатах аукциона
- Рекомендации по устранению задержки на аукционе объявлений для защищенной аудитории
- Устранение неполадок с защищенной аудиторией
Объяснение API Protected Audience также содержит подробную информацию о поддержке функций и ограничениях.