Unity SDK для offerwall. Игроки зарабатывают вашу внутриигровую валюту.

Позвольте игрокам зарабатывать вашу внутриигровую валюту, выполняя офферы, без баннерной рекламы в игре. Один пакет Unity охватывает Android и iOS, а каждая награда приходит на ваш игровой сервер в виде подписанного postback.

  • 2022.3+Unity LTS или Unity 6
  • 2.0.1Текущая версия
  • 2Платформы, один пакет
Unity SDKВерсия 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    Moonetix.Open(token);
}

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

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

  1. Установите пакет

    Добавьте scoped registry Moonetix и пакет в Packages/manifest.json или добавьте реестр в Project Settings и установите Moonetix Offerwall из Package Manager. SDK для Android и iOS входят в комплект.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "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 из личного кабинета, затем Open с новым токеном. Все события приходят в главном потоке Unity, поэтому вы можете сразу обновлять интерфейс. В пакете также есть пример Offerwall demo.

    EarnButton.cs
    using MoonetixOfferwall;
    using UnityEngine;
     
    public class EarnButton : MonoBehaviour
    {
        void Awake() => Moonetix.Init("YOUR_APP_ID");
     
        void OnEnable()
        {
            Moonetix.OnClosed += RefreshBalance;
            Moonetix.OnError += HandleError;
        }
     
        void OnDisable()
        {
            Moonetix.OnClosed -= RefreshBalance;
            Moonetix.OnError -= HandleError;
        }
     
        public void ShowOfferwall(string token) => Moonetix.Open(token);
     
        void HandleError(MoonetixError error)
        {
            Debug.LogWarning(error.CodeName + ": " + error.Message);
        }
     
        void RefreshBalance() { }
    }
  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.

Что пакет делает за вас

  • Сборки для Android и iOS

    На Android он добавляет в ваш Gradle-проект Maven-репозиторий, SDK и правило R8. На iOS он подключает и встраивает iOS SDK в Xcode.

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

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

  • Никаких ключей в вашей игре

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

  • События в главном потоке

    OnOpened, OnClosed и OnError вызываются в главном потоке Unity и готовы для вашего интерфейса.

  • Ваша внутриигровая валюта

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

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

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

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

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

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

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

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

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

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

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

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

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

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

0 из 11 готово

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

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

  • InvalidAppId

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

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

  • InvalidToken

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

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

  • TokenExpiredOrUsed

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

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

  • NotInitialized

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

    РешениеВызовите Moonetix.Init в Awake вашей первой сцены.

  • Unsupported

    Игра запущена в Unity Editor, на десктопе или в WebGL.

    РешениеСоберите проект для Android или iOS и проверяйте Moonetix.IsSupported, прежде чем показывать кнопку.

  • iOS build stops on the iOS version

    Target minimum iOS Version в Player Settings ниже 13.0.

    РешениеУстановите значение 13.0 или выше.

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

Вопросы по Unity

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

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

Какие версии Unity поддерживаются?

Unity 2022.3 LTS или Unity 6 (6000.0) и новее. Для iOS установите в Player Settings минимальную версию iOS 13.0 или выше.

Работает ли он в сборках для Android и iOS?

Да. Один пакет охватывает обе платформы. Unity сам добавляет Android SDK в Gradle-проект и iOS SDK в Xcode-проект, включая экспортированные проекты и собственные шаблоны Gradle.

Как установить пакет Moonetix для Unity?

Добавьте scoped registry Moonetix и com.moonetix.offerwall в Packages/manifest.json или установите пакет из My Registries в Package Manager. Также его можно установить из tarball-архива.

Не превращает ли offerwall игру в pay-to-win?

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

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

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

Можно ли протестировать его в Unity Editor?

Вы можете протестировать свой сценарий. В Editor, на десктопе и в WebGL метод Open проверяет App ID и токен, а затем сообщает Unsupported, и Moonetix.IsSupported равен false. Чтобы увидеть сам offerwall, соберите проект для Android или iOS и протестируйте на телефоне или в iOS Simulator.

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

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

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