#
Отправка взаимодействия с рекламным местом
#
Отправка событий
Ниже на схеме показаны основные события, связанные с показом и взаимодействием с рекламой в 4 случаях, когда в плейсмент:
- не приходит реклама, /choose возвращает пустой ответ
- приходит баннер (формат Banner)
- приходит товарная кампания тип Single (одна кампания с несколькими слотами)
- приходит товарная кампания тип Multi-campaign (в каждом слоте своя кампания)
Примеры разных вариантов ответов есть в коллекции Postman.
#
engagement: передача информации о взаимодействии пользователя с кампаниями
API reference
#
Порядок действий после запроса рекламы
- Когда пользователь открывает экран или страницу с плейсментом, вы запрашиваете кампании для плейсмента
/choose
, передаваяplacementId
. Есть 2 способа учесть потенциальный показ:- Указать параметр
data.options.isImplicitImpression: true
в запросе/choose
. - Отправить Ad Impression (AIMP). Так система понимает емкость инвентаря. Если ответ на запрос choose содержит рекламный юнит, то вы отправляете в Ad Impression еще и его идентификаторы:
campaignId
,adsetId
,creativeId
,testId
. Это в системе будет означать рекламный показ.
- Указать параметр
- Когда рекламное место попадает в область видимости на более чем 50% в течение 1 секунды, вы отправляете событие Visible Impression (WRIMP).
- Когда пользователь взаимодействуют с рекламным местом включая:
- клик по области виджета
- добавление товара в корзину
- клик по товару с переходом на страницу товара вы отправляете событие Ad Click (ADCLICK). Это событие использует для расчета CTR рекламного блока.
- только для товарных кампаний Когда блок с товарами попадает область видимости, вы отправляете события PIMP с помощью метода /batch или /productInteraction. Это в дополнение к WRIMP.
-
только для товарных кампаний
Когда происходит клик по товару, включая:
- добавление товара в корзину
- клик по товару с переходом на страницу товара
вы отправляете событие Product Click (PCLICK), с указанием sku товара в
slots
. Это в дополнение к ADCLICK.
#
Отправка AIMP/WRIPM
AIMP - Ad impression. Потенциальный показ WRIMP - Widget real impression. Рекламный юнит попадает в область видимости на более чем 50% в течение 1 секунды (не зависито от того, есть реклама или нет).