# Отправка взаимодействий с рекламным местом

### Отправка событий

Ниже на схеме показаны основные события, связанные с показом и взаимодействием с рекламой в 4 случаях, когда в плейсмент:

* не приходит реклама, `/choose` возвращает пустой ответ
* приходит баннер (формат Banner)
* приходит товарная кампания тип Single (одна кампания с несколькими слотами)
* приходит товарная кампания тип Multi-campaign (в каждом слоте своя кампания)

Примеры разных вариантов ответов есть в [коллекции Postman](https://www.postman.com/gravity-field/gravity-field-server-side-api/request/ocmu6x6/get-ad-creatives).

<figure><img src="https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FZ68WyGXkEDskLt6Xj4rn%2Fimage.png?alt=media&#x26;token=23e566b7-d13f-4065-af08-6555a9787e17" alt=""><figcaption></figcaption></figure>

Общие действия после запроса рекламы такие:

1. Когда пользователь открывает экран или страницу с плейсментом, вы запрашиваете кампании для плейсмента [`/choose`](https://developer.gravityfield.ai/gravity-ads/implemention/server-side-integraciya/poluchenie-kampanii), передавая placementId. Есть 2 способа учесть потенциальный показ:
   * Указать параметр `data.options.isImplicitImpression: true` в запросе `/choose`.
   * Отправить Ad Impression (AIMP). Так система понимает емкость инвентаря. Если ответ на запрос choose содержит рекламный юнит, то вы отправляете в Ad Impression еще и его идентификаторы: campaignId, adsetId, creativeId, testId. Это в системе будет означать рекламный показ.
2. Когда рекламное место попадает в область видимости на более чем 50% в течение 1 секунды, вы отправляете событие Visible Impression (WRIMP).
3. Когда пользователь взаимодействуют с рекламным местом включая:

   * клик по области виджета
   * добавление товара в корзину
   * клик по товару с переходом на страницу товара

   вы отправляете событие Ad Click (ADCLICK). Это событие использует для расчета CTR рекламного блока.
4. (только для товарных кампаний) Когда блок с товарами попадает область видимости, вы отправляете события PIMP с помощью метода `/batch` или `/productInteraction`. Это в дополнение к WRIMP.
5. (только для товарных кампаний) Когда происходит клик по товару, включая:

   * добавление товара в корзину
   * клик по товару с переходом на страницу товара

   вы отправляете событие Product Click (PCLICK), с указанием sku товара в slots. Это в дополнение к ADCLICK.

### Отправка AIMP/WRIPM

AIMP - Ad impression. Потенциальный показ&#x20;

WRIMP - Widget real impression. Рекламный юнит попадает в область видимости на более чем 50% в течение 1 секунды (не зависито от того, есть реклама или нет).

{% openapi src="<https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FJ62lNmCcZjSKYqHYbVQh%2Fads_openapi%20-%20simple.yaml?alt=media&token=120c52a4-322c-4b4d-bb3e-f21a2d1480dd>" path="/impression" method="post" %}
[ads\_openapi - simple.yaml](https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FJ62lNmCcZjSKYqHYbVQh%2Fads_openapi%20-%20simple.yaml?alt=media\&token=120c52a4-322c-4b4d-bb3e-f21a2d1480dd)
{% endopenapi %}

### Отправка ADCLICK

ADCLICK - ad click. Нажатие на рекламный блок (любую область, включая кнопки добавить в корзину и т.п.).

{% openapi src="<https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FJ62lNmCcZjSKYqHYbVQh%2Fads_openapi%20-%20simple.yaml?alt=media&token=120c52a4-322c-4b4d-bb3e-f21a2d1480dd>" path="/click" method="post" %}
[ads\_openapi - simple.yaml](https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FJ62lNmCcZjSKYqHYbVQh%2Fads_openapi%20-%20simple.yaml?alt=media\&token=120c52a4-322c-4b4d-bb3e-f21a2d1480dd)
{% endopenapi %}

### Отправка PIMP/PCLICK

PIMP - Product impression. Показ товара в области видимости.

PCLICK - Product click. Нажатие на определенный товар в рекламном блоке.&#x20;

{% openapi src="<https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FJ62lNmCcZjSKYqHYbVQh%2Fads_openapi%20-%20simple.yaml?alt=media&token=120c52a4-322c-4b4d-bb3e-f21a2d1480dd>" path="/productInteraction" method="post" %}
[ads\_openapi - simple.yaml](https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FJ62lNmCcZjSKYqHYbVQh%2Fads_openapi%20-%20simple.yaml?alt=media\&token=120c52a4-322c-4b4d-bb3e-f21a2d1480dd)
{% endopenapi %}

### Пакетная отправка событий

AIMP, WRIMP, ADCLICK, PIMP, PCLICK

{% openapi src="<https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FJ62lNmCcZjSKYqHYbVQh%2Fads_openapi%20-%20simple.yaml?alt=media&token=120c52a4-322c-4b4d-bb3e-f21a2d1480dd>" path="/batch" method="post" %}
[ads\_openapi - simple.yaml](https://4177852890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgJkXEceGp0tRdxEFeaze%2Fuploads%2FJ62lNmCcZjSKYqHYbVQh%2Fads_openapi%20-%20simple.yaml?alt=media\&token=120c52a4-322c-4b4d-bb3e-f21a2d1480dd)
{% endopenapi %}