Offers API. Ваш дизайн, наши офферы.

Получайте офферы для каждого пользователя в JSON, с изображениями, шагами и наградами уже в вашей валюте, и показывайте их в собственных карточках рядом с вашим контентом. Награды приходят через postback, так же как с offerwall.

  • JSONREST через HTTPS
  • 600Запросов в минуту
  • OpenAPIСпецификация в комплекте
Offers APIREST, JSON
Терминал
curl -G "https://api.moonetix.com/v1/offers" \
  -d user_id=user_1234 -d country=US -d device=android \
  -H "Authorization: Bearer $MOONETIX_API_KEY"

Запуск за три шага.

Скопируйте код, замените плейсхолдеры значениями из личного кабинета (Offerwall, ваш offerwall, Интеграция) и протестируйте перед запуском.

  1. Запросите офферы для одного пользователя

    Вызывайте API со своего сервера с API-ключом вашего приложения, ID пользователя, страной, в которой находится пользователь, и его устройством или user agent. В список не попадают офферы, которые пользователь уже выполнил или пока не может выполнить снова.

    Терминал
    curl -G "https://api.moonetix.com/v1/offers" \
      -d user_id=user_1234 -d country=US -d device=android \
      -H "Authorization: Bearer $MOONETIX_API_KEY"
  2. Показывайте их в собственном дизайне

    Каждый оффер приходит с названием, изображением, шагами и наградой в вашей валюте. Отображайте их как угодно, а когда пользователь выберет оффер, отправьте его на start_url этого оффера. Страница оффера открывается на Moonetix и уже оттуда ведет к рекламодателю.

    JSON
    {
      "ok": true,
      "currency": "Coins",
      "offers": [
        {
          "id": 58,
          "title": "Nova Quest: reach level 10",
          "reward": 975,
          "payout_usd": 1.5,
          "start_url": "https://wall.moonetix.com/..."
        }
      ]
    }
  3. Начисляйте награды через postback

    Каждая награда приходит на ваш сервер в виде подписанного postback. Проверьте хеш, начислите награду один раз на каждый ID транзакции и спишите ее, если последующий postback ее отменяет. Неудачные postback отправляются повторно до 5 раз.

    Макросы postback и повторные попытки

    Личный кабинет, вкладка "Postback"
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
GET /v1/offers
{
  "title": "Nova Quest: reach level 10",
  "goals": [
    { "name": "Create an account", "reward": 325 },
    { "name": "Reach level 10", "reward": 650 }
  ],
  "reward": 975,
  "start_url": "https://wall.moonetix.com/..."
}
Ваш дизайн
Nova QuestДостигните 10 уровня
  1. Создать аккаунт+325
  2. Достигните 10 уровня+650
Всего975 монетНачать оффер

От JSON к вашему дизайну

Каждый оффер приходит готовым к отображению, с шагами и наградами уже в вашей валюте.

Что дает вам API

  • Офферы на пользователя

    Офферы подбираются под страну и устройство, которые вы передаете, а те, что пользователь уже выполнил, исключаются.

  • Награды в вашей валюте

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

  • Шаги и изображения

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

  • Sub ID

    Передавайте до пяти собственных значений. Они добавляются к каждому start_url и возвращаются в postback.

  • Скрытые офферы остаются скрытыми

    Офферы, которые вы скрываете на странице "Офферы", исключаются и из API, поэтому он совпадает с вашим offerwall.

  • Спецификация OpenAPI

    Машиночитаемый файл openapi.json описывает каждое поле и готов для генераторов кода и ИИ-агентов для программирования.

Протестируйте, затем запускайте.

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

  1. Открыть как тестовый пользователь

    В блоке "Статус интеграции" на вкладке "Интеграция" откройте свой offerwall как пользователь owner-test. Тестовые визиты не учитываются как пользователи.

  2. Вызов API через curl

    Запросите список для тестового ID пользователя и страны, где доступны офферы, и откройте один start_url в браузере.

  3. Отправить тестовый postback

    Выберите пользователя, статус и выплату и посмотрите, что именно ответил ваш сервер, с кодом ответа и временем. ID тестовых транзакций начинаются с test_.

  4. Тестируйте с обычного подключения

    VPN, прокси, Tor и облачные сети блокируются, поэтому тестируйте через домашний Wi-Fi или мобильный интернет, в стране, где доступны офферы.

Чек-лист запуска

0 из 10 готово

Частые ошибки и быстрые решения.

Что вы можете увидеть при интеграции Offers API, в чем причина и как это исправить.

  • 400 invalid_country

    Параметр отсутствует или неверен: invalid_user_id, invalid_country или invalid_device.

    РешениеИсправьте параметр, указанный в коде ошибки.

  • 401 invalid_api_key

    Ключ отсутствует, неверен или был заменен.

    РешениеОтправляйте его в заголовке Authorization как Bearer и скопируйте его заново на вкладке "Интеграция".

  • 403 app_not_live

    Приложение приостановлено, или ваш аккаунт не одобрен или неактивен.

    РешениеПроверьте уведомления. При user_blocked не показывайте этому пользователю офферы.

  • 429 rate_limited

    Более 600 запросов в минуту для этого приложения.

    РешениеПодождите указанное в Retry-After число секунд и кешируйте список каждого пользователя на 1-5 минут.

  • Empty offers list

    Это нормальный ответ: для этого пользователя сейчас ничего нет.

    РешениеПокажите понятное пустое состояние и проверьте страну и устройство, которые вы передаете.

  • VPN detected on start_url

    Пользователь подключен через VPN, прокси или облачную сеть, когда открывается страница оффера.

    РешениеПопросите пользователя отключить его. Запросы к API с вашего сервера не проверяются.

  • Postback log shows 403 or 404

    Ваш скрипт отклонил postback, или URL неверен.

    РешениеОткройте URL из лога в браузере и проверьте код, который вычисляет хеш.

  • Postback log shows a timeout

    Ваш скрипт отвечает дольше 6 секунд.

    РешениеСначала отвечайте кодом 200, а медленную работу выполняйте в фоне.

  • Postback log shows 301 or 302

    Ваш URL выполняет редирект, например с http на https.

    РешениеИспользуйте конечный URL. Postback-запросы не следуют редиректам.

Коротко о главном

Эндпоинт
GET https://api.moonetix.com/v1/offers
Аутентификация
API-ключ Bearer, по одному на приложение, только на сервере
Обязательные параметры
user_id, country и device или ua
Ограничение запросов
До 600 запросов в минуту для каждого приложения
Формат
JSON с описанием OpenAPI
Цена
Бесплатно для одобренных паблишеров

Другие интеграции

Вопросы об Offers API

Что спрашивают разработчики, прежде чем подключить Offers API.

Что-то не получается? Свяжитесь с нами

Когда стоит использовать Offers API вместо offerwall?

Используйте ссылку на offerwall, чтобы запуститься быстрее всего. Используйте Offers API, если хотите разместить офферы внутри своего сайта или приложения в собственном дизайне, например рядом с офферами из других источников или в своем магазине наград.

Можно ли вызывать Offers API из браузера или мобильного приложения?

Нет. Вызывайте его только со своего сервера, потому что запрос содержит ваш API-ключ. Если ключ когда-нибудь утечет, создайте новый на вкладке "Интеграция", и старый сразу перестанет работать.

Какую страну передавать?

Страна, в которой пользователь действительно находится, в виде двухбуквенного кода, например US. От нее зависят офферы и награды, а страна и устройство проверяются повторно, когда пользователь начинает оффер.

Отличаются ли награды от наград в offerwall?

Нет. API возвращает те же офферы, что и ваш offerwall, с теми же наградами, а каждый выполненный шаг приходит на ваш сервер через тот же подписанный postback.

Есть ли ограничение на число запросов?

Да, до 600 запросов в минуту для каждого приложения. Если вы часто показываете список, кешируйте его ненадолго для каждого пользователя.

Подходит ли этот ключ для чего-то еще?

Да. API-ключ приложения также работает для Reporting API и для сессий мобильных SDK.

Превратите свой трафик в доход.

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

Таргетинг по всему миру
Еще
Войти