React Native SDK для offerwall. Готов к Expo, типы TypeScript в комплекте.
Открывайте offerwall Moonetix как нативный экран из React Native или Expo. Пакет включает SDK для Android и iOS, работает с New Architecture и поставляется с собственными типами TypeScript.
- 0.77+React Native
- 53+Expo SDK
- TSТипы в комплекте
import { Moonetix } from '@moonetix/react-native-offerwall';
Moonetix.init('YOUR_APP_ID');
// When the user taps Earn
Moonetix.open(token);Запуск за четыре шага.
Скопируйте код, замените плейсхолдеры значениями из личного кабинета (Offerwall, ваш offerwall, Интеграция) и протестируйте перед запуском.
-
Установите пакет
Добавьте реестр Moonetix для scope @moonetix, затем установите пакет и пересоберите приложение. Для Expo добавьте config plugin и используйте development build, потому что Expo Go не может загружать нативный код.
Терминал# .npmrc, next to package.json @moonetix:registry=https://moonetix.com/npm/ npm install @moonetix/react-native-offerwall cd ios && pod installapp.json{ "expo": { "plugins": ["@moonetix/react-native-offerwall"] } }.yarnrc.ymlnpmScopes: moonetix: npmRegistryServer: "https://moonetix.com/npm" -
Добавьте на сервер эндпоинт для токенов
В вашем приложении никогда нет 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 с новым токеном. addListener возвращает подписку, поэтому удалите ее, когда экран закрывается.
import { Moonetix } from '@moonetix/react-native-offerwall'; Moonetix.init('YOUR_APP_ID'); useEffect(() => { const closed = Moonetix.addListener('closed', refreshBalance); const failed = Moonetix.addListener('error', (error) => { console.warn(`${error.code}: ${error.message}`); }); return () => { closed.remove(); failed.remove(); }; }, []); async function openOfferwall() { const url = 'https://your-server.example/api/moonetix/session'; const res = await fetch(url, { method: 'POST' }); const { token } = await res.json(); Moonetix.open(token); } -
Начисляйте награды через 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.
Что пакет делает за вас
- Нативные SDK в комплекте
Android Gradle и iOS CocoaPods настраиваются за вас. Выполните pod install и пересоберите приложение.
- Config plugin для Expo
Добавьте одну строку в app.json, затем выполните prebuild или запустите EAS Build.
- Типы TypeScript
Типизированные init, open, события и коды ошибок с теми же именами, что и в нативных SDK.
- Офферы открываются в нужном месте
Офферы из магазинов открываются в Google Play или App Store, поэтому установки отслеживаются корректно.
- Никаких ключей в вашем бандле
В вашем JavaScript-бандле хранится только App ID. Сессии приходят с вашего сервера и действуют один раз.
- Без рекламного идентификатора
SDK не использует рекламный идентификатор и не отслеживает пользователей между приложениями.
Протестируйте, затем запускайте.
Все, что нужно проверить, прежде чем реальные пользователи увидят ваш offerwall, с помощью инструментов, встроенных в личный кабинет.
Открыть как тестовый пользователь
В блоке "Статус интеграции" на вкладке "Интеграция" откройте свой offerwall как пользователь owner-test. Тестовые визиты не учитываются как пользователи.
Запускайте на реальном устройстве
Соберите проект для Android или iOS и открывайте offerwall по кнопке Earn, каждый раз с новым токеном.
Отправить тестовый postback
Выберите пользователя, статус и выплату и посмотрите, что именно ответил ваш сервер, с кодом ответа и временем. ID тестовых транзакций начинаются с test_.
Тестируйте с обычного подключения
VPN, прокси, Tor и облачные сети блокируются, поэтому тестируйте через домашний Wi-Fi или мобильный интернет, в стране, где доступны офферы.
Чек-лист запуска
0 из 11 готово
Все готово к запуску. Ваш прогресс сохраняется в этом браузере.
Частые ошибки и быстрые решения.
Что вы можете увидеть при интеграции React Native 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_INITIALIZEDopen был вызван до init.
РешениеВызовите Moonetix.init один раз при запуске приложения.
UNSUPPORTED on a phoneНативной части нет в сборке, например в Expo Go или до пересборки.
РешениеПересоберите приложение или используйте development build Expo. Перезагрузка Metro не добавляет нативный код.
Gradle cannot find com.moonetixВаш settings.gradle не позволяет проектам добавлять репозитории.
РешениеДобавьте Maven-репозиторий Moonetix в settings.gradle.
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-запросы не следуют редиректам.
Ничего не найдено. Посмотрите полный список в документации или свяжитесь с нами.
Коротко о главном
- React Native
- 0.77 или новее, поддержка New Architecture
- Expo
- SDK 53 или новее, с development build
- Пакет
- @moonetix/react-native-offerwall 2.0.1 с moonetix.com/npm
- Android
- Kotlin 2.0 или новее, по умолчанию в этих версиях
- Язык
- TypeScript и JavaScript
- Цена
- Бесплатно для одобренных паблишеров
Другие интеграции
- СайтСсылка, iframe или плавающая кнопка Earn. SDK не нужен.
- Offers APIПолучайте офферы в JSON и показывайте их в собственном дизайне.
- Android SDKНативный экран offerwall для приложений на Kotlin и Java.
- iOS SDKНативный offerwall для Swift, SwiftUI и Objective-C.
- Unity SDKОфферы с наградами для игр на Android и iOS, прямо из кода на C#.
- Flutter SDKОдин плагин на Dart для Android и iOS.
- Все интеграцииСравните их между собой.
Вопросы по React Native
Что спрашивают разработчики, прежде чем добавить React Native SDK.
Что-то не получается? Свяжитесь с нами
Какие версии React Native и Expo поддерживаются?
React Native 0.77 или новее либо Expo SDK 53 или новее. Пакет работает с New Architecture, а на React Native с 0.77 по 0.81 и со старой архитектурой.
Работает ли он в Expo Go?
Нет. Expo Go не может загружать нативный код, поэтому там Moonetix.isSupported равен false. Добавьте config plugin и тестируйте в development build или EAS Build.
Есть ли пакет в публичном реестре npm?
Он находится в npm-реестре Moonetix. Добавьте @moonetix:registry=https://moonetix.com/npm/ в ваш .npmrc или запись npmScopes для Yarn 2 и новее, затем установите его как обычно.
Включены ли типы TypeScript?
Да. Типы для init, open, событий и кодов ошибок поставляются вместе с пакетом.
Как начислять награды пользователям?
Ваш сервер получает подписанный postback за каждую награду и начисляет ее пользователю один раз на каждый ID транзакции. События приложения на устройстве можно подделать, поэтому используйте их только для обновления интерфейса.
Где должен храниться мой API-ключ?
Только на вашем сервере. В приложении хранится App ID, а ваш сервер создает одноразовый сессионный токен для авторизованного пользователя.
Превратите свой трафик в доход.
Создайте бесплатный аккаунт паблишера и зарабатывайте на каждом оффере, который ваши пользователи выполняют на вашем сайте, в приложении, игре или сообществе.