Обновите данные об аудитории и обновите рекламу.

Узнайте, как обновить данные об аудитории, настроив 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 также содержит подробную информацию о поддержке функций и ограничениях.