Postbackハッシュ確認ツールの使い方
サーバーログからpostback URL全体を貼り付けると、パラメーターが一般的な名前の場合、トランザクションID、ユーザーID、報酬、ステータス、ハッシュが自動で入力されます。それ以外の場合は、4つの値を自分で入力してください。ダッシュボードの「オファーウォール」、対象のオファーウォール、「連携」からpostback secret keyを追加すると、署名される正確な文字列、得られるべきハッシュ、一致するかどうかが表示されます。入力内容がブラウザの外に送信されることはありません。
Postbackハッシュの作り方
string = transaction_id:user_id:reward:status
hash = HMAC-SHA256(string, postback_secret_key), as lowercase hex
4つの値は届いたとおりに使ってください。報酬は末尾のゼロなしで送られます(例:1500、0.5)。postbackのドキュメントに、定数時間比較を使ったPHP、Node.js、Pythonでの確認方法があります。
Postbackハッシュが一致しない理由
- キーが違う。postback secret keyはlink hash saltとは別物です。2つは異なるシークレットです。
- 報酬の書式が変わっている。報酬を数値として解析して出力し直すと、
1500が1500.00や1500.0に変わります。元の文字列をハッシュ化してください。 - 順序または区切り文字が違う。順序はトランザクションID、ユーザーID、報酬、ステータスで、半角コロン1つで連結します。
- エンコード。生のクエリ文字列ではなく、フレームワークが返すURLデコード済みの値を使ってください。
- 大文字の16進数。ハッシュは小文字です。届いたままの形で比較してください。
ハッシュが一致したら、各トランザクションを1回だけ加算してください:重複加算を防ぐ方法。実際の署名付きpostbackを自分宛てに送るには、アプリの「連携」タブで「テストpostbackを送信」を使います。
よくある質問
Moonetixのpostbackハッシュにはどの値が含まれますか?
トランザクションID、ユーザーID、報酬、ステータスをコロンで連結し、postback secret keyを使ってHMAC-SHA256で署名したものです。
取り消しのpostbackも同じ方法で署名されますか?
はい。取り消しはステータスが2で、付与時と同じトランザクションIDを持ち、ハッシュも同じ方法で作成されます。
このツールでは一致するのに、自分のコードでは失敗するのはなぜですか?
コードがハッシュ化の前に値のどれかを変えています。多くの場合、報酬の書式かキーです。コードが署名する正確な文字列を出力し、ここに表示される文字列と比較してください。
secret keyを貼り付けても安全ですか?
このページがキーをどこかに送信することはありませんが、不安な場合はテストアプリを使うか、後でキーを再発行してください。