React NativeオファーウォールSDK。Expo対応、TypeScript型定義付き。
React NativeやExpoから、Moonetixのオファーウォールをネイティブ画面として開けます。パッケージにはAndroidとiOSのSDKが同梱され、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);4つのステップで公開
コードをコピーし、プレースホルダーをダッシュボードの「オファーウォール」、対象のオファーウォール、「連携」にある値に置き換え、公開前にテストしてください。
-
パッケージをインストールする
@moonetixスコープ用にMoonetixのレジストリを追加し、パッケージをインストールしてアプリを再ビルドします。Expo Goではネイティブコードを読み込めないため、Expoの場合はconfig pluginを追加して開発ビルドを使ってください。
ターミナル# .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に要求します。トークンは1回だけ、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 -
オファーウォールを開く
ダッシュボードのApp IDでinitを1回呼び出し、新しいトークンでopenを呼び出します。addListenerはsubscriptionを返すので、画面が破棄されるときに削除してください。
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ごとに1回だけ報酬を加算し、後の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を実行して再ビルドしてください。
- Expo config plugin
app.jsonに1行追加し、prebuildを実行するかEAS Buildを開始します。
- TypeScriptの型定義
init、open、イベント、エラーコードに型が付いており、ネイティブSDKと同じ名前を使っています。
- オファーは適切な場所で開きます
ストアのオファーはGoogle PlayまたはApp Storeで開くため、インストールが正しく計測されます。
- バンドルにキーを含めない
JavaScriptバンドルに含まれるのはApp IDだけです。セッションはサーバーから取得し、1回だけ使えます。
- 広告IDなし
SDKは広告識別子を使用せず、アプリをまたいだユーザーのトラッキングも行いません。
テストしてから公開しましょう。
実際のユーザーにオファーウォールを公開する前に確認すべきことを、ダッシュボードに組み込まれたツールとともにまとめました。
テストユーザーとして開く
「連携」タブの「連携ステータス」で、ユーザーowner-testとしてオファーウォールを開きます。テストのアクセスはユーザー数に含まれません。
実機で実行してください
AndroidまたはiOS向けにビルドし、毎回新しいトークンを使ってEarnボタンからオファーウォールを開きます。
テストpostbackを送信
ユーザー、ステータス、支払額を選ぶと、サーバーの応答内容をレスポンスコードと応答時間付きで正確に確認できます。テストのトランザクションIDはtest_で始まります。
通常の回線からテストする
VPN、プロキシ、Tor、クラウドネットワークはブロックされるため、オファーが配信されている国で、自宅のWi-Fiまたはモバイルデータ通信でテストしてください。
公開前チェックリスト
11項目中0項目が完了
公開の準備ができました。進捗はこのブラウザーに保存されています。
よくあるエラーをすばやく解決。
React Native SDKの連携中に表示される可能性のあるエラーと、その原因と対処法。
INVALID_APP_IDinitに渡した値がApp IDではありません。ここにAPIキーを渡してしまうのが最もよくある間違いです。
対処法「連携」タブから24文字のApp IDをもう一度コピーしてください。
INVALID_TOKENアプリがトークン以外のものを渡したか、別のアプリのAPIキーで作成したトークンを渡しました。
対処法sst_で始まるtokenフィールドだけを渡し、同じアプリのApp IDとAPIキーを使ってください。
TOKEN_EXPIRED_OR_USEDトークンが作成から10分以上経過しているか、すでに使用されています。たとえば以前のタップで作成したトークンを使い回した場合です。
対処法開くたびに、ユーザーがEarnをタップした時点で新しいトークンを作成してください。
NOT_INITIALIZEDinitの前にopenが呼び出されました。
対処法アプリの起動時にMoonetix.initを1回だけ呼び出してください。
UNSUPPORTED on a phoneネイティブ部分がビルドに含まれていません。たとえばExpo Goの場合や、再ビルドする前の場合です。
対処法アプリを再ビルドするか、Expoの開発ビルドを使ってください。Metroのリロードではネイティブコードは追加されません。
Gradle cannot find com.moonetixsettings.gradleで、プロジェクトによるリポジトリの追加が許可されていません。
対処法settings.gradleにMoonetixのMavenリポジトリを追加してください。
403 from /v1/sessionapp_not_liveは、アプリが一時停止中か、アカウントが有効でないことを意味します。user_blockedは、このユーザーをブロックしたことを意味します。
対処法オファーウォールを表示しないでください。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 302URLがリダイレクトされています(例:httpからhttpsへ)。
対処法最終的なURLを使ってください。postbackはリダイレクトをたどりません。
一致するものがありません。ドキュメントで全リストを見るか、お問い合わせください。
概要
- React Native
- 0.77以降、New Architectureに対応
- Expo
- SDK 53以降(開発ビルドを使用)
- パッケージ
- @moonetix/react-native-offerwall 2.0.1(moonetix.com/npmから配布)
- Android
- Kotlin 2.0以降(これらのバージョンのデフォルト)
- 言語
- TypeScriptとJavaScript
- 料金
- 承認済みパブリッシャーは無料
対応している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を追加し、開発ビルドまたはEAS Buildでテストしてください。
パッケージは公開npmレジストリにありますか?
Moonetixのnpmレジストリにあります。.npmrcに@moonetix:registry=https://moonetix.com/npm/を追加するか、Yarn 2以降ではnpmScopesを設定し、通常どおりインストールしてください。
TypeScriptの型定義は含まれていますか?
はい。init、open、イベント、エラーコードの型定義がパッケージに含まれています。
ユーザーに報酬を付与するには?
サーバーは報酬ごとに署名付きpostbackを受信し、トランザクションIDごとに1回だけユーザーに加算します。アプリのイベントは端末上で偽装できるため、UIの更新にのみ使ってください。
APIキーはどこに置けばよいですか?
サーバー上のみです。アプリが持つのはApp IDだけで、ログイン中のユーザー用の使い捨てセッショントークンはサーバーが作成します。
トラフィックを収益に変えましょう。
無料のパブリッシャーアカウントを作成し、ウェブサイト、アプリ、ゲーム、コミュニティでユーザーが完了したすべてのオファーから収益を得ましょう。