Download clickworker/ru - Revision history

Admin: Created page with "== Создание ссылки == Вы решили, чтобы будете брать данные прямо из GET-параметров и ''utm_source'' будет писаться в '''sub1''', ''utm_campaign'' — в '''sub2''' и ''utm_click_id'' — в '''sub3'''."

2024-04-20T09:11:29Z

Created page with "== Создание ссылки == Вы решили, чтобы будете брать данные прямо из GET-параметров и ''utm_source'' будет писаться в '''sub1''', ''utm_campaign'' — в '''sub2''' и ''utm_click_id'' — в '''sub3'''."

← Older revision		Revision as of 09:11, 20 April 2024
Line 1:		Line 1:
	<languages/>		<languages/>
	По умолчанию для проверки кликовых ссылок на интеграции с типом [[Meta redirect\|Meta Redirect]] мы используем ''кликворкер'', специальную страницу на домене Kaminari Click, которая проверяет пользователя на фродовость и затем редиректит его на целевую ссылку или в [[Traffic back URL\|трафик-бек]], если включена соответствующая опция. Такой подход максимально прост и удобен, но имеет ~~ряд нюансов~~.		По умолчанию для проверки кликовых ссылок на интеграции с типом [[Meta redirect\|Meta Redirect]] мы используем ''кликворкер'', специальную страницу на домене Kaminari Click, которая проверяет пользователя на фродовость и затем редиректит его на целевую ссылку или в [[Traffic back URL\|трафик-бек]], если включена соответствующая опция. Такой подход максимально прост и удобен, но имеет несколько недостатков.

	# Если вдруг у нас на сервере случится техническая проблема, и редирект поломается, трафик будет потерян.		# Если вдруг у нас на сервере случится техническая проблема, и редирект поломается, трафик будет потерян.
Line 8:		Line 8:
	Для решения этих проблем мы предлагаем скачивать ''кликворкер'' себе и размещать его на своём сервере. Необходимо обновлять его '''раз в сутки''', потому что мы постоянно вносим изменения в скрипты.		Для решения этих проблем мы предлагаем скачивать ''кликворкер'' себе и размещать его на своём сервере. Необходимо обновлять его '''раз в сутки''', потому что мы постоянно вносим изменения в скрипты.

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

	= Подключение опции =		= Подключение опции =
Line 111:		Line 111:
	== Проверка ==		== Проверка ==

	Для проверки ~~зайтите~~ в браузере по ссылке		Для проверки зайдите в браузере по ссылке
	<pre>https://my-site.com/click.php?utm_source=1&utm_campaign=123&utm_click_id=93652664834&target=https%3A%2F%2Fgoogle.com</pre>		<pre>https://my-site.com/click.php?utm_source=1&utm_campaign=123&utm_click_id=93652664834&target=https%3A%2F%2Fgoogle.com</pre>
	Прекрасно, редирект сработал и вы оказались на сайте Гугла.		Прекрасно, редирект сработал и вы оказались на сайте Гугла.
Line 118:		Line 118:
	<br />		<br />
	<br />		<br />
	Время проверить статистику.		Время проверить статистику. Клик был зачитан, метки были прокинуты верно.
	~~Отлично~~. Клик был зачитан, метки были прокинуты верно.

	[[File:Clickworker-stat.png]]		[[File:Clickworker-stat.png]]

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

Admin: Created page with "File:Clickworker-redirect2.png

Время проверить статистику. Отлично. Клик был зачитан, метки были прокинуты верно."

2024-04-19T17:18:55Z

Created page with "File:Clickworker-redirect2.png <br /> <br /> Время проверить статистику. Отлично. Клик был зачитан, метки были прокинуты верно."

Show changes

Admin at 15:26, 30 November 2023

2023-11-30T15:26:34Z

← Older revision		Revision as of 15:26, 30 November 2023
Line 1:		Line 1:
	<languages/>		<languages/>
	Для проверки кликовых ссылок мы используем ''кликворкер'', специальную страницу на своём домене.		Для проверки кликовых ссылок мы используем ''кликворкер'', специальную страницу на своём домене.

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

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

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

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

2023-11-30T13:45:54Z

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

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]]

Download clickworker/ru - Revision history

Admin: Created page with "File:Clickworker-redirect2.png Время проверить статистику. Отлично. Клик был зачитан, метки были прокинуты верно."

Admin at 15:26, 30 November 2023

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

Admin: Created page with "File:Clickworker-redirect2.png

Время проверить статистику. Отлично. Клик был зачитан, метки были прокинуты верно."