Download clickworker: Difference between revisions
No edit summary |
|||
| Line 18: | Line 18: | ||
При отдаче кликворкера пользователю вы можете на лету заменять шаблоны актуальными данными. | При отдаче кликворкера пользователю вы можете на лету заменять шаблоны актуальными данными. | ||
{| 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]). | |||
|- | |||
| checkUrl || URL, проксирующий на вашем домене наш эндпойнт проверки клика. | |||
|} | |||
Если вы не используете kmnrId, или вам не нужны все sub-метки, или вместо clickUrl у вас подключён [[Traffic back URL|Traffic-back URL]], просто удалите ненужные шаблоны из ссылки. | Если вы не используете 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> | <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]] | [[Category:Features]] | ||
Revision as of 11:33, 31 May 2023
Для проверки кликовых ссылок мы используем кликворкер, специальную страницу на своём домене.
Если вы хотите избежать потерь и задержек на кроссдоменных редиректах, вы может скачать кликворкер себе и разместить на своём сервере. Необходимо обновлять его раз в сутки, потому что мы постоянно вносим изменения в скрипты.
Обратите внимание, опция доступна только в интеграциях типа Redirect.
Подключение опции
Закажите у менеджера включение опции Download clickworker на своей интеграции. После того как её включат, в интеграции появится ссылка для скачивания.
Шаблоны
В фигурных скобках в ссылке находятся шаблоны, они будут как есть прокинуты в код.
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
При отдаче кликворкера пользователю вы можете на лету заменять шаблоны актуальными данными.
| Название | Описание |
|---|---|
| kmnrId | kmnrId, сгенерированный при отстуке на https://kaminari.systems/v2/ping. Нужен для склеивания кликов если у вас подключена опция S2S ping. |
| kmnrKey | Идентификатор интеграции, в рамках которой анализируется показ. |
| sub1 | Заполенные суб-метки. Если какие-то метки вы не используете, их слать не обязательно. |
| sub2 | ... |
| sub3 | ... |
| sub4 | ... |
| sub5 | ... |
| sub6 | ... |
| sub7 | ... |
| sub8 | ... |
| sub9 | ... |
| sub10 | ... |
| u | целевая ссылка, на которую пользователь будет отправлен после проверки. Должна быть в URL-безопасном виде (например, обработана JS-методом encodeURIComponent). |
| checkUrl | URL, проксирующий на вашем домене наш эндпойнт проверки клика. |
Если вы не используете kmnrId, или вам не нужны все sub-метки, или вместо clickUrl у вас подключён Traffic-back URL, просто удалите ненужные шаблоны из ссылки.
https://kaminari.space/v1/click?kmnrKey=767073697&sub1={sub1}&sub2={sub2}&u={clickUrl}&download
Headers
Для корректной работы кликворкер должен отдавать браузеру пользователя следующие заголовки:
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: *