Ping back URL/en - Revision history

FuzzyBot: Updating to match new version of source page

2026-05-05T09:30:29Z

Updating to match new version of source page

← Older revision		Revision as of 09:30, 5 May 2026
Line 48:		Line 48:
	\| kmnrKey \|\| Integration identifier		\| kmnrKey \|\| Integration identifier
	\|-		\|-
	\| fraud \|\| 1 if the hit is fraudulent, 0 if the hit is non-fraudulent, ~~-1 if the hit could not be verified~~		\| fraud \|\| 1 if the hit is fraudulent, 0 if the hit is non-fraudulent,
	\|-		\|-
	\| block \|\| 1 if the hit was blocked according to the integration settings, 0 if the hit wasn't blocked		\| block \|\| 1 if the hit was blocked according to the integration settings, 0 if the hit wasn't blocked
Line 67:		Line 67:
	\|}		\|}

	If the ping-back still cannot be delivered, you can always retrieve the status for any click via our API, which serves as the reliable source of truth regardless of delivery success.		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 the ping-back still cannot be delivered, you can always retrieve the status for any click via our API, which serves as the reliable source of truth regardless of delivery success.

	[[Category:Features]]		[[Category:Features]]

FuzzyBot: Updating to match new version of source page

2025-11-21T08:58:36Z

Updating to match new version of source page

← Older revision		Revision as of 08:58, 21 November 2025
Line 67:		Line 67:
	\|}		\|}

	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~~.		If the ping-back still cannot be delivered, you can always retrieve the status for any click via our API, which serves as the reliable source of truth regardless of delivery success.

	[[Category:Features]]		[[Category:Features]]

FuzzyBot: Updating to match new version of source page

2024-01-26T12:34:19Z

Updating to match new version of source page

← Older revision		Revision as of 12:34, 26 January 2024
Line 1:		Line 1:
	<languages/>		<languages/>
	If you want to receive the verification results for each click on your URL, you can do so using the '''Ping-back URL''' option.		If you want to receive the verification results for each click on your own URL, you can do so using the '''Ping-back URL''' option.

	= Option activation =		= Option activation =
	~~Request the activation of~~ the '''Ping-back URL''' option ~~from your manager for~~ your integration.		Ask your manager to activate the '''Ping-back URL''' option on your integration.

	Once enabled, specify your URL in the settings.		Once enabled, specify your URL in the settings.
Line 9:		Line 9:
	[[File:Ping back url.png]]		[[File:Ping back url.png]]

	To understand which impression we've checked, you need to mark it. If you have an '''JS check'''-type integration, add the <code>kmnrId</code> key to <code>window.kmnr</code> with any unique identifier convenient for you. By this identifier you can later recognize the impression.		== kmnrId ==
			To understand which impression we've checked, you need to mark it.

			If you have an '''JS check'''-type integration, add the <code>kmnrId</code> key to <code>window.kmnr</code> with any unique identifier convenient for you. By this identifier you can later recognize the impression.

	[[File:Ping back url2.png]]		[[File:Ping back url2.png]]
Line 20:		Line 23:

	= Response format =		= 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. <~~code~~>{ kmnrId: 111111111, fraud: 1, block: 1 }</~~code~~>		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.
			<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>

	By kmnrId you can find the impression in your stat.		By kmnrId and sub-tags you can find the impression in your stat.

	{\| class="wikitable"		{\| class="wikitable"
Line 28:		Line 44:
	! Name !! Value		! Name !! Value
	\|-		\|-
	\| kmnrId \|\| ~~kmnrId, unique~~ identifier convenient for you		\| kmnrId \|\| Unique identifier convenient for you
			\|-
			\| kmnrKey \|\| Integration identifier
			\|-
			\| fraud \|\| 1 if the hit is fraudulent, 0 if the hit is non-fraudulent, -1 if the hit could not be verified
			\|-
			\| block \|\| 1 if the hit was blocked according to the integration settings, 0 if the hit wasn't blocked
			\|-
			\| sub1 \|\| Sub-tags that were sent with the hit
			\|-
			\| sub2 \|\| ...
	\|-		\|-
	\| ~~fraud~~ \|\| ~~1 if the click is fraudulent, 0 if the click is non-fraudulent, -1 if the click could not be verified~~		\| sub3 \|\| ...
	\|-		\|-
	\| ~~block~~ \|\| ~~1 if the click was blocked according to the integration settings, 0 if the click wasn't blocked~~		\| sub4 \|\| ...
			\|-
			\| sub5 \|\| ...
			\|-
			\| sub6 \|\| ...
			\|-
			\| sub7 \|\| ...
	\|}		\|}

			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.

	[[Category:Features]]		[[Category:Features]]

FuzzyBot: Updating to match new version of source page

2024-01-17T09:34:20Z

Updating to match new version of source page

← Older revision		Revision as of 09:34, 17 January 2024
Line 3:		Line 3:

	= Option activation =		= Option activation =
	Request the activation of the '''Ping-back URL''' option from your manager for your integration. Once enabled, specify your URL in the settings.		Request the activation of the '''Ping-back URL''' option from your manager for your integration.

			Once enabled, specify your URL in the settings.

	[[File:Ping back url.png]]		[[File:Ping back url.png]]

			To understand which impression we've checked, you need to mark it. If you have an '''JS check'''-type integration, add the <code>kmnrId</code> key to <code>window.kmnr</code> with any unique identifier convenient for you. By this identifier you can later recognize the impression.

			[[File:Ping back url2.png]]

			If you have an '''Redirect'''-type integration, add kmnrId to URL:

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

			Acceptable characters: [A-Za-z0-9_] Latin letters, Arabic numerals, underscore. Maximum length is 200 characters.

	= Response format =		= 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. <code>{ kmnrId: 111111111, fraud: 1, block: 1 }</code>		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. <code>{ kmnrId: 111111111, fraud: 1, block: 1 }</code>

			By kmnrId you can find the impression in your stat.

	{\| class="wikitable"		{\| class="wikitable"
Line 14:		Line 28:
	! Name !! Value		! Name !! Value
	\|-		\|-
	\| kmnrId \|\| kmnrId, ~~generated during the ping at {{KamiLink\|v2/ping}}~~		\| kmnrId \|\| kmnrId, unique identifier convenient for you
	\|-		\|-
	\| fraud \|\| 1 if the click is fraudulent, 0 if the click is non-fraudulent, -1 if the click could not be verified		\| fraud \|\| 1 if the click is fraudulent, 0 if the click is non-fraudulent, -1 if the click could not be verified

FuzzyBot: Updating to match new version of source page

2024-01-03T15:41:08Z

Updating to match new version of source page

← Older revision		Revision as of 15:41, 3 January 2024
Line 8:		Line 8:

	= Response format =		= 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. <code>{ kmnrId, fraud }</code>		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. <code>{ kmnrId: 111111111, fraud: 1, block: 1 }</code>

	{\| class="wikitable"		{\| class="wikitable"
Line 16:		Line 16:
	\| kmnrId \|\| kmnrId, generated during the ping at {{KamiLink\|v2/ping}}		\| kmnrId \|\| kmnrId, generated during the ping at {{KamiLink\|v2/ping}}
	\|-		\|-
	\| fraud \|\| 0 if the click is ~~non-~~fraudulent, 1 if the click is fraudulent, -1 if the click could not be verified		\| fraud \|\| 1 if the click is fraudulent, 0 if the click is non-fraudulent, -1 if the click could not be verified
			\|-
			\| block \|\| 1 if the click was blocked according to the integration settings, 0 if the click wasn't blocked
	\|}		\|}

	[[Category:Features]]		[[Category:Features]]

FuzzyBot: Updating to match new version of source page

2023-11-30T16:03:59Z

Updating to match new version of source page

← Older revision		Revision as of 16:03, 30 November 2023
Line 1:		Line 1:
	<languages/>		<languages/>
	~~Если вы хотите получать на свой~~ URL ~~результат проверки по каждому клику~~, ~~это можно сделать с помощью опции~~ '''Ping-back URL'''.		If you want to receive the verification results for each click on your URL, you can do so using the '''Ping-back URL''' option.

	= ~~Подключение опции~~ =		= Option activation =
	~~Закажите у менеджера включение опции~~ '''Ping-back URL''' ~~на своей интеграции~~. ~~После того как её включат~~, ~~укажите в настройках свой~~ URL.		Request the activation of the '''Ping-back URL''' option from your manager for your integration. Once enabled, specify your URL in the settings.

	[[File:Ping back url.png]]		[[File:Ping back url.png]]

	= ~~Формат ответа~~ =		= Response format =
	~~После того~~, ~~как мы получили~~, ~~обработали данные и вынесли решение о ботовости клика~~, ~~мы отсылаем решение вам в формате~~ JSON POST. <code>{ kmnrId, fraud }</code>		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. <code>{ kmnrId, fraud }</code>

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! ~~Название~~ !! ~~Значение~~		! Name !! Value
	\|-		\|-
	\| kmnrId \|\| kmnrId, ~~сгенерированный при отстуке на~~ {{KamiLink\|v2/ping}}		\| kmnrId \|\| kmnrId, generated during the ping at {{KamiLink\|v2/ping}}
	\|-		\|-
	\| fraud \|\| 0 ~~если клик нефродовый~~, 1 ~~если клик фродовый~~, -1 ~~если клик не удалось проверить~~		\| fraud \|\| 0 if the click is non-fraudulent, 1 if the click is fraudulent, -1 if the click could not be verified
	\|}		\|}

	[[Category:Features]]		[[Category:Features]]

FuzzyBot: Updating to match new version of source page

2023-09-19T02:11:35Z

Updating to match new version of source page

New page

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

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

[[File:Ping back url.png]]

= Формат ответа =
После того, как мы получили, обработали данные и вынесли решение о ботовости клика, мы отсылаем решение вам в формате JSON POST. <code>{ kmnrId, fraud }</code>

{| class="wikitable"
|-
! Название !! Значение
|-
| kmnrId || kmnrId, сгенерированный при отстуке на {{KamiLink|v2/ping}}
|-
| fraud || 0 если клик нефродовый, 1 если клик фродовый, -1 если клик не удалось проверить
|}

[[Category:Features]]