Download clickworker/en - Revision history

FuzzyBot: Updating to match new version of source page

2024-04-20T06:52:41Z

Updating to match new version of source page

FuzzyBot: Updating to match new version of source page

2023-12-02T02:56:23Z

Updating to match new version of source page

← Older revision		Revision as of 02:56, 2 December 2023
Line 1:		Line 1:
	<languages/>		<languages/>
	~~Для проверки кликовых ссылок мы используем~~ ''~~кликворкер~~'', ~~специальную страницу на своём домене~~.		To verify click-through links, we use a ''clickworker'', a special page on our domain.

	~~Если вы хотите избежать потерь и задержек на кроссдоменных редиректах~~, ~~вы может скачать кликворкер себе и разместить на своём сервере~~. ~~Необходимо обновлять его раз в сутки, потому что мы постоянно вносим изменения в скрипты~~.		If you want to avoid losses and delays in cross-domain redirects, you can download the clickworker and host it on your server. It needs to be updated once a day because we regularly make changes to the scripts.

	'''~~Обратите внимание, опция доступна только в интеграциях типа~~ ''Redirect''.'''		'''Please note that this option is only available for ''Redirect''-type integrations.'''

	= ~~Подключение опции~~ =		= Option Activation =
	~~Закажите у менеджера включение опции~~ '''Download ~~clickworker~~''' ~~на своей интеграции~~. ~~После того как её включат~~, ~~в интеграции появится ссылка для скачивания~~.		Request the activation of the '''Download Clickworker''' option from your manager for your integration. Once enabled, a download link will appear in the integration for you to retrieve the clickworker.

	[[File:Download clickworker.png]]		[[File:Download clickworker.png]]

	= ~~Шаблоны~~ =		= Templates =
	~~В фигурных скобках в ссылке находятся шаблоны~~, ~~они будут как есть прокинуты в код~~.		The curly brackets in the link contain templates, and they will be passed into the code as they are.

	<pre>https://kaminari.space/v1/click?kmnrKey=XXXXXXXXX&kmnrId={kmnrId}&sub1={sub1}&sub2={sub2}&sub3={sub3}&sub4={sub4}&sub5={sub5}&sub6={sub6}&sub7={sub7}&u={clickUrl}&download</pre>		<pre>https://kaminari.space/v1/click?kmnrKey=XXXXXXXXX&kmnrId={kmnrId}&sub1={sub1}&sub2={sub2}&sub3={sub3}&sub4={sub4}&sub5={sub5}&sub6={sub6}&sub7={sub7}&u={clickUrl}&download</pre>
Line 18:		Line 18:
	[[File:Download clickworker2.png]]		[[File:Download clickworker2.png]]

	~~При отдаче кликворкера пользователю вы можете на лету заменять шаблоны актуальными данными~~.		When delivering the clickworker to the user, you can dynamically replace the templates with current data.

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! ~~Название~~ !! ~~Описание~~		! Name !! Description
	\|-		\|-
	\| kmnrId \|\| kmnrId, ~~сгенерированный при отстуке на~~ {{KamiLink\|v2/ping}}. ~~Нужен для склеивания кликов если у вас подключена опция~~ '''[[S2S ping]]'''.		\| kmnrId \|\| kmnrId, generated during the ping at {{KamiLink\|v2/ping}}. Needed for linking clicks if the '''[[S2S ping]]''' option is enabled.
	\|-		\|-
	\| kmnrKey \|\| ~~Идентификатор интеграции, в рамках которой анализируется показ~~.		\| kmnrKey \|\| Integration identifier under which the impression is analyzed.
	\|-		\|-
	\| sub1 \|\| ~~Заполенные суб~~-~~метки~~. ~~Если какие-то метки вы не используете~~, ~~их слать не обязательно~~.		\| sub1 \|\| Filled sub-tags. If you are not using certain tags, it is not mandatory to send them.
	\|-		\|-
	\| sub2 \|\| ...		\| sub2 \|\| ...
Line 48:		Line 48:
	\| sub10 \|\| ...		\| sub10 \|\| ...
	\|-		\|-
	\| u \|\| ~~целевая ссылка, на которую пользователь будет отправлен после проверки~~. ~~Должна быть в~~ URL-~~безопасном виде~~ (~~например~~, ~~обработана JS-методом~~ [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent encodeURIComponent]).		\| u \|\| The target link to which the user will be directed after verification. It should be in a URL-safe format (for example, processed with the JavaScript method [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent encodeURIComponent]).
	\|}		\|}

	~~Если вы не используете~~ kmnrId, ~~или вам не нужны все~~ sub-~~метки~~, ~~или вместо clickUrl у вас подключён~~ [[Traffic back URL\|Traffic-back URL]], ~~просто удалите ненужные шаблоны из ссылки~~.		If you are not using kmnrId, or you do not need all sub-tags, or if you have [[Traffic back URL\|Traffic-back URL]] instead of clickUrl, simply remove unnecessary templates from the link.

	<pre>https://kaminari.space/v1/click?kmnrKey=767073697&sub1={sub1}&sub2={sub2}&u={clickUrl}&download</pre>		<pre>https://kaminari.space/v1/click?kmnrKey=767073697&sub1={sub1}&sub2={sub2}&u={clickUrl}&download</pre>

	= Headers =		= Headers =
	~~Для корректной работы кликворкер должен отдавать браузеру пользователя следующие заголовки~~:		For the clickworker to function correctly, it must send the following headers to the user's browser:
	<pre>		<pre>
	accept-ch: Width, Viewport-Width, DPR, Device-Memory, Downlink, RTT, ECT, Save-Data, Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA, Sec-CH-UA-Full-Version		accept-ch: Width, Viewport-Width, DPR, Device-Memory, Downlink, RTT, ECT, Save-Data, Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA, Sec-CH-UA-Full-Version

FuzzyBot: Updating to match new version of source page

2023-09-19T02:05:20Z

Updating to match new version of source page

New page

<languages/>
Для проверки кликовых ссылок мы используем ''кликворкер'', специальную страницу на своём домене.

Если вы хотите избежать потерь и задержек на кроссдоменных редиректах, вы может скачать кликворкер себе и разместить на своём сервере. Необходимо обновлять его раз в сутки, потому что мы постоянно вносим изменения в скрипты.

'''Обратите внимание, опция доступна только в интеграциях типа ''Redirect''.'''

= Подключение опции =
Закажите у менеджера включение опции '''Download clickworker''' на своей интеграции. После того как её включат, в интеграции появится ссылка для скачивания.

[[File:Download clickworker.png]]

= Шаблоны =
В фигурных скобках в ссылке находятся шаблоны, они будут как есть прокинуты в код.

<pre>https://kaminari.space/v1/click?kmnrKey=XXXXXXXXX&kmnrId={kmnrId}&sub1={sub1}&sub2={sub2}&sub3={sub3}&sub4={sub4}&sub5={sub5}&sub6={sub6}&sub7={sub7}&u={clickUrl}&download</pre>

[[File:Download clickworker2.png]]

При отдаче кликворкера пользователю вы можете на лету заменять шаблоны актуальными данными.

{| class="wikitable"
|-
! Название !! Описание
|-
| kmnrId || kmnrId, сгенерированный при отстуке на {{KamiLink|v2/ping}}. Нужен для склеивания кликов если у вас подключена опция '''[[S2S ping]]'''.
|-
| kmnrKey || Идентификатор интеграции, в рамках которой анализируется показ.
|-
| sub1 || Заполенные суб-метки. Если какие-то метки вы не используете, их слать не обязательно.
|-
| sub2 || ...
|-
| sub3 || ...
|-
| sub4 || ...
|-
| sub5 || ...
|-
| sub6 || ...
|-
| sub7 || ...
|-
| sub8 || ...
|-
| sub9 || ...
|-
| sub10 || ...
|-
| u || целевая ссылка, на которую пользователь будет отправлен после проверки. Должна быть в URL-безопасном виде (например, обработана JS-методом [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent encodeURIComponent]).
|}

Если вы не используете kmnrId, или вам не нужны все sub-метки, или вместо clickUrl у вас подключён [[Traffic back URL|Traffic-back URL]], просто удалите ненужные шаблоны из ссылки.

<pre>https://kaminari.space/v1/click?kmnrKey=767073697&sub1={sub1}&sub2={sub2}&u={clickUrl}&download</pre>

= Headers =
Для корректной работы кликворкер должен отдавать браузеру пользователя следующие заголовки:
<pre>
accept-ch: Width, Viewport-Width, DPR, Device-Memory, Downlink, RTT, ECT, Save-Data, Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA, Sec-CH-UA-Full-Version
access-control-allow-headers: X-Requested-With, Cache-Control, Content-Type
access-control-allow-methods: GET, POST, OPTIONS
access-control-allow-origin: *
</pre>

[[Category:Features]]