Flutterオファーウォールプラグイン。1つのDart APIでAndroidとiOSに対応。

プラグイン1つでFlutterアプリにMoonetixのオファーウォールを追加できます。AndroidとiOSのネイティブSDKが同梱されているため、GradleやXcodeで追加の設定は必要ありません。

  • 3.27+Flutter
  • 2.0.1現在のバージョン
  • 2プラットフォームに1つのプラグインで対応
Flutter SDKバージョン2.0.1
main.dart
import 'package:moonetix_offerwall/moonetix_offerwall.dart';
 
Moonetix.init('YOUR_APP_ID');
 
// When the user taps Earn
await Moonetix.open(token);

4つのステップで公開

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

  1. プラグインをインストールする

    Moonetixのパッケージリポジトリからプラグインを追加し、flutter pub getを実行します。Androidでは、Mavenリポジトリ、SDK、R8ルールが追加されます。iOSでは、CocoaPodsとSwift Package Manager用のiOS SDKが追加されます。

    pubspec.yaml
    dependencies:
      moonetix_offerwall:
        hosted: https://moonetix.com/pub
        version: ^2.0.1
  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を呼び出します。openの前にMoonetix.eventsをリッスンし、ユーザーがオファーウォールを閉じたら残高を更新してください。

    main.dart
    void main() {
      WidgetsFlutterBinding.ensureInitialized();
      Moonetix.init('YOUR_APP_ID');
      runApp(const MyApp());
    }
     
    Moonetix.events.listen((MoonetixEvent event) {
      switch (event) {
        case MoonetixOpened():
          break;
        case MoonetixClosed():
          refreshBalance();
        case MoonetixErrorEvent(:final MoonetixError error):
          debugPrint('${error.code.name}: ${error.message}');
      }
    });
     
    await 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とiOSのSDKが同梱されています。Gradleリポジトリの追加やXcodeでの手作業は不要です。

  • オファーは適切な場所で開きます

    ストアのオファーはGoogle PlayまたはApp Storeで、それ以外のサイトはブラウザーで開くため、インストールが正しく計測されます。

  • アプリ内にキーを含めない

    アプリが持つのはApp IDだけです。セッションはサーバーから取得し、1回だけ使えます。

  • 型付きイベント

    MoonetixOpened、MoonetixClosed、MoonetixErrorEventのブロードキャストストリーム。コールバックを使いたい場合はリスナーも使えます。

  • 自社のデザイン

    画面にはダッシュボードの「デザイン」タブで設定したタイトルと色が使われます。

  • 広告IDなし

    プラグインは広告識別子を使用せず、アプリをまたいだユーザーのトラッキングも行いません。

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

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

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

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

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

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

  3. テストpostbackを送信

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

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

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

公開前チェックリスト

11項目中0項目が完了

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

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

  • invalidAppId

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

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

  • invalidToken

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

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

  • tokenExpiredOrUsed

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

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

  • notInitialized

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

    対処法main()でMoonetix.initを呼び出してください。

  • unsupported

    アプリがWebまたはデスクトップで実行されているか、プラグインのネイティブ部分がまだビルドに含まれていません。

    対処法AndroidまたはiOSで実行し、アプリを停止して再ビルドしてください。ホットリロードではネイティブコードは追加されません。

  • No events arrive

    アプリがopenを呼び出した後でリッスンを開始しました。

    対処法openを呼び出す前に、破棄されないオブジェクトからMoonetix.eventsをリッスンしてください。

  • 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はリダイレクトをたどりません。

Flutterのよくある質問

Flutter SDKを導入する前に、開発者からよく寄せられる質問。

お困りですか?お問い合わせ

プラグインはどのFlutterバージョンに対応していますか?

Flutter 3.27以降。iOSではXcode 16以降でビルドしてください。

プラグインはpub.devにありますか?

Moonetixのパッケージリポジトリでホストされています。hosted: https://moonetix.com/pubを指定してpubspec.yamlに追加し、flutter pub getを実行してください。ほかのパッケージと同じ手順です。

GradleやXcodeの設定を変更する必要がありますか?

通常は不要です。プラグインにはAndroidとiOSのSDKが同梱されています。android/settings.gradleでプロジェクトのリポジトリがブロックされている場合のみ、そこにMoonetixのMavenリポジトリを追加してください。

ユーザーがオファーウォールを閉じたことはどうすればわかりますか?

openを呼び出す前に、ブロードキャストストリームであるMoonetix.eventsをリッスンしてください。MoonetixClosedは、サーバーからユーザーの残高を読み込むのに適したタイミングです。

報酬はどのように加算されますか?

サーバーで受け取る署名付きpostbackに基づき、トランザクションIDごとに1回加算します。アプリ内のイベントはUI用です。

ストアのプライバシーフォームでは何を申告すればよいですか?

ユーザーID、デバイスID、おおよその位置情報、製品の操作状況。ユーザーに関連付けられ、トラッキングには使用されません。同じデータ種類のGoogle Playでの名称はドキュメントに記載しています。

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

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

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