Revision as of 09:57, 16 January 2024

Other languages:

English
русский

Если вы хотите получать на свой URL результат проверки по каждому клику, это можно сделать с помощью опции Ping-back URL.

Подключение опции

Закажите у менеджера включение опции Ping-back URL на своей интеграции.

После того как её включат, укажите в настройках свой URL.

Чтобы понимать какой показ мы проверили вам надо пометить его. Если у вас интеграция типа JS check, то добавьте в window.kmnr ключ kmnrId с любым удобным для вас уникальным идентификатором, по которому сможете потом узнать показ.

В интеграции типа Redirect добавьте kmnrId в URL:

https://kaminari.systems/v1/click?kmnrKey=111111111&kmnrId=IMPRESSION_UNIQ_ID&u=https%3A%2F%2Fsome.url

Допустимые символы: [A-Za-z0-9_] латинские буквы, арабские цифры, знак подчёркивания. Максимальная длина — 200 символов.

Формат ответа

После того, как мы получили, обработали данные и вынесли решение о ботовости клика, мы отсылаем решение вам в формате JSON POST. { kmnrId: 111111111, fraud: 1, block: 1 }

По kmnrId вы сможете найти показ на своей стороне.

Название	Значение
kmnrId	kmnrId, уникальный идентификатор
fraud	1 если клик фродовый, 0 если клик нефродовый, -1 если клик не удалось проверить
block	1 если клик был заблокирован в соответствии с настройками интеграции, 0 если клик не был заблокирован

@@ Line 3: / Line 3: @@
 = Подключение опции =
-Закажите у менеджера включение опции '''Ping-back URL''' на своей интеграции. После того как её включат, укажите в настройках свой URL.
+Закажите у менеджера включение опции '''Ping-back URL''' на своей интеграции.
+После того как её включат, укажите в настройках свой URL.
 [[File:Ping back url.png]]
+Чтобы понимать какой показ мы проверили вам надо пометить его. Если у вас интеграция типа '''JS check''', то добавьте в <code>window.kmnr</code> ключ <code>kmnrId</code> с любым удобным для вас уникальным идентификатором, по которому сможете потом узнать показ.
+<div lang="en" dir="ltr" class="mw-content-ltr">
+[[File:Ping back url2.png]]
+</div>
+В интеграции типа '''Redirect''' добавьте kmnrId в URL:
+<pre>https://kaminari.systems/v1/click?kmnrKey=111111111&kmnrId=IMPRESSION_UNIQ_ID&u=https%3A%2F%2Fsome.url</pre>
+Допустимые символы: <code>[A-Za-z0-9_]</code> латинские буквы, арабские цифры, знак подчёркивания. Максимальная длина — 200 символов.
 = Формат ответа =
 После того, как мы получили, обработали данные и вынесли решение о ботовости клика, мы отсылаем решение вам в формате JSON POST. <code>{ kmnrId: 111111111, fraud: 1, block: 1 }</code>
+По kmnrId вы сможете найти показ на своей стороне.
 {| class="wikitable"
@@ Line 14: / Line 30: @@
 ! Название !! Значение
 |-
-| kmnrId || kmnrId, сгенерированный при отстуке на {{KamiLink|v2/ping}}
+| kmnrId || kmnrId, уникальный идентификатор
 |-
 | fraud || 1 если клик фродовый, 0 если клик нефродовый, -1 если клик не удалось проверить