Узнайте, как обновить данные об аудитории, настроив URL-адрес обновления для группы интересов Protected Audience API. Прочтите руководство для разработчиков , чтобы узнать о полном жизненном цикле API Protected Audience, а также обратитесь к объяснению API Protected Audience, чтобы получить подробное описание того, как браузеры записывают группы по интересам .
Не разработчик? См. обзор API Protected Audience .
Группы по интересам API защищенной аудитории
Группа интересов Protected Audience API представляет собой группу людей с общими интересами, соответствующую списку ремаркетинга . У каждой группы интересов Protected Audience API есть владелец .
Владельцы групп по интересам выступают в качестве покупателя на аукционе объявлений API Protected Audience. Членство в группе по интересам сохраняется в браузере на устройстве пользователя и не передается поставщику браузера или кому-либо еще.
API-функции
Пример использования
Вот пример из руководства по определению данных об аудитории , показывающий, как создать группу по интересам и попросить браузер присоединиться к группе.
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);
updateUrl предоставляет URL-адрес, который возвращает JSON для обновления атрибутов группы интересов. Он должен иметь то же происхождение, что и owner .
Обновить атрибуты
updateUrl указывает веб-сервер, который возвращает JSON, определяющий свойства группы интересов, соответствующие объекту группы интересов, переданному в joinAdInterestGroup() .
Это позволяет владельцу группы периодически обновлять атрибуты группы по интересам. В текущей реализации можно изменить следующие атрибуты:
-
biddingLogicUrl -
biddingWasmHelperUrl -
trustedBiddingSignalsUrl -
trustedBiddingSignalsKeys -
ads -
priority
Любое поле, не указанное в JSON, не будет перезаписано — обновляются только поля, указанные в JSON, — тогда как вызов navigator.joinAdInterestGroup() перезаписывает любую существующую группу интересов.
Обновления выполняются с максимальной эффективностью и могут завершиться сбоем при следующих условиях:
- Тайм-аут сетевого запроса (в настоящее время 30 секунд).
- Другой сбой сети.
- Ошибка синтаксического анализа JSON.
Частота обновлений ограничена максимум одним в день.
Обновления можно отменить, если на обновление было потрачено слишком много непрерывного времени, хотя это не накладывает никаких ограничений на частоту отмененных (оставшихся) обновлений. Обновления, которые не удалось выполнить из-за сетевых ошибок, повторяются через час, а обновления, которые не выполняются из-за отключения от Интернета, повторяются немедленно при повторном подключении.
Обновления вручную
Обновления групп интересов, принадлежащих источнику текущего кадра, можно запустить вручную с помощью navigator.updateAdInterestGroups() .
Ограничение скорости предотвращает слишком частое обновление: повторные вызовы navigator.updateAdInterestGroups() ничего не делают, пока не истечет период ограничения скорости (в настоящее время один день).
Ограничение скорости сбрасывается, если navigator.joinAdInterestGroup() вызывается снова для того же owner и name группы интересов.
Автоматические обновления
Все группы интересов, загруженные на аукцион, обновляются автоматически после завершения аукциона с учетом тех же ограничений скорости, что и при обновлении вручную.
Для каждого владельца, по крайней мере, с одной группой интересов, участвующей в аукционе, navigator.updateAdInterestGroups() вызывается из iframe, происхождение которого соответствует этому владельцу.
Все ссылки на API защищенной аудитории
Справочные руководства по API доступны:
- Руководство разработчика по API Protected Audience .
- Руководство для покупателей рекламы по группам интересов защищенной аудитории и формированию ставок .
- Руководство для продавцов рекламы по рекламным аукционам для защищенной аудитории.
- Руководство по сообщению о результатах аукциона
- Рекомендации по устранению задержки на аукционе объявлений для защищенной аудитории
- Устранение неполадок с защищенной аудиторией
Объяснение API Protected Audience также содержит подробную информацию о поддержке функций и ограничениях.