Интеграция с Admitad.com¶
Admitad - это международная платформа, созданная в 2009 году. СРА-сеть объединяет под своим началом сотни офферов и партнерских программ, монетизация трафика проводится по всем известным схемам конверсии. Сервис работает с такими гигантами интернет-маркетинга, как Lamoda, TravelPayouts, AliExpress, DHGate и т.д. Для интеграции с Admitad необходимо:
- Открыть главное меню сайта и в разделе "Интеграции" выбрать партнерскую программу Admitad.
- В появившемся окне скопировать ссылку (PostBack URL), нажав на соответствующий значок в конце строки.
- Авторизоваться на сайте Admitad, перейти в раздел "Инструменты" и выбрать "Код оптимизации".
В открывшемся диалоговом окне нажать на кнопку "Добавить postback URL". Здесь вы можете добавлять и другие ссылки, адаптируя каждую под определенные задачи.
- Перейти на страницу "Добавление нового кода оптимизации", где располагаются несколько выпадающих списков. С их помощью можно фильтровать данные, полученные от системы. В меню "Тип события" укажите один из предложенных вариантов, о котором хотите передавать информацию на postback URL.
- Выбрать площадку из выпадающего списка для получения статистики. Это может быть пункт "Все площадки", но тогда при дальнейшей настройке следует рассортировать действия по параметрам.
- Укажите название партнерской программы, по конверсии которой хотите получать данные. Здесь также можно выбрать пункт "Все программы".
- При использовании какой-то одной партнерской программы появляется новый пункт меню - "Тариф". Если оставить поле пустым, то в систему будет передаваться информация по всем тарифам.
- Если конкретный тариф не был выбран, то следует указать требуемый "Тип действия": Lead, Sale или Все. Вариант "Sale" означает подтвержденные заказы клиентов на сайте интернет-магазинов, а "Lead" - регистрации, подписки, установку приложений и т.п.
- В пункте "Тип запроса" необходимо определиться, каким способом вам будет удобнее получать информацию. Метод "GET" отправляет собранные данные как часть URL, а "POST" - в теле запроса.
- Выделите галочками статусы платежей, о которых хотите получать данные.
- В пустую строку "Ссылка" вставьте PostBack URL, который вы скопировали ранее на нашем ресурсе.
- Выберите из выпадающего списка один из режимов редактирования.
При простом режиме в запрос будет внесен полный набор стандартных параметров, принятых в системе Аdmitad.
Используя расширенный режим, можно самостоятельно формировать список нужных параметров и присваивать им имена, которые вы уже используете в собственной системе.
Если в пункте "Тип запроса" вы выбрали "GET", то в строке "Сгенерированная ссылка" вы увидите URL с выбранными вами параметрами после символа "?".
- Для проверки корректной работы системы нажмите внизу страницы кнопку "Тестировать". В зависимости от того, какой вариант был выбран в пункте "Тип запроса", вы получите следующие результаты:
| GET-запрос | POST-запрос |
- Нажмите на кнопку "Протестировать" и в случае успешного проведения операции появится сообщение: "Запрос на ваш адрес осуществлён". В противном случае вы увидите - "Произошла ошибка во время запроса. Проверьте адрес".
- Как только вы убедитесь, что данные поступают на ваш сервер, закройте окно тестирования и нажмите кнопку "Сохранить".
После этого новый код оптимизации появится у вас в таблице.
Обратите внимание на перечень доступных параметров в Admitad:
| Параметр | Формат значения | Описание |
| {offer_id} | целое число | ID партнёрской программы |
| {offer_name} | строка | Название партнёрской программы |
| {admitad_id} | целое число | Идентификатор платежа |
| {website_name} | строка | Название площадки |
| {website_id} | целое число | ID площадки |
| {subid} | строка | SubID |
| {action} | строка | Название тарифа |
| {subid1} | строка | SubID1 |
| {subid2} | строка | SubID2 |
| {subid3} | строка | SubID3 |
| {subid4} | строка | SubID4 |
| {payment_sum} | дробное число | Сумма заработка |
| {payment_status} | строка, варианты: | Статус платежа |
| new | новый платёж, который еще не был ни подтверждён, ни отклонен | |
| approved | платеж подтвержден | |
| declined | платеж отклонен | |
| pending | подтвержденный платеж снова перешёл в холд | |
| {currency} | строка (макс. длина = 3) | Валюта программы |
| {order_id} | целое число | Номер заказа |
| {order_sum} | дробное число | Сумма заказа |
| {click_time} | Unix-time | Время клика |
| {time} | Unix-time | Время действия |
| {conversion_time} | целое число | Время конверсии (в секундах) |
| {type} | строка, варианты: | Тип действия |
| lead | ||
| sale | ||
| {country_code} | строка | Код страны в формате RU / UA / US |
| {user_agent} | строка | User-Agent |
| {user_referer} | строка | User-Refferer |
| {action_id} | целое число | ID тарифа |
| {offer_status} | строка, варианты: | Новый статус партнёрской программы |
| active | партнёрская программа активна и сотрудничает с вами | |
| denied | программа отклонила ваш запрос на сотрудничество | |
| disabled | программа отключена, но, возможно, снова станет активна | |
| dead | программа закрыта и больше не будет работать в admitad |
Наша система поддерживает только некоторые из них, а именно:
| Параметр | Формат значения | Описание |
| {order_id} | целое число | Номер заказа |
| {subid} | строка | SubID |
| {time} | Unix-time | Время действия |
| {order_sum} | дробное число | Сумма заказа |
| {payment_status} | строка, варианты: | Статус платежа |
| new | новый платёж, который еще не был ни подтверждён, ни отклонен | |
| approved | платеж подтвержден | |
| declined | платеж отклонен | |
| pending | подтвержденный платеж снова перешёл в холд |