1. Главная
  2. Руководства

API-интеграция в ПП для новичков


Полезный материал от наших друзей из Leadrock 

API-интеграция для отправки лидов в партнёрки - это краеугольный камень для большинства арбитражников. Шутка ли, даже некоторые опытные медиабайеры, что находятся на рынке долгое время, предпочитают отдать этот перечень работ техническому специалисту.

И хотя в каждой ПП написаны подробные исчерпывающие мануалы и гайды, подготовлены десятки видео, и даже работает где-то на просторах CPA-индустрии сайт-каталог со всеми типами интеграций от одной ПП к другой - всё равно сотни новичков ударяются о барьер непонимания принципов работы интерфейсов программного доступа.

И хорошо, когда лендинг скачивается “из коробки” и распаковывается на хостинг с уже настроенной/установленной интеграцией. У вебмастера нет нужды разбираться в хитросплетениях ссылающихся друг на друга файлов и изучать скрипты. Такая функция сейчас есть у всех ПП (в основном, чтобы облегчить старт новичкам). Но стоит только начать вносить изменения и правки в содержимое лендинга, как всё сразу сыпется, лиды перестают долетать до партнёрки, записываться в файл или ленд и вовсе начинает работать некорректно.

Почти половина “проблемных” обращений новичков в саппорт - это трудности с настройкой интеграции. И казалось бы: ну, всё для вас сделали. Только бери да лей. Но нет, всё равно возникают проблемы. За сим сегодня изучаем основы API-интеграции в LeadRock Network. Достаточно совсем немножко разобраться (а не использовать готовый костыль), и вы самостоятельно сможете решать проблемы с API.

Интерфейсы Программного Доступа

API - это так называемый интерфейс программного доступа, программное обеспечение, позволяющее управлять приложением или сайтом, или контентом сайта посредством отправки запросов (без админки, стало быть).

В товарных партнёрках подразумевается отправка данных из формы заказа (лидов) на ссылку сервера партнёрки. И это также просто работает, как и звучит. Во всех случаев функционирование API обеспечивается библиотекой curl (данная библиотека фактически и составляет тело API и существует для того, чтобы обеспечивать передачу данных из приложения/сайта на сервер). А непосредственно сама передача осуществляется методами $_post (для формы) $_get (для ссылки) и массивом $_request.

Если простыми словами, то данные html-формы (лид) вместе с другими параметрами отправляются php-скрипту и уезжают на ссылку сервера партнёрки, где лид со всеми соответствующими параметрами попадает в базу данных партнёрки.

Только и всего. По сути API - это просто несколько строк кода (в подавляющем большинстве случаев в партнёрках это .php). Вам достаточно знать, какой параметр за что отвечает, что чему должно соответствовать. Так Вы будете в состоянии легко манипулировать кодом интеграции даже с лендинг-страницами не из LeadRock Network. В целом, понимание основ API - это вообще полезный навык для работы с любой партнёркой. Перейдём непосредственно к примерам интеграций.

Варианты интеграции в LeadRock

Готовая интеграция лендинга

Наиболее популярным способом интеграции для Cash-on-Delivery партнёрок является скачивание готового лендинга с уже установленной интеграцией. Отправка запроса на скачивание зашивает в .php файл трекинговую ссылку, API-key и API-secret. Во всех партнёрках работает приблизительно одинаково - “по кнопке” скачиваешь .zip архив, распаковываешь на хостинг и готово. Можно лить.

Чтобы любая интеграция работала, платформе партнёрки необходимо соотносить API лендинг-страницы с конкретным потоком трафика. Отсюда интеграция невозможна без ссылки потока, которая генерируется вот так:

API-интеграция в ПП

Таким образом, сетка сможет правильно идентифицировать ваши лиды. Вне зависимости от типа интеграции URL потока обязателен почти во всех ПП. Дальше, как и сказано выше, происходит скачивание ленда “по кнопке”:

API-интеграция в ПП

Едем дальше. Скачивание лендинга выглядит вот так:

API-интеграция в ПП

Стандартная интеграция как раз предполагает “зашивание” в скрипт php файла всей необходимой информации. В LeadRock интеграция устроена таким образом, что index.php файл не является файлом интеграции сам по себе, он запускает команду на скачивание универсального интеграционного пакета . В итоге каталог ленда будет выглядеть приблизительно так:

API-интеграция в ПП

Внутри index.php содержатся необходимые API-key , API-secret и выставленный линк потока. Файл leadrock-integration.phar трогать бессмысленно. Манипуляции можно производить только со следующим куском кода:

API-интеграция в ПП

Где Leads.log - это файл, в который “пишутся” все созданные лиды. Писать лиды в файл полезно на тот случай, когда партнёрка перестаёт функционировать из-за форс-мажоров. Такое бывает крайне редко, тем не менее в случае чего собранные лиды можно будет передать менеджеру, и последний самостоятельно “руками” перенесёт заявки в партнёрку.

Следующей строкой параметрами идут Ваши API-key и API-secret, а ещё ниже URL потока трафика. Эти данные взяты автоматически при создании архива лендинга в партнёрке.

Дальше идут поля параметров странички “Спасибо” (thankyou.php). Часто бывает, что в разных сетках thankyou-page называют по разному. Например, часто используют название confirm.html/confirm.php . Следите, пожалуйста, чтобы у вас в коде имена файлов совпадали (на случай, если вы “позаимствовали” страницу “спасибо” с другого ленда, или сделали самостоятельно).

Названия форм ‘name’ , ‘phone’ , ‘other’ - тоже строгие параметры. Они берутся из html-формы лендинга, поэтому должны соответствовать. Ни в коем случае не меняйте, если не уверены. Соответственно поля имя и телефон понятны, в параметр other записывается всё остальное из формы (например, если вы льёте длинноформу по модели CPL).

Все параметры применяются к лендингу landing.html . Так по умолчанию называются все скачиваемые архивы лендов из LeadRock. По правде говоря это не очень удобно (когда все скачиваемые материалы называются landing, но это сделано как раз, чтобы не было косяков с интеграцией. Отсюда, если вы взяли ленд где-то на стороне, а файлы интеграции оставили те же (так лучше не делать, к слову), то не забудьте переименовать .html файл в landing.

Всё остальное в этом файле лучше не трогать даже после того, как .phar файл будет установлен. Собственно, это всё, что надо знать про стандартную API-интеграцию “из коробки”. Следите, чтобы имена файлов и параметры форм на хостинге и в html совпадали с оными в php, и всё будет хорошо.

Дополнительный вариант интеграции

Представляет собой устаревший версию API, в случае с которой в код лендинга автоматически интегрируется php-скрипт передачи данных из формы (лида) на сервер LeadRock. Я считаю, что это более простой и легковесный способ интеграции, ведь он также не требует никакой дополнительной настройки (подходит для новичка). Скачал => распаковал => можно лить.

Из хорошего: ничего лишнего, несколько строчек кода и всё. Подходит для хостингов, которые запрещают автоматическое скачивание файлов. Из плохого: не ведётся логирование лидов в файл. На хостинге распакованный ленд будет выглядеть так:

API-интеграция в ПП

Где index.php - это .html разметка лендинг-страницы с php вставкой API-интеграции. Сам код интеграции выглядит так:

API-интеграция в ПП

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

Строка $url = 'https://leadrock.com/api/v2/lead/save'; указывает на API партнёрки, куда отправляются все лиды. Всё что ниже - это curl. Трогать категорически запрещено. Скрипт:

API-интеграция в ПП

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

Лендинг без интеграции

Идеальный в нашем понимании сценарий: вебмастер переработал ленд партнёрки, сделал с нуля собственный, или позаимствовал на стороне, допилил под себя и подготовил его к заливу трафика. В этом случае интеграцию надо настраивать вручную. 

Чтобы настроить интеграцию вручную, вам понадобятся всё те же API-key и API-secret. Взять их можно вот здесь в разделе “данные” :

API-интеграция в ПП

Ссылку на поток вы уже знаете, где взять. В самый верх лендинг-страницы (перед <html> тегами) вставляем точно такой же скрипт, как выше:

API-интеграция в ПП

Файл index.html переименовываем в index.php - и всё. Минимальное API настроено. ОБЯЗАТЕЛЬНО делаем тестовые лиды (в поле имя пишем “test”, чтобы лидочек сразу уехал в трэш).

Ежели что-то не работает: проверяем соответствие всех переменных и имён файлов на хостинге. Кстати! Вы всегда можете воспользоваться конструктором интеграций в списке инструментов LeadRock.

Подведём итог

API-интеграция в партнёрках - крайне несложная штука. Невнятные строчки кода только на первый взгляд кажутся сложными, на деле же любой новичок может освоить интерфейсы на достаточном уровне, чтобы не совершать ошибок. От вас не требуется познаний языков программирования, чтобы всё работало. Поэтому не бойтесь. Смело экспериментируйте с лендингами. Ведь чем больше тестов, тем выше вероятность успеха. Такие дела.

Спасибо, что читаете до конца и развиваетесь :)

Источник


Комментарии