# KClient JS

pro business

KClient JS работает по следующему принципу:

  1. Скрипт забирает данные входящего клика и отправляет запрос на Click API.
  2. Трекер отдает ответ. Если необходимо сделать подмену, то содержимое потока отправляется на исходный сайт с клиентом и идет перезапись через document.write.

В итоге на исходном сайте под тем же доменом отображается новый контент, а детекторы редиректов видят ответ 200.

KClient JS удобен для работы через различные конструкторы сайтов, где нет возможности разместить KClient PHP.

# Выбор интеграции

  1. Откройте вкладку Интеграции в компании.
  2. Выберите «KClient JS» из списка.

HTTPS

Интеграция доступна только, если у кампании выбран домен с рабочим HTTPS.

# Настройки KClient JS

Доступные настройки

Сохранять только уникальные клики — данная опция позволяет отправлять только уникальные клики в трекер.

Конвертировать в base64 — конвертирует код интеграции в base64, что позволяет добиться большей уникальности и защищает от блокировки кода браузерными расширениями.

Код интеграции — результирующий код интеграции, который необходимо добавить в проект. Рекомендуем добавлять код в тег head, что позволит коду начать свою работу как можно скорее при загрузке страницы.

TIP

Если вы выбрали опцию Отправлять только уникальные клики в трекер, но необходимо протестировать кампанию, добавьте в URL параметр _new=1.

Пример:

https://example.com/?_new=1
1

# Подключение к конструкторам сайтов

# Shopify

Открываем свой магазин и переходим в Themes → Actions → Edit code. Слева выбираем страницу, которая нам нужна. Если главная, выберите theme.liquid. И ставим код в тег <head>:

Сохраняем, код подключен.

Создайте свою страницу, далее перейдите в Настройки → Общие → Вставка HTML кода:

Вставляйте код в обычном виде, без base64.

Сохраните.

# Tilda

Создайте свой сайт и откройте список страниц, после чего нажмите Настройки:

Перейдите в раздел Дополнительно и пролистайте вниз до блока HTML-КОД ДЛЯ ВСТАВКИ ВНУТРЬ HEAD.

Здесь и необходимо будет поставить js код, однако эта опция доступна только на платных тарифах.

После добавления кода не забудьте опубликовать сайт заново, чтобы правки вступили в силу.

# Flexbe

Создайте свой сайт и в шапке перейдите в Настройки:

Далее нажмите Вставка кода и Перед закрывающим тегом .

Импортируйте код в этом месте:

Сохраните все изменения.

# GitHub pages

Создайте новый репозиторий:

Откройте index и вставляйте JS код:

Сохраните и сделайте push в github. При открытии страницы из репозитория будет срабатывать js код.

# KClient JS FAQ

::: Как фильтровать ботов?

Действие «Ничего не делать» оставит бота на сайте, на котором будет стоять скрипт. Второй поток — это целевое действие для всех остальных.

В потоке «Bot Protection» вы выставляете любой набор фильтров, который нужен будет для отлова ботов.

В потоке Stream 2 вы выставляете целевое действие. Если там будет выбран локальный лендинг/оффер, то этот лендинг/оффер будет выгружен на сайт с интеграцией без редиректа и смены домена, в случае если трафик не попадет в бот поток.

:::

С какими конструкторами скрипт не совместим?
  1. WIX
  2. Google.Sites
Выявляет ли боты?

При генерации скрипта вы можете включить опцию — base 64, что позволит генерировать код скрипта в уникальном зашифрованном виде, избегая тем самым в содержании ключей вида "tracker", "api" и других похожих значений, которые бы помогли ботам детектить работу трекера.

При переходе на сайт, где установлен код, ничего не происходит

Первым делом перейдите в кампанию в Keitaro, откройте в правом углу над потоками Лог и сделайте клик по сайту.

Если лог остаётся пустым, проверьте, правильно ли вставлен код интеграции.

Код необходимо вставлять в HEAD.

Лог трафика есть, но при переходе на сайт ничего не происходит

Убедитесь, что протоколы, которые используются в кампании и на сайте, одинаковые. Если сайт работает на HTTP, то и ссылка кампании должна быть на HTTP.

Аналогично и с HTTPS: если сайт работает на HTTPS, то и ссылка кампании должна быть на HTTPS.

При переходе по ссылке сайта вечный редирект

Проверьте в потоках наличие ссылки на сайт с интеграцией. Указывать в потоке сайт, в котором стоит код KClient JS, не необходимо.

Это приводит к бесконечному редиректу, так как переход на сайт открывает кампанию, в которой в потоке опять стоит ссылка на сайт, а в нём — код KClient JS.

Это замкнутый круг.

При переходе на сайте ошибка MIXED CONTENT
  1. Проверьте, что все ссылки внутри кода сайта на HTTP. При работе через HTTPS на сайте могут остаться ссылки со старым протоколом, что может привести к ошибкам в браузере.
  2. Если работаете с доменом через Cloudflare, убедитесь, что в режимах настройки SSL на CloudFlare установлен режим Flexible.
  3. Обновитесь до последней версии трекера.