React NativeオファーウォールSDK。Expo対応、TypeScript型定義付き。

React NativeやExpoから、Moonetixのオファーウォールをネイティブ画面として開けます。パッケージにはAndroidとiOSのSDKが同梱され、New Architectureに対応し、TypeScriptの型定義も含まれています。

  • 0.77+React Native
  • 53+Expo SDK
  • TS型定義付き
React Native SDKバージョン2.0.1
EarnScreen.tsx
import { Moonetix } from '@moonetix/react-native-offerwall';
 
Moonetix.init('YOUR_APP_ID');
 
// When the user taps Earn
Moonetix.open(token);

4つのステップで公開

コードをコピーし、プレースホルダーをダッシュボードの「オファーウォール」、対象のオファーウォール、「連携」にある値に置き換え、公開前にテストしてください。

  1. パッケージをインストールする

    @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 install
  2. サーバーにトークンエンドポイントを追加する

    アプリが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']);
  3. オファーウォールを開く

    ダッシュボードのApp IDでinitを1回呼び出し、新しいトークンでopenを呼び出します。addListenerはsubscriptionを返すので、画面が破棄されるときに削除してください。

    EarnScreen.tsx
    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);
    }
  4. postbackで報酬を加算する

    すべての報酬は、署名付きpostbackとしてサーバーに届きます。ハッシュを確認し、トランザクションIDごとに1回だけ報酬を加算し、後の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コイン
EarnMy 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を同梱

    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は広告識別子を使用せず、アプリをまたいだユーザーのトラッキングも行いません。

テストしてから公開しましょう。

実際のユーザーにオファーウォールを公開する前に確認すべきことを、ダッシュボードに組み込まれたツールとともにまとめました。

  1. テストユーザーとして開く

    「連携」タブの「連携ステータス」で、ユーザーowner-testとしてオファーウォールを開きます。テストのアクセスはユーザー数に含まれません。

  2. 実機で実行してください

    AndroidまたはiOS向けにビルドし、毎回新しいトークンを使ってEarnボタンからオファーウォールを開きます。

  3. テストpostbackを送信

    ユーザー、ステータス、支払額を選ぶと、サーバーの応答内容をレスポンスコードと応答時間付きで正確に確認できます。テストのトランザクションIDはtest_で始まります。

  4. 通常の回線からテストする

    VPN、プロキシ、Tor、クラウドネットワークはブロックされるため、オファーが配信されている国で、自宅のWi-Fiまたはモバイルデータ通信でテストしてください。

公開前チェックリスト

11項目中0項目が完了

よくあるエラーをすばやく解決。

React Native SDKの連携中に表示される可能性のあるエラーと、その原因と対処法。

  • INVALID_APP_ID

    initに渡した値がApp IDではありません。ここにAPIキーを渡してしまうのが最もよくある間違いです。

    対処法「連携」タブから24文字のApp IDをもう一度コピーしてください。

  • INVALID_TOKEN

    アプリがトークン以外のものを渡したか、別のアプリのAPIキーで作成したトークンを渡しました。

    対処法sst_で始まるtokenフィールドだけを渡し、同じアプリのApp IDとAPIキーを使ってください。

  • TOKEN_EXPIRED_OR_USED

    トークンが作成から10分以上経過しているか、すでに使用されています。たとえば以前のタップで作成したトークンを使い回した場合です。

    対処法開くたびに、ユーザーがEarnをタップした時点で新しいトークンを作成してください。

  • NOT_INITIALIZED

    initの前にopenが呼び出されました。

    対処法アプリの起動時にMoonetix.initを1回だけ呼び出してください。

  • UNSUPPORTED on a phone

    ネイティブ部分がビルドに含まれていません。たとえばExpo Goの場合や、再ビルドする前の場合です。

    対処法アプリを再ビルドするか、Expoの開発ビルドを使ってください。Metroのリロードではネイティブコードは追加されません。

  • Gradle cannot find com.moonetix

    settings.gradleで、プロジェクトによるリポジトリの追加が許可されていません。

    対処法settings.gradleにMoonetixのMavenリポジトリを追加してください。

  • 403 from /v1/session

    app_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 302

    URLがリダイレクトされています(例:httpからhttpsへ)。

    対処法最終的なURLを使ってください。postbackはリダイレクトをたどりません。

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を追加し、開発ビルドまたは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だけで、ログイン中のユーザー用の使い捨てセッショントークンはサーバーが作成します。

トラフィックを収益に変えましょう。

無料のパブリッシャーアカウントを作成し、ウェブサイト、アプリ、ゲーム、コミュニティでユーザーが完了したすべてのオファーから収益を得ましょう。

世界中をターゲティング
その他
ログイン