Unity SDK для offerwall. Игроки зарабатывают вашу внутриигровую валюту.
Позвольте игрокам зарабатывать вашу внутриигровую валюту, выполняя офферы, без баннерной рекламы в игре. Один пакет Unity охватывает Android и iOS, а каждая награда приходит на ваш игровой сервер в виде подписанного postback.
- 2022.3+Unity LTS или Unity 6
- 2.0.1Текущая версия
- 2Платформы, один пакет
using MoonetixOfferwall;
void Awake()
{
Moonetix.Init("YOUR_APP_ID");
}
public void ShowOfferwall(string token)
{
Moonetix.Open(token);
}Запуск за четыре шага.
Скопируйте код, замените плейсхолдеры значениями из личного кабинета (Offerwall, ваш offerwall, Интеграция) и протестируйте перед запуском.
-
Установите пакет
Добавьте scoped registry Moonetix и пакет в Packages/manifest.json или добавьте реестр в Project Settings и установите Moonetix Offerwall из Package Manager. SDK для Android и iOS входят в комплект.
{ "scopedRegistries": [ { "name": "Moonetix", "url": "https://moonetix.com/upm", "scopes": ["com.moonetix"] } ], "dependencies": { "com.moonetix.offerwall": "2.0.1" } } -
Добавьте на сервер эндпоинт для токенов
В вашем приложении никогда нет 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']);session.js// POST /api/moonetix/session: a fresh token for the signed-in user app.post('/api/moonetix/session', requireLogin, async (req, res) => { const r = await fetch('https://api.moonetix.com/v1/session', { method: 'POST', headers: { Authorization: `Bearer ${process.env.MOONETIX_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ user_id: String(req.user.id) }), signal: AbortSignal.timeout(10000), }); const data = await r.json().catch(() => ({})); if (r.status === 201 && data.token) { return res.json({ token: data.token }); } const status = r.status === 403 ? 403 : 503; res.status(status).json({ error: 'offerwall_unavailable' }); });session.py# POST /api/moonetix/session: a fresh token for the signed-in user @app.post("/api/moonetix/session") @login_required def moonetix_session(): key = os.environ["MOONETIX_API_KEY"] r = requests.post( "https://api.moonetix.com/v1/session", data={"user_id": str(current_user.id)}, headers={"Authorization": f"Bearer {key}"}, timeout=10, ) data = r.json() if r.status_code == 201 and data.get("token"): return {"token": data["token"]} status = 403 if r.status_code == 403 else 503 return {"error": "offerwall_unavailable"}, status -
Откройте offerwall
Вызовите Init один раз с App ID из личного кабинета, затем Open с новым токеном. Все события приходят в главном потоке Unity, поэтому вы можете сразу обновлять интерфейс. В пакете также есть пример Offerwall demo.
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() { } } -
Начисляйте награды через postback
Каждая награда приходит на ваш сервер в виде подписанного postback. Проверьте хеш, начислите награду один раз на каждый ID транзакции и спишите ее, если последующий postback ее отменяет. Неудачные postback отправляются повторно до 5 раз.
Личный кабинет, вкладка "Postback"https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}postback.php<?php $tx = $_GET['tx'] ?? ''; $userId = $_GET['user'] ?? ''; $reward = $_GET['reward'] ?? ''; $status = $_GET['status'] ?? ''; $secret = getenv('MOONETIX_POSTBACK_SECRET'); $expected = hash_hmac('sha256', "$tx:$userId:$reward:$status", $secret); if (!hash_equals($expected, $_GET['hash'] ?? '')) { http_response_code(403); exit; } if ($status === '1') { credit_once($userId, $tx, $reward); // once per transaction ID } elseif ($status === '2') { reverse_if_credited($userId, $tx, $reward); } http_response_code(200);postback.jsconst crypto = require('crypto'); app.get('/postback', (req, res) => { const { tx, user, reward, status, hash } = req.query; const secret = process.env.MOONETIX_POSTBACK_SECRET; const expected = crypto.createHmac('sha256', secret) .update(`${tx}:${user}:${reward}:${status}`) .digest('hex'); const valid = typeof hash === 'string' && hash.length === expected.length && crypto.timingSafeEqual(Buffer.from(hash), Buffer.from(expected)); if (!valid) return res.sendStatus(403); if (status === '1') creditOnce(user, tx, reward); // once per transaction ID if (status === '2') reverseIfCredited(user, tx, reward); res.sendStatus(200); });postback.pyimport hmac, hashlib, os from flask import request, abort @app.get("/postback") def postback(): a = request.args parts = [a.get(k, "") for k in ("tx", "user", "reward", "status")] msg = ":".join(parts) secret = os.environ["MOONETIX_POSTBACK_SECRET"].encode() expected = hmac.new(secret, msg.encode(), hashlib.sha256).hexdigest() if not hmac.compare_digest(expected, a.get("hash", "")): abort(403) if a.get("status") == "1": credit_once(a["user"], a["tx"], a["reward"]) # once per transaction ID elif a.get("status") == "2": reverse_if_credited(a["user"], a["tx"], a["reward"]) return "", 200
Travel TownДостигните 15 уровня+1,500
WPS OfficeУстановка и открытие+2,000
Bus EscapeДостигните 20 уровня+450
CapCutSign up in the app+800
Что видят ваши пользователи
Нативный экран поверх вашего приложения: ваш заголовок и цвета, ваша валюта, а каждая награда подтверждается через postback.
Что пакет делает за вас
- Сборки для Android и iOS
На Android он добавляет в ваш Gradle-проект Maven-репозиторий, SDK и правило R8. На iOS он подключает и встраивает iOS SDK в Xcode.
- Офферы открываются в нужном месте
Офферы, ведущие в Google Play или App Store, открываются в приложении магазина, поэтому установки отслеживаются корректно.
- Никаких ключей в вашей игре
В вашей игре хранится только App ID. Сессии приходят с вашего сервера и действуют один раз.
- События в главном потоке
OnOpened, OnClosed и OnError вызываются в главном потоке Unity и готовы для вашего интерфейса.
- Ваша внутриигровая валюта
Награды показываются и начисляются в вашей собственной валюте, по вашему курсу и с вашей долей пользователя.
- Без рекламного идентификатора
SDK не использует рекламный идентификатор и не отслеживает игроков между приложениями.
Протестируйте, затем запускайте.
Все, что нужно проверить, прежде чем реальные пользователи увидят ваш offerwall, с помощью инструментов, встроенных в личный кабинет.
Открыть как тестовый пользователь
В блоке "Статус интеграции" на вкладке "Интеграция" откройте свой offerwall как пользователь owner-test. Тестовые визиты не учитываются как пользователи.
Запускайте на реальном устройстве
Соберите проект для Android или iOS и открывайте offerwall по кнопке Earn, каждый раз с новым токеном.
Отправить тестовый postback
Выберите пользователя, статус и выплату и посмотрите, что именно ответил ваш сервер, с кодом ответа и временем. ID тестовых транзакций начинаются с test_.
Тестируйте с обычного подключения
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.
NotInitializedopen был вызван до init.
РешениеВызовите Moonetix.Init в Awake вашей первой сцены.
UnsupportedИгра запущена в Unity Editor, на десктопе или в WebGL.
РешениеСоберите проект для Android или iOS и проверяйте Moonetix.IsSupported, прежде чем показывать кнопку.
iOS build stops on the iOS versionTarget minimum iOS Version в Player Settings ниже 13.0.
РешениеУстановите значение 13.0 или выше.
403 from /v1/sessionapp_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 2022.3 LTS или Unity 6 (6000.0) и новее
- Платформы
- Android и iOS 13 или новее
- Пакет
- com.moonetix.offerwall 2.0.1 с moonetix.com/upm
- Язык
- C#
- Пример
- Демо offerwall с кнопкой Earn в Package Manager
- Цена
- Бесплатно для одобренных паблишеров
Другие интеграции
- СайтСсылка, iframe или плавающая кнопка Earn. SDK не нужен.
- Offers APIПолучайте офферы в JSON и показывайте их в собственном дизайне.
- Android SDKНативный экран offerwall для приложений на Kotlin и Java.
- iOS SDKНативный offerwall для Swift, SwiftUI и Objective-C.
- Flutter SDKОдин плагин на Dart для Android и iOS.
- React Native SDKДля приложений React Native и Expo, с типами TypeScript.
- Все интеграцииСравните их между собой.
Вопросы по 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.
Превратите свой трафик в доход.
Создайте бесплатный аккаунт паблишера и зарабатывайте на каждом оффере, который ваши пользователи выполняют на вашем сайте, в приложении, игре или сообществе.