Download clickworker
Для проверки кликовых ссылок мы используем кликворкер, специальную страницу на своём домене.
Если вы хотите избежать потерь и задержек на кроссдоменных редиректах, вы может скачать кликворкер себе и разместить на своём сервере. Необходимо обновлять его раз в сутки, потому что мы постоянно вносим изменения в скрипты.
Обратите внимание, опция доступна только в интеграциях типа 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). |
Если вы не используете 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: *