AdMate の通知と RevenueCat の Webhook を設定する方法

AdMate の通知は RevenueCat のイベントに文脈を加えられますが、通知の経路はダッシュボードの接続とは別物です。アプリはユーザーが設定した認証情報でプロジェクトを取得し、AdMate API は設定済みの Webhook を受け取って、一時的なデバイスのコンテキストを使い適切な通知を作成します。

これらの役割を分けておくことが、安全性とトラブルシューティングの両面で欠かせません。

AdMate

すべての収益を1つのダッシュボードで

複数のアカウントのAdMob、AdSense、RevenueCat、App Store Connectをアプリ、プラットフォーム、国別のフィルターで確認

iPhone、iPad、Mac、Apple Watchで収益、クリック、eCPM、サブスクリプション、インストール、支払いを監視

2 つの設定と 2 つの目的

ダッシュボードの接続

AdMate に登録した RevenueCat のアカウントにより、アプリは設定済みの認可で参照できるプロジェクトと指標を読み取れます。

Webhook の配信

RevenueCat は、AdMate API の Webhook エンドポイントにイベントを送信します。API は、プロジェクト、アプリ、言語、通貨などの登録済みのデバイスのコンテキストを使って、対応する通知を準備します。

ダッシュボードにキーを追加しても、プロバイダー側に Webhook が自動で作成されるわけではありません。Webhook を作成しても、アプリのダッシュボードが認可されるわけでもありません。

アプリのコンテキストを準備する

AdMate で RevenueCat のアカウントを接続して検証する
対象のプロジェクトとアプリを選ぶ
アプリが用意している Webhook または通知の設定を開く
手順で求められるデバイスのコンテキストを同期する
言語、通貨、プロジェクト名を確認する
OS の設定で通知を許可する

API のコンテキストには有効期限があり、アプリの対応する手順で更新する必要があります。恒久的な財務データベースではありません。

RevenueCat を設定する

RevenueCat の Webhook 設定で、AdMate の手順に表示されるエンドポイントと認可情報を追加します。別の環境から認証情報をコピーするのではなく、アプリ内の最新の手順に従ってください。

可能であれば、機密情報を含まないイベントでテストしましょう。秘密鍵や Webhook の認可情報の全体を、スクリーンショット、リポジトリ、公開のサポートスレッドに載せないでください。

エンドツーエンドで確認する

経路全体を確認します。

RevenueCat が Webhook の設定を受け付ける
対応するイベントが正常に配信される
AdMate API がデバイスとプロジェクトのコンテキストを特定できる
プラットフォームのサービスがプッシュの配信を受け付ける
デバイスが登録されたままで、通知を許可している
表示されるプロジェクト、アプリ、言語、通貨が正しい

ダッシュボードの更新に成功しても、確認できるのは別の経路だけです。

トラブルシューティング

RevenueCat が Webhook のエラーを報告する

RevenueCat で、エンドポイント、認可、レスポンスのステータスを確認してください。関係のないダッシュボードのキーを変更しないでください。

Webhook は成功するのに通知が届かない

デバイスのコンテキスト、プッシュ通知の許可、登録状態、そのイベントの種類に対応しているかを確認します。デバイスのコンテキストは、しばらく使わないと期限切れになることがあります。

通知に誤ったプロジェクト名が表示される

正しいプロジェクトからコンテキストを更新し、2 つのアカウントが同じ表示名に割り当てられていないか確認してください。

ある端末では届き、別の端末では届かない

デバイスごとに登録とコンテキストがあります。問題のある端末で、権限とコンテキストを確認してください。

セキュリティのルール

Webhook の認可情報とプロバイダーのキーを Git に含めない
顧客やトランザクションの識別子を含むペイロード全体をログに残さない
Webhook API を収益データの保管場所として使わない
漏えいした認可情報はすぐに変更する
イベントを受け取る必要がなくなったデバイスのコンテキストは削除する

よくある質問

AdMate は RevenueCat の履歴をすべてサーバーに保存しますか？

いいえ。API が処理するのは Webhook のイベントと一時的なデバイスやプロジェクトのコンテキストで、アプリは設定済みのサービスに直接問い合わせます。

ダッシュボードのアカウントと Webhook の両方が必要なのはなぜですか？

インタラクティブなレポートと、サーバーから配信されるイベント通知という、別々の経路を担っているためです。

Webhook でダッシュボードの指標が足りない問題を直せますか？

いいえ。アプリの RevenueCat の認可とプロジェクトの割り当てを確認してください。

安全なサポート報告には何を含めるべきですか？

イベントの種類、おおよその時刻、伏せ字にしたステータス、デバイスとアプリのコンテキストです。秘密鍵や顧客の識別子全体は決して含めないでください。