Меню

Опыт подключения API Admitad

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

Admitad - это глобальная партнерская сеть с большим выбором партнерских программ, высокими ставками, экспресс-выплатами и множеством инструментов.

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

Для начала мы зарегистрировались на сайте как вэб-мастер, что позволило нам добавлять партнерские программы. 

img

img

Admitad API позволяет нам отправлять запросы на сервер и получать любую (почти) информацию, которая находится на сервере Admitad и связана с нашим аккаунтом. Информация предоставляется в формате JSON и позволяет автоматизировать процессы на нашем сервере. Так, мы можем не только получать самую детальную информацию о каждом целевом действии, но и, например, добавить к каждому магазину на нашей странице лояльности актуальные скидки и купоны, что может повысить конверсию.

Это конечно не самый полный список достоинств. Интеграция по API позволяет реализовать практически любую бизнес-логику, связанную с Admitad, и автоматизировать ее.

Плюсы и минусы интеграции через API:

+ Большое количество доступных методов API.
+ Широкий выбор кастомизации при разработке.
+ Самый надежный канал передачи данных.
+ Возможность регулировать уровень доступа к API.
+ Большая пропускная способность - до 600 запросов в минуту.

- Не работает с товарными фидами.
- Требуются высокие навыки разработки программного обеспечения.


Интеграция по API

Получение ключей API

  • Ключи API находятся в настройках личного кабинета, в закладке "API и приложения". Скриншот: 

img

Авторизация

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

Детальная инструкция находится здесь - https://developers.admitad.com/ru/doc/api_ru/auth/auth-client/

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

{
     "username": "webmaster1",
     "first_name": "name",
     "last_name"': "surname",
     "language": "ru",
     "access_token": "4b8b33955a",
     "token_type": "bearer",
     "expires_in": 604800,
     "refresh_token": "ea957cce42",
     "scope": "advcampaigns banners websites"
}

Где:

  • username - логин веб-мастера в admitad
  • access_token - токен доступа (его и используйте в дальнейших запросах на получение информации от сервера admitad)
  • expires_in - 604800 секунд, это значение всегда статично (7 дней). Это время жизни токена доступа (его можно обновить здесь - https://developers.admitad.com/ru/doc/api_ru/auth/auth-refresh-token/)
  • refresh_token - значение, которое вы используете для обновления времени жизни токена доступа.
  • scope - к каким методам API имеет доступ этот access_token


Описание доступов вы можете найти здесь - https://developers.admitad.com/ru/doc/api_ru/methods/methods-index/

Список всех возможных параметров для scope:

"scope": "public_data websites manage_websites advcampaigns advcampaigns_for_website manage_advcampaigns banners landings arecords banners_for_website payments manage_payments announcements referrals coupons coupons_for_website private_data tickets manage_tickets private_data_email private_data_phone private_data_balance validate_links deeplink_generator statistics opt_codes manage_opt_codes webmaster_retag manage_webmaster_retag broken_links manage_broken_links lost_orders manage_lost_orders broker_application manage_broker_application offline_sales offline_receipts manage_offline_receipts"

Необходимые методы и параметры

Полный, но не окончательный список методов для реализации логики работы вашего cashback-сервиса:

Список тарифов по оплачиваемым действиям: https://developers.admitad.com/ru/doc/api_ru/methods/advcampaigns/advcampaigns-website-list/ параметр: "actions" (необходимо учитывать, что мы вам возвращаем полную сумму вознаграждения партнёрской программы, от которой вы должны вычесть свой заработок и суму возврата cashback показывать пользователю).

Сервис Admidat предоставляет очень много возможностей для сбора статистики, а также для заработка. Ознакомившись со всеми возможностями, мы выбрали именно то API, которое наиболее оптимально могло решить наши задачи.

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

img

img

img


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

img

img

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

В целом, впечатления от работы с API Admitad хорошие, есть полная документация с примерами запросов, а также отзывчивая служба поддержки, которая, в случае, если чего-то нет в документации, с большим удовольствием поможет.


Как правильно создать обменник электронных валют 04.09.2019 Как правильно создать обменник электронных валют
Советы по созданию онлайн-обменника. На что следует обратить особое внимание при создании обменника, удобного для пользователя? Основные требования к коду

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

Возврат к списку