オファーウォールリンク作成ツールの使い方
ダッシュボードの「オファーウォール」、対象のオファーウォール、「連携」の順に開き、App IDとlink hash saltをコピーします。テストアカウントのユーザーIDを入力し、広告枠を計測している場合はsub IDを追加すると、ハッシュ、署名付きリンク全体、そのまま貼り付けられるiframeとEarnボタンのコードが表示されます。入力内容はどこにも送信されません。ハッシュはWeb Crypto APIを使ってブラウザ内で計算されます。
自分のサーバーコードの確認に使ってください。同じユーザーIDでサーバーが作成したリンクがここのリンクと一致しない場合、違いはMoonetixではなくあなたのコードにあります。
ハッシュの作り方
hash = HMAC-SHA256(user_id, link_hash_salt), as lowercase hex
link = https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH
ユーザーIDがメッセージ、saltがキーです。sub IDはハッシュに含まれないため、ユーザーが変更できます。計測には使い、付与には絶対に使わないでください。オファーウォールリンクのドキュメントに、PHP、Node.js、Pythonでの同じコードがあります。
saltはサーバーに保管しましょう
このページはテスト用のツールです。本番環境では、ハッシュはサーバーで生成し、完成したリンクだけをブラウザーやアプリに送ってください。JavaScript、アプリのバンドル、公開リポジトリにsaltがあると、誰でも任意のユーザーとしてオファーウォールを開けてしまいます。saltが漏えいした場合はローテーションしてください。安全な手順はキーとlink saltのローテーション方法で解説しています。
よくある問題
- Link not valid (403)。ハッシュがユーザーIDと一致していません。リンクに入れたものとまったく同じユーザーID文字列を、postback secret keyではなくlink hash saltでハッシュ化しているか確認してください。
- 数値と文字列。ユーザーIDは文字列としてハッシュ化してください。
42と042は別のユーザーです。 - エンコード。元のユーザーIDをハッシュ化してから、リンク内でURLエンコードします。エンコード後の値をハッシュ化しないでください。
よくある質問
ここにlink hash saltを入力しても安全ですか?
このページがsaltをどこかに送信することはありませんが、テストアプリやテスト用のsaltを使うほうが良い習慣です。本物のsaltをクライアント側のコードに入れないでください。
Moonetixオファーウォールリンクはどのハッシュを使っていますか?
link hash saltをキーとしたユーザーIDのHMAC-SHA256を、小文字の16進数で表したものです。
sub IDはハッシュに影響しますか?
いいえ。sub IDはハッシュに含まれないため、ハッシュを作り直さずに追加や変更ができます。
このリンクはモバイルアプリで使えますか?
はい。バックエンドで作成すれば、WebViewやシステムブラウザで使えます。ネイティブ画面には、代わりにセッショントークンを使ってAndroid、iOS、Unity、Flutter、React NativeのSDKを利用してください。