Узнайте, как обновлять данные об аудитории, настроив URL-адрес обновления для группы интересов в рамках API защищенной аудитории. Ознакомьтесь с руководством для разработчиков , чтобы узнать о полном жизненном цикле API защищенной аудитории, и обратитесь к пояснению к API защищенной аудитории для получения подробного описания того, как браузеры записывают группы интересов .
Не являетесь разработчиком? Ознакомьтесь с обзором API для защищенной аудитории .
Группы интересов API защищенной аудитории
Группа интересов в рамках API защищенной аудитории представляет собой группу людей с общими интересами, соответствующую списку ремаркетинга . Каждая группа интересов в рамках API защищенной аудитории имеет владельца .
В аукционе рекламы с использованием API защищенной аудитории владельцы групп интересов выступают в роли покупателей. Информация о принадлежности к группе интересов хранится браузером на устройстве пользователя и не передается поставщику браузера или кому-либо еще.
Функции 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 также содержит подробную информацию о поддержке функций и ограничениях.