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

В данной статье я расскажу как настроить отправку заявок по api в такую CPA сеть как adcombo.

Чтобы не повторяться в каждой статье, о базовых вещах которые необходимо знать при настройке отправки заявок по апи, я расписал в статье основные моменты передачи лидов по API. Поэтому все базовые вещи читаем там.

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

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

И еще, у adcombo своя структура и сам лендинг в их архиве находится в папке content, имейте это ввиду.

Но вы можете столкнуться с такой ситуацией, что у вас будет свой классный лендинг которого нет в партнерке и вот тут и встает вопрос как же именно к нему подключить отправку лидов по api в adcombo. Тут есть два способа как это сделать и сейчас я расскажу о них.

Первый способ это просто скачиваете лендинг под нужный оффер в партнерке, удаляете из папки content их лендинг и помещаете туда файлы своего. После этого открываете в редакторе кода index.html файл своего лендинга, находите в нем тег <form и прописываем атрибуту action путь к файлу обработчику он тут называется order.php, таким образом

action="order.php"

далее откройте оригинальный файл index.html из скачанного архива найдите там открывающий тег <form> и скопируйте все скрытые инпуты (имеют атрибут type=’hidden’), которые идут после него они у них всегда идут по порядку и заканчиваются инпутом с атрибутом name=’package_prices’ главное внимательно, не скопируйте ничего лишнего. Копируем как в примере ниже

после чего вставьте их в форму своего лендинга (если форм на странице несколько то меняем action и прописываем срытые инпуты во всех). Собственно на этом все, ваш сайт должен спокойно отправлять заявки в adcombo.

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

• api_key — ваш api ключ, получить его можно у менеджера или опять же скачать любой лендинг под этот оффер в личном кабинете и в архиве открыть файл config.php, он будут указан в константе API_KEY.
• name — имя клиента, которое он указывает при заполнении формы.
• phone — телефон клиента, который он указывает при заполнении формы.
• offer_id — id оффера в системе, указан на странице оффера в партнерке под названием.
• country_code — двухбуквенный код гео на которое настроен оффер.
• base_url — ссылка на лендинг с которого будут идти заявки.
• price — продажная цена товара.
• referrer — сайт откуда пришла заявка.
• ip — IP-адрес клиента.

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

первые две строчки это собственно url адрес куда мы будем отправлять наши заявки, далее нужно в кавычках указать наш ключ апи, где и как его получить писал выше.

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

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

$args = [
    'api_key' => API_KEY,
    'name' => $_POST["name"],
    'phone' => $_POST["phone"],
    'offer_id' => $_POST["offer_id"],
    'country_code' => $_POST["country_code"],
    'price' => $_POST["price"],
    'base_url' => $_SERVER['HTTP_REFERER'],
    'ip' => $_SERVER['REMOTE_ADDR'],
    'referrer' => $_SERVER['HTTP_REFERER'],
];

Чуть подробнее о коде выше, ключ апи мы прописываем просто в виде константы как он в ней и указан выше, далее поля имя, телефон, id оффера, код страны и цену товара, мы получаем из массива POST, который приходит к нам с формы, в base_url указываем адрес нашего ленда где он будет, его и два последующих параметра мы получаем из глобального массива SERVER, записи в нем создаются самим сервером. HTTP_REFERER выдаст нам информацию о домене с которого идет заказ, а REMOTE_ADDR укажет ip адрес клиента.

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

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

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