あらゆるウェブサイトにオファーウォールを。リンク、iframe、ボタンで。
署名付きリンク、iframe、フローティングボタンで、WordPressから独自開発のアプリまで、あらゆるウェブサイトにMoonetixのオファーウォールを設置できます。ユーザーは自社の通貨を獲得し、すべての報酬は署名付きpostbackとしてサーバーに届きます。
- 3表示方法
- 0インストールが必要なSDK
- HTTPSどんなサイト、どんな技術スタックでも
<iframe title="Offerwall"
src="https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH"
style="border:0;width:100%;height:100vh"></iframe>3つのステップで公開
コードをコピーし、プレースホルダーをダッシュボードの「オファーウォール」、対象のオファーウォール、「連携」にある値に置き換え、公開前にテストしてください。
-
サーバーで署名付きリンクを生成する
すべてのリンクには、ログイン中のユーザーのIDと、link hash saltで作成したHMAC-SHA256ハッシュが含まれます。このハッシュにより、ユーザーIDを書き換えて他人としてオファーウォールを開くことはできません。リンクは必ずサーバーで生成し、saltをページに含めないでください。
offerwall.php<?php // Build the link on your server, for the signed-in user $hash = hash_hmac('sha256', $userId, $linkHashSalt); $url = 'https://wall.moonetix.com/' . $appId . '?user_id=' . rawurlencode($userId) . '&hash=' . $hash;offerwall.js// Build the link on your server, for the signed-in user const crypto = require('crypto'); const hash = crypto.createHmac('sha256', linkHashSalt) .update(String(userId)) .digest('hex'); const url = `https://wall.moonetix.com/${appId}` + `?user_id=${encodeURIComponent(userId)}&hash=${hash}`;offerwall.py# Build the link on your server, for the signed-in user import hmac, hashlib from urllib.parse import quote uid = str(user_id) hash = hmac.new(link_hash_salt.encode(), uid.encode(), hashlib.sha256).hexdigest() url = f"https://wall.moonetix.com/{app_id}?user_id={quote(uid)}&hash={hash}" -
サイトに合った方法で表示
メニューからリンクを開く、専用ページに埋め込む、すべてのページにフローティングボタンを追加する、のいずれかを選べます。複数を同時に使うこともでき、どれも同じ報酬とpostbackを共有します。
earn.html<iframe title="Offerwall" src="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" style="border:0;width:100%;height:100vh"></iframe>layout.html<script src="https://wall.moonetix.com/embed.js" async data-button-url="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" data-button-text="Earn rewards" data-button-color="#004ABB" data-button-position="right"></script>menu.html<a href="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" data-moonetix-open>Earn rewards</a> <script src="https://wall.moonetix.com/embed.js" async></script>リンクhttps://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
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
自社のページにそのまま
フローティングボタンはオファーウォールをポップアップで開くため、ユーザーは今いるページを離れずに済みます。
オファーウォールが代わりに行うこと
- オファーウォール専用ページ
EarnタブとMy offersタブ、検索、カテゴリー、並べ替えに対応し、ユーザーごとの国とデバイスに合ったオファーを表示します。
- 自社の通貨
すべての報酬は、自社の通貨名とアイコンで表示され、換算レートとユーザーへの配分に基づいて計算されます。
- 自社のブランド
色、角の丸み、余白、文字サイズ、通貨アイコンはダッシュボードで設定でき、コードは不要です。
- 署名付きリンク
「リンクのセキュリティ」は初期設定で有効なので、誰もユーザーになりすましてオファーウォールを開くことはできません。
- Sub ID
ページやキャンペーンなど独自の値を最大5つまで追加でき、すべてのpostbackとレポートでその値が返されます。
- ユーザーサポート
ユーザーはMy offersでオファーの進捗を確認でき、届かない報酬もオファーから直接報告できます。
テストしてから公開しましょう。
実際のユーザーにオファーウォールを公開する前に確認すべきことを、ダッシュボードに組み込まれたツールとともにまとめました。
テストユーザーとして開く
「連携」タブの「連携ステータス」で、ユーザーowner-testとしてオファーウォールを開きます。テストのアクセスはユーザー数に含まれません。
リンクをチェック
サイトで生成したリンクを貼り付けるか、ユーザーIDを入力すると、サーバーが生成すべき正確なリンクが表示されます。2つは完全に一致している必要があります。
テストpostbackを送信
ユーザー、ステータス、支払額を選ぶと、サーバーの応答内容をレスポンスコードと応答時間付きで正確に確認できます。テストのトランザクションIDはtest_で始まります。
通常の回線からテストする
VPN、プロキシ、Tor、クラウドネットワークはブロックされるため、オファーが配信されている国で、自宅のWi-Fiまたはモバイルデータ通信でテストしてください。
公開前チェックリスト
11項目中0項目が完了
公開の準備ができました。進捗はこのブラウザーに保存されています。
よくあるエラーをすばやく解決。
ウェブサイトの連携中に表示される可能性のあるエラーと、その原因と対処法。
Link not validハッシュがリンク内のユーザーIDと一致しません。
対処法ユーザーIDをそのまま、postback secret keyではなくlink hash saltで署名し、小文字の16進数で出力してください。
Missing user IDユーザーIDが空か、使用できない文字が含まれています。
対処法A-Z a-z 0-9 . _ @ : + - の1〜100文字を使い、URLエンコードしてください。
Blank iframe or pop-upページがアプリに登録したウェブサイト上にないか、httpsではありません。
対処法そのドメインまたはサブドメインのhttpsページに埋め込んでください。別のサイトには新しいアプリを追加してください。
No floating buttondata-button-urlがないか、オファーウォールのリンクではありません。
対処法https://wall.moonetix.com/で始まる署名付きリンクを、省略せずにそのまま使ってください。
VPN or Proxy detectedVPN、プロキシ、またはクラウドネットワーク経由でテストしています。
対処法通常の自宅回線またはモバイル回線からテストしてください。
Fewer offers than expected一部のオファーを非表示にしたか、その国やデバイスで配信されているオファーが少ない状態です。
対処法ダッシュボードで「オファー」を開き、「ステータス」を「非表示」に設定してください。オファーを戻すには「表示」をクリックします。
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はリダイレクトをたどりません。
一致するものがありません。ドキュメントで全リストを見るか、お問い合わせください。
概要
- 対応環境
- あらゆるhttpsウェブサイト:WordPress、Next.js、Laravel、プレーンなHTMLなど
- 表示方法
- リンク、iframe、フローティングボタン、または独自のボタン
- 埋め込みのルール
- フレームとポップアップは、登録したウェブサイトとそのサブドメインで読み込まれます
- スクリプトのサイズ
- ボタンとポップアップ専用の小さなスクリプト1つ
- 報酬
- 署名付きのサーバー間postback(最大5回まで再送)
- 料金
- 承認済みパブリッシャーは無料
その他の連携方法
ウェブサイトにオファーウォールを追加するには、何かをインストールする必要がありますか?
いいえ。オファーウォールはMoonetix上で動作します。サイトに署名付きリンクを追加するか、iframeで埋め込むか、フローティングボタン用の小さなスクリプトを1つ読み込むだけです。サーバーが行うのはリンクの生成とpostbackの受信だけです。
WordPressで使えますか?
はい。PHPの例を使って小さなプラグインまたはテーマで署名付きリンクを生成し、Earnページに埋め込むか、フローティングボタンを追加します。AcademyにはWordPress向けのステップごとのガイドがあります。
リンクにハッシュが必要なのはなぜですか?
ハッシュは、link hash saltを使って作成したユーザーIDのHMAC-SHA256です。そのユーザーのためにサーバーがリンクを作成したことを証明するため、アドレスバーでユーザーIDを書き換えて他人として報酬を得ることはできません。
iframeでオファーウォールが読み込まれないのはなぜですか?
安全のため、フレームとポップアップは、アプリに登録したウェブサイトとそのサブドメインのhttpsページでのみ読み込まれます。リンクをタブや新しいウィンドウ、モバイルのWebViewで直接開く場合は、どこでも動作します。
ユーザーはどのように報酬を受け取りますか?
Moonetixは、報酬が発生するたびに署名付きpostbackをサーバーに送信します。サーバーはハッシュを確認し、自社の通貨でユーザーに加算します。後から取り消しがあった場合は同じトランザクションIDで届くため、報酬を差し戻せます。
表示するオファーを選べますか?
はい。ダッシュボードの「オファー」ページで任意のオファーを非表示にでき、そのアプリのオファーウォールのリンクと埋め込み、フローティングボタン、Offers APIのすべてから表示されなくなります。
トラフィックを収益に変えましょう。
無料のパブリッシャーアカウントを作成し、ウェブサイト、アプリ、ゲーム、コミュニティでユーザーが完了したすべてのオファーから収益を得ましょう。