# KClient JS
pro business
KClient JS работает по следующему принципу:
- Скрипт забирает данные входящего клика и отправляет запрос на Click API.
- Трекер отдает ответ. Если необходимо сделать подмену, то содержимое потока отправляется на исходный сайт с клиентом и идет перезапись через document.write.
В итоге на исходном сайте под тем же доменом отображается новый контент, а детекторы редиректов видят ответ 200.
KClient JS удобен для работы через различные конструкторы сайтов, где нет возможности разместить KClient PHP.
# Выбор интеграции
- Откройте вкладку Интеграции в компании.
- Выберите «KClient JS» из списка.
HTTPS
Интеграция доступна только, если у кампании выбран домен с рабочим HTTPS.
# Настройки KClient JS
Доступные настройки
Сохранять только уникальные клики — данная опция позволяет отправлять только уникальные клики в трекер.
Конвертировать в base64 — конвертирует код интеграции в base64, что позволяет добиться большей уникальности и защищает от блокировки кода браузерными расширениями.
Код интеграции — результирующий код интеграции, который необходимо добавить в проект. Рекомендуем добавлять код в тег head, что позволит коду начать свою работу как можно скорее при загрузке страницы.
TIP
Если вы выбрали опцию Отправлять только уникальные клики в трекер, но необходимо протестировать кампанию, добавьте в URL параметр _new=1
.
Пример:
https://example.com/?_new=1
# Подключение к конструкторам сайтов
# Shopify
Открываем свой магазин и переходим в Themes → Actions → Edit code.
Слева выбираем страницу, которая нам нужна. Если главная, выберите theme.liquid
. И ставим код в тег <head>
:
Сохраняем, код подключен.
# Taplink
Создайте свою страницу, далее перейдите в Настройки → Общие → Вставка HTML кода:
Вставляйте код в обычном виде, без base64.
Сохраните.
# Tilda
Создайте свой сайт и откройте список страниц, после чего нажмите Настройки:
Перейдите в раздел Дополнительно и пролистайте вниз до блока HTML-КОД ДЛЯ ВСТАВКИ ВНУТРЬ HEAD.
Здесь и необходимо будет поставить js код, однако эта опция доступна только на платных тарифах.
После добавления кода не забудьте опубликовать сайт заново, чтобы правки вступили в силу.
# Flexbe
Создайте свой сайт и в шапке перейдите в Настройки:
Далее нажмите Вставка кода и Перед закрывающим тегом .
Импортируйте код в этом месте:
Сохраните все изменения.
# GitHub pages
Создайте новый репозиторий:
Откройте index и вставляйте JS код:
Сохраните и сделайте push в github. При открытии страницы из репозитория будет срабатывать js код.
# KClient JS FAQ
::: Как фильтровать ботов?
Действие «Ничего не делать» оставит бота на сайте, на котором будет стоять скрипт. Второй поток — это целевое действие для всех остальных.
В потоке «Bot Protection» вы выставляете любой набор фильтров, который нужен будет для отлова ботов.
В потоке Stream 2 вы выставляете целевое действие. Если там будет выбран локальный лендинг/оффер, то этот лендинг/оффер будет выгружен на сайт с интеграцией без редиректа и смены домена, в случае если трафик не попадет в бот поток.
:::
С какими конструкторами скрипт не совместим?
- WIX
- Google.Sites
Выявляет ли боты?
При генерации скрипта вы можете включить опцию — base 64, что позволит генерировать код скрипта в уникальном зашифрованном виде, избегая тем самым в содержании ключей вида "tracker", "api" и других похожих значений, которые бы помогли ботам детектить работу трекера.
При переходе на сайт, где установлен код, ничего не происходит
Первым делом перейдите в кампанию в Keitaro, откройте в правом углу над потоками Лог и сделайте клик по сайту.
Если лог остаётся пустым, проверьте, правильно ли вставлен код интеграции.
Код необходимо вставлять в HEAD.
Лог трафика есть, но при переходе на сайт ничего не происходит
Убедитесь, что протоколы, которые используются в кампании и на сайте, одинаковые. Если сайт работает на HTTP, то и ссылка кампании должна быть на HTTP.
Аналогично и с HTTPS: если сайт работает на HTTPS, то и ссылка кампании должна быть на HTTPS.
При переходе по ссылке сайта вечный редирект
Проверьте в потоках наличие ссылки на сайт с интеграцией. Указывать в потоке сайт, в котором стоит код KClient JS, не необходимо.
Это приводит к бесконечному редиректу, так как переход на сайт открывает кампанию, в которой в потоке опять стоит ссылка на сайт, а в нём — код KClient JS.
Это замкнутый круг.
При переходе на сайте ошибка MIXED CONTENT
- Проверьте, что все ссылки внутри кода сайта на HTTP. При работе через HTTPS на сайте могут остаться ссылки со старым протоколом, что может привести к ошибкам в браузере.
- Если работаете с доменом через Cloudflare, убедитесь, что в режимах настройки SSL на CloudFlare установлен режим Flexible.
- Обновитесь до последней версии трекера.