Android SDK для offerwall. Нативно, в несколько строк на Kotlin.

Открывайте offerwall Moonetix как нативный экран в Android-приложении. Установите одну зависимость Gradle, создайте сессию на сервере и вызовите open. Работает из Kotlin, Java и Jetpack Compose.

  • 5.0+Android, API 21
  • 2.0.1Текущая версия
  • 0Дополнительные разрешения
Android SDKВерсия 2.0.1
EarnActivity.kt
// Once, in your Application class
Moonetix.init(applicationContext, "YOUR_APP_ID")
 
// When the user taps Earn
Moonetix.open(activity, token)

Запуск за четыре шага.

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

  1. Установите SDK

    Добавьте Maven-репозиторий Moonetix и одну зависимость. SDK сам добавляет в манифест разрешение на доступ к интернету и свой экран, а также включает собственные правила R8 и ProGuard.

    settings.gradle.kts
    dependencyResolutionManagement {
        repositories {
            google()
            mavenCentral()
            maven { url = uri("https://moonetix.com/maven") }
        }
    }
     
    // app/build.gradle.kts
    dependencies {
        implementation("com.moonetix:offerwall:2.0.1")
    }
  2. Добавьте на сервер эндпоинт для токенов

    В вашем приложении никогда нет API-ключа. Когда пользователь нажимает Earn, приложение запрашивает сессию у вашего сервера, а ваш сервер запрашивает у Moonetix одноразовый токен для этого авторизованного пользователя. Токен действует один раз в течение 10 минут.

    session.php
    <?php
    // POST /api/moonetix/session: a fresh token for the signed-in user
    $user = current_user();
    if (!$user) {
        http_response_code(401);
        exit;
    }
     
    $key = getenv('MOONETIX_API_KEY');
    $ch  = curl_init('https://api.moonetix.com/v1/session');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query(['user_id' => (string)$user->id]),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 10,
        CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $key],
    ]);
    $data = json_decode((string)curl_exec($ch), true);
    $code = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
     
    header('Content-Type: application/json');
    if ($code === 201 && !empty($data['token'])) {
        echo json_encode(['token' => $data['token']]);
        exit;
    }
    http_response_code($code === 403 ? 403 : 503);
    echo json_encode(['error' => 'offerwall_unavailable']);
  3. Откройте offerwall

    Вызовите init один раз с App ID из личного кабинета, затем откройте offerwall с токеном от вашего сервера. Ошибки никогда не выбрасываются как исключения: они приходят как события, а onClosed - удобный момент, чтобы обновить баланс пользователя.

    EarnActivity.kt
    Moonetix.init(applicationContext, "YOUR_APP_ID")
     
    Moonetix.setListener(object : MoonetixListener {
        override fun onClosed() {
            refreshBalance()
        }
        override fun onError(error: MoonetixError) {
            Log.w("Earn", "${error.code}: ${error.message}")
        }
    })
     
    lifecycleScope.launch {
        val token = fetchMoonetixToken(authToken)
        Moonetix.open(this@EarnActivity, token)
    }
  4. Начисляйте награды через postback

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

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

    Личный кабинет, вкладка "Postback"
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Заработать монеты12,450 монет
ЗаработокMy offers
  • Travel TownДостигните 15 уровня+1,500
  • WPS OfficeУстановка и открытие+2,000
  • Bus EscapeДостигните 20 уровня+450
  • CapCutSign up in the app+800
Награда начисленаTravel Town · +1,500 монет
Нативный экран
Postback 200 OK

Что видят ваши пользователи

Нативный экран поверх вашего приложения: ваш заголовок и цвета, ваша валюта, а каждая награда подтверждается через postback.

Что SDK делает за вас

  • Офферы открываются в нужном месте

    Офферы, ведущие в Google Play, открываются в приложении магазина, а другие сайты открываются в браузере, поэтому установки отслеживаются корректно.

  • Никаких ключей в вашем приложении

    В вашем приложении хранится только App ID. Сессии создаются на вашем сервере и действуют один раз, поэтому никто не сможет открыть offerwall от имени другого пользователя.

  • Защищенный экран

    Внутри загружаются только страницы offerwall, без JavaScript-моста в ваше приложение.

  • Нативная навигация

    Кнопка "Назад" возвращает на предыдущий экран внутри offerwall, а поворот экрана или перезапуск из-за нехватки памяти оставляют пользователя там, где он был.

  • Ваш дизайн без лишнего кода

    Экран использует заголовок и цвета с вкладки "Дизайн" в личном кабинете и подхватывает изменения в течение нескольких минут.

  • Без рекламного идентификатора

    SDK не использует рекламный идентификатор и не отслеживает пользователей между приложениями.

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

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

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

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

  2. Запускайте на реальном устройстве

    Соберите проект для Android или iOS и открывайте offerwall по кнопке Earn, каждый раз с новым токеном.

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

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

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

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

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

0 из 11 готово

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

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

  • INVALID_APP_ID

    Значение, переданное в init, не является App ID. Самая частая ошибка - передать сюда API-ключ.

    РешениеСкопируйте 24-символьный App ID заново на вкладке "Интеграция".

  • INVALID_TOKEN

    Приложение передало что-то кроме токена или токен, созданный с API-ключом другого приложения.

    РешениеПередавайте только поле token, которое начинается с sst_, и используйте App ID и API-ключ одного и того же приложения.

  • TOKEN_EXPIRED_OR_USED

    Токену больше 10 минут или он уже использован, например сохранен после предыдущего нажатия.

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

  • NOT_INITIALIZED

    open был вызван до init.

    РешениеВызовите Moonetix.init в Application.onCreate.

  • UNKNOWN

    Android System WebView отсутствует или отключен, либо переданная вами Activity уже закрывалась.

    РешениеПопросите пользователя обновить Android System WebView и передавайте Activity, которая находится на экране.

  • onClosed never arrives

    Слушатель был очищен в onStop или принадлежал экрану, которого уже нет.

    РешениеЗадавайте его в onCreate и очищайте в onDestroy или задайте один раз в вашем Application.

  • 403 from /v1/session

    app_not_live означает, что приложение приостановлено или ваш аккаунт неактивен. user_blocked означает, что мы заблокировали этого пользователя.

    РешениеНе показывайте offerwall. При app_not_live проверьте уведомления.

  • VPN or Proxy detected

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

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

  • 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-запросы не следуют редиректам.

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

Минимальная версия
Android 5.0 (API 21), с Android System WebView или Chrome
Языки
Kotlin, Java и Jetpack Compose
Пакет
com.moonetix:offerwall:2.0.1 с moonetix.com/maven
Зависимости
Только стандартная библиотека Kotlin
Разрешения
Только интернет, добавляется SDK
Цена
Бесплатно для одобренных паблишеров

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

Вопросы по Android

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

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

Какие версии Android поддерживает Moonetix SDK?

Android 5.0 (API 21) или новее, с Android System WebView или Chrome на устройстве. Единственная зависимость - стандартная библиотека Kotlin, поэтому SDK работает в приложениях на Kotlin и Java.

Нужно ли добавлять правила ProGuard или R8?

Нет. SDK включает собственные правила R8 и ProGuard и сам добавляет в манифест разрешение на доступ к интернету и экран offerwall.

Попадает ли мой API-ключ в приложение?

Нет. В вашем приложении хранится только App ID. Ваш сервер создает сессию с помощью API-ключа и передает токен в приложение. Токен можно использовать один раз в течение 10 минут, поэтому ничто в вашем приложении не может открыть offerwall другого пользователя.

Использует ли SDK рекламный идентификатор?

Нет. Он не использует рекламный идентификатор, не запрашивает никаких разрешений, кроме доступа к интернету, и не отслеживает пользователей между приложениями. В документации указано, что нужно заявить в форме Data safety в Google Play.

Как начислять награды пользователям в моем приложении?

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

Можно ли оформить экран offerwall в стиле моего приложения?

Да. Он использует заголовок и цвета с вкладки "Дизайн" в личном кабинете. Также через MoonetixOptions можно передать собственный заголовок, цвет панели инструментов или скрыть логотип.

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

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

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