Большая статья про KClient PHP

Сегодня мы пошагово разберем интеграцию KClient PHP и выполним подключение к удаленному сайту. В качестве примера настроим нашу кампанию так, чтобы боты оставались на нашем сайте, а клиенты попадали на целевой оффер.

Пару слов об интеграции:
KClient PHP (бывш. Click API v3) — это один из методов интеграции Keitaro, который позволяет подключаться к удаленным ресурсам посредством PHP кода и делать динамическую подмену контента без видимого редиректа. Этот метод подходит для любых удаленных сайтов, где можно разместить php код, а также для импорта в webview мобильных приложений.

Подготовка

Для работы интеграции нам понадобится удаленный сайт с доступом по FTP, а также созданная кампания в Кейтаро.

Первым делом создаем нашу кампанию:

Создаем два потока.  Первый поток с действием Ничего не делать и фильтром БОТ. Что позволит нам оставлять ботов на сайте.

Второй поток мы будем использовать для наших клиентов, тут мы можем добавить и ссылку на редирект и оффер и лендинг, все зависит от вашей воронки трафика.

Такая настройка, позволят оставлять ботов на сайте, и направлять клиентов куда нам нужно.

После чего, переходим на вкладку интеграции и выбираем KClient PHP

Обратите внимание на поле Ссылка кампании.

Для корректной работы интеграции вам потребуется припаркованный домен , а также что бы сайт, на который мы будем ставить интеграцию, имели одинаковые протоколы.
Например, домен припаркованный к кампании протокол — http  и домен сайта куда мы ставим интеграцию http. По аналогии, если вы хотите использовать https, оба домена должны иметь сертификат.

Подключение к удаленному сайту по SFTP

После того, как мы создали кампанию, нам необходимо подключится к нашему удаленному сайту по SFTP. Подробно процесс подключения показан в нашем видео.

Подключившись, нам необходимо перейти в директорию, где лежит файл index нашего сайта(страницы) для которой мы хотим выполнить интеграцию.

Интеграция KClient PHP

Возвращаемся на страницу с нашей кампанией и вкладкой  Интеграции и копируем код клиента.


После чего открываем наш index и вставляем код в самое начало файла.  Не забываем при необходимости сменить расширение файла index с .html на .php.

Важным условием добавления и сохранения файла с кодом вашего сайта, является отсутствием BOM в кодировке Utf-8.
BOM (Byte Order Mark) — символ вида U+FEFF.

Сделать это можно с помощью обычного текстового редактора:

Также нам понадобится сам файл клиента, его можно взять там же, на странице интеграции внизу страницы.

Качаем на файл и загружаем его рядом с файлом index куда только что мы вставляли код интеграции.

На этом, основной этап интеграции завершен, теперь при переходе на главную страницу сайта, в код которой мы добавили интеграцию, будет вызвана созданная нами кампания Кейтаро.

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

Более подробно о том, как правильно читать лог, вы можете посмотреть в нашей статье “Как правильно читать лог трафика“.

Ответы на самые частые вопросы по KClient PHP вы найдете в нашем FAQ и в статье по решению проблем c KClient PHP

И конечно в случае любых вопросов вы всегда можете написать нам в поддержку в чат на сайте keitaro.io или телеграм бот — @keitarobot.