Ping back URL/ru: Difference between revisions
(Created page with "Замените:") |
(Created page with "Запрос должен вернуть HTTP 200.") |
||
| Line 35: | Line 35: | ||
Замените: | Замените: | ||
* <code>https://example.com/ping-back</code> — ping-back URL клиента | |||
* <code>https://example.com/ping-back</code> — | * <code>111111111</code> — его kmnrKey | ||
* <code>111111111</code> — | * <code>50d9ecc6-402b-4a74-9397-fc20f2980567</code> — любой случайный kmnrId | ||
* <code>50d9ecc6-402b-4a74-9397-fc20f2980567</code> — | |||
Запрос должен вернуть HTTP 200. | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | <div lang="en" dir="ltr" class="mw-content-ltr"> | ||
Revision as of 14:18, 24 June 2026
Если вы хотите получать на свой URL результат проверки по каждому клику, это можно сделать с помощью опции Ping-back URL.
Подключение опции
Закажите у менеджера включение опции Ping-back URL на своей интеграции.
После того как её включат, укажите в настройках свой URL.
kmnrId
Чтобы понимать какой показ мы проверили вам надо пометить его.
Если у вас интеграция типа 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 символов.
Проверка эндпойнта
Проверить работоспособность ping-back эндпойнта можно таким curl-запросом:
<syntaxhighlight lang="bash"> curl -v -X POST -k 'https://example.com/ping-back' \
-H 'content-type: application/json' \
--data-raw '{"kmnrId":"50d9ecc6-402b-4a74-9397-fc20f2980567","kmnrKey":111111111,"fraud":1,"block":0,"reason":"Spoofing","sub1":"sub1 value","sub2":"sub2 value","sub3":"sub3 value","sub4":"","sub5":"","sub6":"","sub7":""}'
</syntaxhighlight>
Замените:
https://example.com/ping-back— ping-back URL клиента111111111— его kmnrKey50d9ecc6-402b-4a74-9397-fc20f2980567— любой случайный kmnrId
Запрос должен вернуть HTTP 200.
Response format
After receiving, processing the data, and making a decision about the bot status of the click, we send the decision to you in JSON POST format.
{
"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, уникальный идентификатор |
| kmnrKey | Идентификатор интеграции |
| fraud | 1 если переход фродовый, 0 если переход нефродовый |
| block | 1 если переход был заблокирован в соответствии с настройками интеграции, 0 если переход не был заблокирован |
| sub1 | метки, отправленные нам вместе с запросом |
| sub2 | ... |
| sub3 | ... |
| sub4 | ... |
| sub5 | ... |
| sub6 | ... |
| sub7 | ... |
После успешного получения ping-back ваш сервер должен ответить статусом 200. Иначе мы попробуем ещё три раза отправить запрос.
Если ping-back по-прежнему не может быть доставлен, вы всегда можете получить статус любого клика через наш API, который служит надежным источником информации независимо от успешности доставки.