Revision as of 12:25, 26 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": "50d9ecc6-402b-4a74-9397-fc20f2980567",
   "kmnrKey": 111111111,
   "fraud": 1,
   "block": 1,
   "sub1": "sub1 value",
   "sub2": "sub2 value",
   "sub3": "sub3 value",
   "sub4": 444,
   "sub5": 555,
   "sub6": "",
   "sub7": ""
}

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

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

If you receive a ping-back, your server should respond with a status 200. Otherwise, we make three more attempts to send the request. If it was not possible to send a ping-back, we save it in an internal log and can provide it to you upon request.

@@ Line 2: / Line 2: @@
 Если вы хотите получать на свой URL результат проверки по каждому клику, это можно сделать с помощью опции '''Ping-back URL'''.
-<div class="mw-translate-fuzzy">
 = Подключение опции =
 Закажите у менеджера включение опции '''Ping-back URL''' на своей интеграции.
-</div>
 После того как её включат, укажите в настройках свой URL.
@@ Line 11: / Line 9: @@
 [[File:Ping back url.png]]
-Чтобы понимать какой показ мы проверили вам надо пометить его. Если у вас интеграция типа '''JS check''', то добавьте в <code>window.kmnr</code> ключ <code>kmnrId</code> с любым удобным для вас уникальным идентификатором, по которому сможете потом узнать показ.
+Чтобы понимать какой показ мы проверили вам надо пометить его.
+Если у вас интеграция типа '''JS check''', то добавьте в <code>window.kmnr</code> ключ <code>kmnrId</code> с любым удобным для вас уникальным идентификатором, по которому сможете потом узнать показ.
 <div lang="en" dir="ltr" class="mw-content-ltr">
@@ Line 24: / Line 24: @@
 = Формат ответа =
-После того, как мы получили, обработали данные и вынесли решение о ботовости клика, мы отсылаем решение вам в формате JSON POST. <code>{ kmnrId: 111111111, fraud: 1, block: 1 }</code>
+После того, как мы получили, обработали данные и вынесли решение о ботовости клика, мы отсылаем решение вам в формате JSON POST.
+<pre>{
+   "kmnrId": "50d9ecc6-402b-4a74-9397-fc20f2980567",
+   "kmnrKey": 111111111,
+   "fraud": 1,
+   "block": 1,
+   "sub1": "sub1 value",
+   "sub2": "sub2 value",
+   "sub3": "sub3 value",
+   "sub4": 444,
+   "sub5": 555,
+   "sub6": "",
+   "sub7": ""
+}</pre>
-По kmnrId вы сможете найти показ на своей стороне.
+По kmnrId и меткам вы сможете найти показ на своей стороне.
 <div class="mw-translate-fuzzy">
@@ Line 39: / Line 52: @@
 | block || 1 если клик был заблокирован в соответствии с настройками интеграции, 0 если клик не был заблокирован
 |}
+</div>
+<div lang="en" dir="ltr" class="mw-content-ltr">
+If you receive a ping-back, your server should respond with a status 200. Otherwise, we make three more attempts to send the request. If it was not possible to send a ping-back, we save it in an internal log and can provide it to you upon request.
 </div>
 [[Category:Features]]