Отправка заявок по API в KMA

Привет дорогой читатель! Давно не пополнял статьями свой блог. Сегодня продолжим тему отправки заявок с лендингов по апи в партнерские сети. Рассмотрим в данной статье тему отправки заявок по api в kma.biz, товарную партнерскую сеть.

Итак приступаем, сразу хочу отметить что в данной cpa сетке есть масса своих лэндингов любой из которых можно скачать с уже настроенным апи. Для этого нужно выбрать оффер и нужный лендинг, после чего создать поток. Далее переходим в Потоки — Мои потоки и там видим в колонке лендинги выбранный нами ленд. Под ним кнопочка для скачивания, качаем и наслаждаемся))

Это самый простой способ получить лендинг с уже настроенным апи, но далеко не всегда и не для всего он подходит. Далее расскажу про другой способ, как интегрировать апи kma.biz с любым собственным лендингом.

В личном кабинете переходим в Инструменты — API там выбираем вкладку Методы создания лидов и нажимаем на плюсик рядом с Отправка лидов из формы заказа. Перед нами открывается подробная инструкция как интегрировать готовый набор скриптов для подключения апи кма к собственному лендингу. Саму папку со скриптами можно скачать прямо там ссылка на фото указана стрелочкой.

Давайте подробнее разберем эту инструкцию. Первое на что стоит обратить внимание

Для работы с api по добавлению заявок запросить доступ к api для добавления лидов у персонального менеджера! 

1. На своем сервере в корне сайта необходимо разархивировать папку api и разместить ее в корне сайта.
2. В файле http://domain.com/api/install.php
   2.1 Удостоверится что Ваш сервер удовлетворяет всем требованиям
   2.2 Заполнить API ключ и поток в форме, сохранить

Получение api ключа — https://cabinet.kma.biz/user/settings/api-key

в параметре $token = ‘xxx’; // указать ключ api
в параметре $channel = ‘xxx’; // указать код потоковой ссылки

3. Отправить тестовый лид, для проверки корректности настроек

Дополнительно

1. Шаблоны страниц расположены в api/template/
   api/template/success.php — шаблон страницы успешного заказа
   api/template/error.php — шаблон страницы сообщения об ошибке
2. Если используются utm метки, они будут записаны в поля data1-data5

Соответствия полей
data1= utm_sourсe
data2= utm_medium
data3= utm_campaign
data4= utm_content
data5= utm_term

3. Если сервер KMA не отвечает в течении 15 секунд, тогда лид будет записан в файл api/log-.txt. Важно:

• не переименовывать этот файл
• для переотправки лидов можно вызвать скрипт http://domain.com/api/resend.php (если отправились все лиды, тогда файл удалится)

Собственно говоря все предельно понятно написано после выполнения этой инструкции у вас в директории лендинга будет папка api настроенная для отправки заявок. У себя на лендинге вам остается только прописать в формах путь к файлу обработчику в атрибут action

action="api/success.php"

<input type="hidden" name="data1" value="значение">
<input type="hidden" name="data2" value="значение">
<input type="hidden" name="data3" value="значение">
<input type="hidden" name="data4" value="значение">
<input type="hidden" name="data5" value="значение">

<input type="hidden" name="language" value="en">

ну и сбор меток если вы собираетесь их передавать в пп как показано выше в атрибуты data1-data5. Кроме того, для отображения страницы «Спасибо» на языке, отличном от русского, необходимо в формы добавить инпут name=»language» с необходимым языком. В примере выше указан английский. Поддерживаемые скриптом на момент написания статьи языки: am,ar,az,be,bg,bs,cs,de,el,en,es,et,fr,ge,hi,hr,hu,id,it,ka,kk,lo,lt,lv,mk,mo,ms,ph,pl,pt,ro,ru,sk,sl,sr,sv,th,tr,uk,uz,vn.

В индексный файл своего сайта (index.html, index.php и т.д.) нужно добавить ссылки на js скрипты kma и расположить их в конце перед закрывающимся тегом body:

<script src="https://cdnkma.biz/custom-api.js"></script>
<script src="https://cdnkma.biz/custom.js"></script>

Вот собственно два простых способа как настроить отправку заявок по api в kma.biz. Они рабочие, и не так сложно все настроить.

Перейдя по кнопке ниже, вы сможете ввести необходимые данные и скачать готовый php обработчик, полностью настроенный для передачи заявок по api в KMA.