Download clickworker: Difference between revisions
No edit summary |
(Marked this version for translation) |
||
| Line 1: | Line 1: | ||
<languages/> | <languages/> | ||
<translate> | <translate> | ||
<!--T:1--> | |||
Для проверки кликовых ссылок мы используем ''кликворкер'', специальную страницу на своём домене. | Для проверки кликовых ссылок мы используем ''кликворкер'', специальную страницу на своём домене. | ||
<!--T:2--> | |||
Если вы хотите избежать потерь и задержек на кроссдоменных редиректах, вы может скачать кликворкер себе и разместить на своём сервере. Необходимо обновлять его раз в сутки, потому что мы постоянно вносим изменения в скрипты. | Если вы хотите избежать потерь и задержек на кроссдоменных редиректах, вы может скачать кликворкер себе и разместить на своём сервере. Необходимо обновлять его раз в сутки, потому что мы постоянно вносим изменения в скрипты. | ||
<!--T:3--> | |||
'''Обратите внимание, опция доступна только в интеграциях типа ''Redirect''.''' | '''Обратите внимание, опция доступна только в интеграциях типа ''Redirect''.''' | ||
<!--T:4--> | |||
= Подключение опции = | = Подключение опции = | ||
Закажите у менеджера включение опции '''Download clickworker''' на своей интеграции. После того как её включат, в интеграции появится ссылка для скачивания. | Закажите у менеджера включение опции '''Download clickworker''' на своей интеграции. После того как её включат, в интеграции появится ссылка для скачивания. | ||
<!--T:5--> | |||
[[File:Download clickworker.png]] | [[File:Download clickworker.png]] | ||
<!--T:6--> | |||
= Шаблоны = | = Шаблоны = | ||
В фигурных скобках в ссылке находятся шаблоны, они будут как есть прокинуты в код. | В фигурных скобках в ссылке находятся шаблоны, они будут как есть прокинуты в код. | ||
<!--T:7--> | |||
<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> | ||
<!--T:8--> | |||
[[File:Download clickworker2.png]] | [[File:Download clickworker2.png]] | ||
<!--T:9--> | |||
При отдаче кликворкера пользователю вы можете на лету заменять шаблоны актуальными данными. | При отдаче кликворкера пользователю вы можете на лету заменять шаблоны актуальными данными. | ||
<!--T:10--> | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| Line 52: | Line 62: | ||
|} | |} | ||
<!--T:11--> | |||
Если вы не используете kmnrId, или вам не нужны все sub-метки, или вместо clickUrl у вас подключён [[Traffic back URL|Traffic-back URL]], просто удалите ненужные шаблоны из ссылки. | Если вы не используете kmnrId, или вам не нужны все sub-метки, или вместо clickUrl у вас подключён [[Traffic back URL|Traffic-back URL]], просто удалите ненужные шаблоны из ссылки. | ||
<!--T:12--> | |||
<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> | ||
<!--T:13--> | |||
= Headers = | = Headers = | ||
Для корректной работы кликворкер должен отдавать браузеру пользователя следующие заголовки: | Для корректной работы кликворкер должен отдавать браузеру пользователя следующие заголовки: | ||
| Line 65: | Line 78: | ||
</pre> | </pre> | ||
<!--T:14--> | |||
[[Category:Features]] | [[Category:Features]] | ||
</translate> | </translate> | ||
Revision as of 02:03, 19 September 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). |
Если вы не используете 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: *