# Передача конверсий по API в партнерские сети

На данной странице описаны интеграции Keitaro и партнёрских лендингов с передачей заявок по API.

Настройка в большинстве случаев проходит в два этапа:

Вносятся корректировки в файл лендинга;
Настраивается глобальный postback в партнёрской программе с использованием шаблона postback URL из Keitaro. В некоторых случаях postback настраивается не глобально, а на уровне потока, к которому привязан скачанный лендинг.

Основной проблемой в схеме является некорректная передача subid, что не позволяет получать корректный postback в Keitaro. В статье приведены примеры настройки лендингов из различных партнёрских программ.

# AD1

Обратитесь в поддержку для доступа в API раздел. Возьмите API key и ссылку на скачивание php скрипта для отправки лидов.

Далее необходимо создать поток и попросить поддержку предоставить лендинг для данного потока.

Когда архив с лендингом получен, из папки с API файлами, скачанной ранее, необходимо скопировать order.php и success.html в папку с лендингом.

Откройте index файл и внесите корректировки.

Найдите форму заявки по слову action и вместо /order пропишите order.php.
Вставьте строку input для передачи subid:

<input type="hidden" name="sub1" value="{subid}">

Сохраните и перейдите к настройке order.php.

В order.php пропишите значения:

Идентификатор потока
API ключ

Сохраните, поместите файлы лендинга zip архив и загрузите в трекер.

# Adcombo

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

Откройте index.php (или index.html) и в параметрах input добавьте еще одну строку:

<input type="hidden" name="clickid" value="{subid}">

Сохраните index, поместите файлы лендинга в zip архив и залейте в трекер.

Не забудьте настроить postback, взяв готовый URL из шаблона Adcombo в Keitaro.

# CTR.ru

Выберите необходимый оффер в партнёрской сети, скачайте лендинг.

Откройте полученный архив с файлами, переместите index.php в папку dis. Из папки dis удалите файл index.html.

Откройте index.php и внесите следующие изменения:

Найдите и удалите строку <basehref=»dis/»>
В каждую форму c атрибутом action после method=post вставьте код:

<input type="hidden" name="sub_id" value="{subid}">

Сохраните, поместите файлы лендинга zip архив и загрузите в трекер.

# Dr.Cash

В партнерской программе доступны разные API обработчики:

По умолчанию используется JS код. Для настройки необходимо поменять конструкцию

sub1: drlead.queryGet("sub1")

на

sub1: "{subid}",

В коде:

Если используется PHP код для обработки, то измените

'sub1' => $_GET['sub1'],

на

'sub1' => $_POST['sub1'],

в массиве данных Fields to send

Далее вставьте в index строку с заполнением параметра:

<input type="hidden" name="sub1" value="{subid}"/>

Если используется HTML код, дописывается input строка с передачей subid

<input type="hidden" name="sub1" value="{subid}" />

# Everad

Передача subid в лендингах Everad настраивается путем добавления одной строки с input параметром.

Откройте файл и в каждой форме заявки добавьте строку:

<input type="hidden" name="sid5" value="{subid}">

Если в архиве используется subscribe.php, необходимо дописать передачу параметра sid5

'sid5'=> ($_POST['sid5']),

Не забудьте скорректировать код для редиректа на страницу «Спасибо». Находится в нижней части среди JS кода по ключам:

subscribe.html":"/success.html"

Найдите код и перед subscribe.html допишите путь формата /landings_folder/name_folder/,

где landings_folder — имя папки с лендингами, по умолчанию «lander»,

и name_folder — имя папки конкретного лендинга, отображается при открытии лендинга:

Пример корректного пути:

Сохраните файл и заархивируйте лендинг, чтобы загрузить в Keitaro.

Добавьте глобальный или потоковый postback в Everad, и настройка завершена.

# HotPartners

Запросите у менеджера необходимый лендинг, настроенный по API. Убедитесь, что в архиве присутствуют все необходимые файлы для корректной передачи заявок: index.php, send.php и success.html.

Откройте index.php и в каждой форме заявки добавьте строку с input параметрами:

<input type="hidden" name="sub_id1" value="{subid}">

Сохраните изменения и перейдите к редактированию send.php.

В перечне параметров $data = array( измените первую строку на:

'sub_id' => empty($_REQUEST['sub_id1']) ? '' : $_REQUEST['sub_id1'],

Сохраните, поместите файлы лендинга zip архив и загрузите в трекер.

В качестве заключительного шага скопируйте postback URL из шаблонов партнёрских сетей в трекере и пропишите ссылку на стороне партнёрской сети HotPartners.

# KMA

Для настройки передачи subid на лендингах от КМА, добавляется всего одну строка в index.html.

Открываем index.html и в форму заявки добавляем проброс subid параметра:

<input type="hidden" name="data1" value="{subid}">

После сохраняем файлы лендинга и заливаем в трекер zip архивом. Не забудьте взять Postback URL из шаблонов партнерских сетей Keitaro и прописать в партнерской сети KMA.

# Leadtrade

Для настройки партнерской сети необходимо прописать input параметры в форме (формах) заказа, чтобы при клике по кнопкам на каждой форме уходило и значение subid.

В поиске в редакторе найдите тег <form>.

Данные внутри тега, атрибуты и классы в каждом лендинге отличаются, в данном случае не играют роли.

Добавьте строку с именем параметра ID клика, в котором партнёрская сеть забирает ID клика, в случае с Leadtrade — параметр subid1:

<input type="hidden" name="subid1" value="{subid}">

Сохраните в архиве и добавьте архив в трекер.

# Leadvertex

Для настройки лендинга из партнёрской сети Leadvertex необходимо внести корректировки в index и send файлы.

Откройте index.html и добавьте в форму заказа параметр subid к input параметрам:

<input type="hidden" name="subid" value="{subid}"/>

Сохраните и перейдите к редактированию send.php. Найдите строку:

'utm_term' => $utm['utm_term'],

Измените на:

'utm_term' => $_POST['subid'],

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

# LemonAD

Перейдите на страницу оффера и скачайте необходимый лендинг.

В файле index.php найдите тег <form.

В поле action вставьте значение lemon.php.

Установите следующий код внутрь формы и сохраните файл:

<input type='hidden' name='utm_source' value='<?= $_GET['utm_source'];?>'>
<input type='hidden' name='utm_content' value='<?= $_GET['utm_content'];?>'>
<input type='hidden' name='utm_campaign' value='<?= $_GET['utm_campaign'];?>'>
<input type='hidden' name='utm_term' value='<?= $_GET['utm_term'];?>'>
<input type='hidden' name='utm_medium' value='<?= $_GET['utm_medium'];?>'>
<input type='hidden' name='clickid' value='{subid}'>

1
2
3
4
5
6

В коде оффера:

Сохраните файл и загрузите в трекер в раздел офферы, либо сохраните изменения в редакторе Keitaro.

# LuckyOnline

Скачайте необходимый лендинг из партнерской программы и в настройках потока скопируйте hash.

Переходите к редактированию файла index.html.

Откройте файл и найдите строку с hash, пропишите ранее скопированное значение hash и рядом допишите параметр для передачи subid:

subid: '{subid}'

Сохраните index.html и загрузите архив лендинга в трекер.

Postback настраивается глобально в настройках аккаунта:

Настройка завершена.

# M1-Shop

# Первый способ

Скачайте лендинг с помощью инструмента:

При загрузке таким образом в лендинге уже указан актуальный API key и ID вебмастера. В архиве находятся два файла: index.html и call.php.

Откройте index.html с помощью Блокнота или другого текстового редактора кода и проверьте все формы заполнения заявки, которые приводят к конверсии. Проще всего воспользоваться поиском по документу (CTRL + F) и найти по кнопке «Заказать» или ее аналогу.

Код формы начинается с <form name=. Найдите в форме строку action type, где прописан исполняемый файл, отвечающий за сбор и отправку конверсий — order.php (call.php, sendleads.php или другой).

Далее добавьте строку кода, в которую необходимо записать subid клика, необходимый для идентификации конверсии в партнёрской сети и передачи данных с postback обратно в трекер.

Найдите строку:

client_s = QueryString.s;

Замените на:

client_s = '{subid}';

Сохраните изменения и создайте zip архив с файлами index.html и call.php.

Загрузите архив локально в трекер как лендинг и добавьте в кампанию.

# Второй способ

Обновленные лендинги от М1-Shop имеют иную структуру, настройка в данном случае отличается.

Добавьте вывод subid в форму заявки:

<input name="subid" type="hidden" value="{subid}">

Найдите функцию отправки заказа и добавьте subid к имеющимся параметрам:

function sendData(client_name, client_phone, subid)

В участке кода, где идет отправка запроса, подставьте subid напротив s:

В коде вызова функции добавьте строку:

$('input[name=subid]', this).val()

# M4Leads

Для настройки лендинга из партнёрской сети M4Leads необходимо внести корректировки в index и order файлы.

Откройте index.html и добавьте в форму заказа параметр subid к input параметрам:

<input type="hidden" name="sub_id[0]" value="{subid}">

Сохраните и перейдите к редактированию order_ru.php.

Найдите строку $sub_id = и приведите к следующему виду:

$sub_id = !empty($_POST['sub_id']) ? $_POST['sub_id'] : array();

Сохраните изменения. Поместите файлы в zip архив и загрузите в трекер.

В настройках партнёрской сети M4Leads настройте глобальный postback и метод передачи GET.

# MonsterLeads

На стороне партнёрской системы выберите оффер, создайте поток и сохраните изменения.

Откройте вкладку Потоки, нажмите Редактировать. Появится кнопка с возможностью скачать лендинг:

Скачайте лендинг, откройте index.html.

С помощью Блокнота или другого текстового редактора кода найдите все формы заполнения заявки, которые приводят к конверсии. Проще всего воспользоваться поиском по документу (CTRL + F), по слову action.

Внесите следующие изменения:

Удалите слэш «/» перед sendleads.php.
В форму добавьте строку:

<input type="hidden" name="subid1" value="{subid}">

Найдите строку, которая содержит subid.js и закомментируйте (<!—………. —>), чтобы получилось как на скриншоте:

Сохраните index.html, поместите файлы в zip архив и загрузите лендинг в трекер.

# Ryumka

Для настройки лендинга из партнёрской сети Ryumka.biz необходимо внести корректировки в index и order файлы.

Откройте index.html и добавьте в форму заказа параметр subid к input параметрам:

<input name="click_id" type="hidden" value="{subid}" />

Сохраните и перейдите к редактированию order.php.

В перечне параметров $params = array() добавьте:

if(isset($_POST['click_id']))
  $params['click_id'] = $_POST['click_id'];

1
2

И в массиве $data = array( допишите строку:

'click_id' => $p['click_id'],

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

# Shakes.pro

Для настройки оффера необходимо внести изменения в файлы index и order.

В index.html найдите формы зявки и добавьте строку для передачи subid клика трекера.

<input type="hidden" name="sub1" value="{subid}" />

Сохраните изменения и перейдите в файл order.php.

Замените строку:

'sub1' => (!empty($_GET['sub1']) ? $_GET['sub1'] : ''),

На

'sub1' => (!empty($_POST['sub1']) ? $_POST['sub1'] : ''),

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

# TerraLeads

При нажатии на кнопку Сгенерировать API откроется доступ к файлу Webmaster API, который отвечает за передачу информации в партнёрскую сеть по API. В следующем меню настраивается Postback URL.

Возьмите Postback URL из шаблона партнерской сети TerraLeads в Keitaro.

Далее перейдите к редактированию файлов лендинга.

Откройте файл и добавьте строку с параметром subid в каждую форму заявки на сайте:

<input type="hidden" name="sub_id" value="{subid}">

Сохраните изменения и перейдите к настройке следующего файла.

Откройте файл и найдите строку $data = array(

К параметрам допишите sub_id:

'sub_id'  => $_POST['sub_id'],

В конечном итоге результат выглядит следующим образом:

Сохраните файлы лендинга и загрузите архив в Keitaro. Настройка завершена.

# Traffic Light

Настройка лендинга в Traffic Light простая и требует минимум действий со стороны пользователя.

В кабинете на сайте Traffic Light выберите оффер и создайте поток.
Зайдите в карточку оффера (вкладка «Информация») и загрузите лендинг, предварительно выбрав необходимый поток и трекер. Сразу укажите Postback URL для отправки конверсий в Keitaro:

Загрузите полученный архив в Keitaro.

Лендинг готов!

← Устранение проблем с postback FB Pixel →