Автор: 
Сегодня мы пошагово разберем интеграцию 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.
