Отправка заявок по API в CTR.RU

Привет дорогие друзья! Продолжаем серию публикаций об отправке заявок по апи. Сегодня мы рассмотрим отправку заявок по API в CTR.RU — товарную партнерскую сеть.

Обязательно почитайте статью «Основные моменты передачи лидов по api» там рассматриваются базовые моменты этого процесса, причем в качестве примера документации приводится как раз документация CPA сетки ctr.ru))

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

Итак, переходим непосредственно к настройке отправки заявок по api в ctr.ru, для этого открываем их документацию и смотрим какие данные обязательны к отправке, чтобы правильно сформировать наши формы. Давайте я немного поясню что в этом документу нас интересует. Первое что мы видим это раздел запросы, тут показан url адрес запроса и из чего он состоит, а именно метод и апи ключ.

Методов тут много, какие-то для рекламодателей, другие для вебмастеров, но для отправки лидов по апи в ctr.ru нас интересует метод order_add, который позволяет добавлять заказы в систему. Свой api ключ вы можете скопировать перейдя в Профиль — Другие настройки.

Га что еще хотел бы обратить ваше внимание, это на раздел Ответы в документации, это очень существенная помощь, когда по какой то причине заявки не приходят в спа сеть, сервер партнерки присылает в таком случае код ошибки и ее расшифровку, что помогает исправлять баги. Так что рекомендую не пренебрегать такой возможностью.

Ответы сервера ctr.ru об ошибке или успехе отправки лида

Далее пропустим все не интересующие нас методы и и обратимся непосредственно к методу добавления лида в CPA.ru. Давайте сразу рассмотрим обязательные для отправки данные, без которых на стороне cpa сети заявка принята не будет.

Обязательные поля:

fio — т.е. имя клиента;
phone — т.е. номер телефона клиента;
site_id — это ID лендинга в парнерке, увидеть его можно на странице оффера в списке лендингов, следовательно если у вас свой, то впишите сюда номер любого лендинга в их системе под этот оффер;
out_order_id — здесь передается в вашей системе, если таковая используется, странный пункт конечно особенно среди обязательных, будем просто рандомный номер отдавать;
country — гео оффера в двухбуквенном формате;
ip — IP адрес клиента;
ua — User Agent браузера клиента.

Вот эти данные мы с вами в обязательном порядке должны передавать при заказе с нашего лендинга, я предлагаю все кроме имени и телефона прописать сразу в обработчике, чтобы не возиться долго с формами, особенно если их на лендинге много. Опционально можно еще в формах указать гео если предполагается заказ с разных, но это уже сами сделаете кому нужно просто прописав их в теге <select name=»country»>.

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

<?php
$key = '2a5a3a3e1526840cb4b22d2f59279c83'; //Api-ключ
$post_data = array(
	'fio'          => $_POST['name'],
	'phone'        => $_POST['phone'],
	'site_id'      => 1521, // $site_id в нашей системе
	'out_order_id' => rand(154789, 547896), // номер заказа в вашей системе
	'country'      => 'RU', // $_POST['country'] если есть выбор стран в форме
	'ip'           => $_SERVER['REMOTE_ADDR'],
	'ua'           => $_SERVER['HTTP_USER_AGENT'], // User Agent браузера
	'referer'      => $_SERVER['HTTP_REFERER'],
	'sub_id'	   => $_POST['sub_id'] //для примера, если допустим передаете метку из трекера для постбека
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_HEADER, true);
curl_setopt($ch, CURLOPT_NOBODY, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);

curl_setopt($ch, CURLOPT_URL, 'https://thank-you.pro/api.php?method=order_add&key='.$key);

$res = curl_exec($ch); // Ответ в json при желании его можно распарсить и вывести $array=json_decode($res, true);
curl_close($ch);

header("Location: order.html"); //редиректим пользователя на страницу спасибо
?>

Вот собственно и все, в коде выше готовый обработчик подставив в который свой апи ключ и id лендинга вы сможете отправлять заявки по API в CTR.RU. Я прокомментировал в коде что где находится, так что дело осталось за малым, перенести это к себе и лить трафик))

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

Создай свой обработчик