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

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

Ниже на схеме показаны основные события, связанные с показом и взаимодействием с рекламой в 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="/files/2uQV6Deb39BsBMQ4L8mS" alt=""><figcaption></figcaption></figure>

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

1. Когда пользователь открывает экран или страницу с плейсментом, вы запрашиваете кампании для плейсмента [`/choose`](/gravity-ads/implemention/server-side-integraciya/poluchenie-kampanii.md), передавая 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="/files/704nSL799SoKcjroNMB4" 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="/files/704nSL799SoKcjroNMB4" 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="/files/704nSL799SoKcjroNMB4" 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="/files/704nSL799SoKcjroNMB4" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.gravityfield.ai/gravity-ads/implemention/server-side-integraciya/otpravka-vzaimodeistvii-s-reklamnym-mestom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.