Admitad - это глобальная партнерская сеть с большим выбором партнерских программ, высокими ставками, экспресс-выплатами и множеством инструментов.
В нашем случае, мы использовали Admitad для подключения кэшбек сервиса к множественным партнерам платформы. Используя эту платформу, мы смогли предоставить возможность пользователям выбирать площадки с наиболее выгодным кэшбэком для себя, выводить деньги за покупки в интернете.
Для начала мы зарегистрировались на сайте как вэб-мастер, что позволило нам добавлять партнерские программы.
.jpg)
Admitad API позволяет нам отправлять запросы на сервер и получать любую (почти) информацию, которая находится на сервере Admitad и связана с нашим аккаунтом. Информация предоставляется в формате JSON и позволяет автоматизировать процессы на нашем сервере. Так, мы можем не только получать самую детальную информацию о каждом целевом действии, но и, например, добавить к каждому магазину на нашей странице лояльности актуальные скидки и купоны, что может повысить конверсию.
Это конечно не самый полный список достоинств. Интеграция по API позволяет реализовать практически любую бизнес-логику, связанную с Admitad, и автоматизировать ее.
Плюсы и минусы интеграции через API:
+ Большое количество доступных методов API.
+ Широкий выбор кастомизации при разработке.
+ Самый надежный канал передачи данных.
+ Возможность регулировать уровень доступа к API.
+ Большая пропускная способность - до 600 запросов в минуту.
- Не работает с товарными фидами.
- Требуются высокие навыки разработки программного обеспечения.
Интеграция по API
Получение ключей API
-
Ключи API находятся в настройках личного кабинета, в закладке "API и приложения". Скриншот:
Авторизация
Для получения доступа к серверу 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/
-
Статистика по действиям:https://developers.admitad.com/ua/doc/api_ru/methods/statistics/statistics-actions/
-
Формирование subid: https://help.admitad.com/ru/topic/82-chto-takoe-subid/
-
Статистика по subid: https://developers.admitad.com/ua/doc/api_ru/methods/statistics/statistics-sub-id/ (Чтобы фиксировать действие вашего пользователя, необходимо передавать его идентификатор в параметр subid перед переходом по реферальной ссылке)
Список тарифов по оплачиваемым действиям: https://developers.admitad.com/ru/doc/api_ru/methods/advcampaigns/advcampaigns-website-list/ параметр: "actions" (необходимо учитывать, что мы вам возвращаем полную сумму вознаграждения партнёрской программы, от которой вы должны вычесть свой заработок и суму возврата cashback показывать пользователю).
Сервис Admidat предоставляет очень много возможностей для сбора статистики, а также для заработка. Ознакомившись со всеми возможностями, мы выбрали именно то API, которое наиболее оптимально могло решить наши задачи.
Далее с помощью этого API мы синхронизировали все площадки, которые добавили в личном кабинете, с записью в БД нашего сервиса, настроили обновление всех кэшбэк программ в автоматическом режиме через Cron, вывели информацию о кэшбэке и краткое описание сервисов, для того чтобы пользователи, исходя из этих данных, смогли выбрать именно тот сервис, который наиболее привлекает их.
Дальше нам пришлось разработать логику возврата средств пользователям на нашем кэшбек сервисе, так как к сожалению admitad не предусматривает разделение этих средств самостоятельно. Для этого пришлось присваивать каждому пользователю уникальный идентификатор при переходе на партнерские программы, с помощью которого мы потом отслеживаем историю покупок пользователей, и уже потом, делая запрос по API, которое предоставляет статистику переходов, покупок, статусов заказов на разных площадках, мы разбирали эту информацию, сначала разделяли по пользователям, а далее работали с каждым пользователем отдельно, проверяя статусы заказов, которые совершал пользователь, и в зависимости от того в каком статусе сейчас заказ, начисляли средства на определённый счет.
Результатом подключения API Admitad стал полноценный кэшбэк сервис с максимально удобным и понятным для пользователей интерфейсом, простотой использования и возможностью возвращать свои деньги, покупая товары в интернете.
В целом, впечатления от работы с API Admitad хорошие, есть полная документация с примерами запросов, а также отзывчивая служба поддержки, которая, в случае, если чего-то нет в документации, с большим удовольствием поможет.
