RevenueCat を AdMate に接続する方法

RevenueCat を接続すると、AdMate で広告やストアのレポートと並べて、サブスクリプションに特化したビューを使えるようになります。AdMate の API をサーバー側の収益保管場所にすることなく、RevenueCat が提供するプロジェクト、取引、指標を表示できます。

RevenueCat の認証情報には強い権限があります。接続の準備は慎重に行い、現在の AdMate のバージョンが提供する認可方式を使ってください。シークレットキーを公開の問題報告やスクリーンショットに貼り付けないでください。

AdMate

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

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

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

適切な RevenueCat のアクセス方法を選ぶ

AdMate は RevenueCat アカウントの設定と複数プロジェクトに対応しています。現在のアカウントとバージョンによって、認証情報の画面ではプロジェクトのシークレットキーを含むサポート対象の API v2 認可を使ったり、アカウント単位の認可フローを利用できたりします。

必要なデータを読める範囲で、最も権限の小さい認証情報を使ってください。アプリに組み込むための公開 SDK キーは、シークレットの API 認証情報の代わりにはなりません。また、1 つのプロジェクトの認証情報で組織内のすべてのプロジェクトを一覧できるとは限りません。

設定の前に、次の点を確認します。

必要な RevenueCat の組織とプロジェクトを特定する
1 つのプロジェクトのキーを追加するのか、アカウント単位の接続を追加するのかを確認する
不要になった古いキーを削除する
AdMate でのアカウントのわかりやすい別名を決める

RevenueCat アカウントを追加する

AdMate で設定を開き、アカウント管理に移動します。
RevenueCat を見つけ、アカウントの追加を選びます。
現在のアプリに表示される認可方式を選択します。
求められた認証情報を、文字を変更せずに入力または認可します。
AdMate がアカウントを検証し、アクセス可能なプロジェクトを取得するのを待ちます。
複数の組織やクライアントを扱う場合は、接続にわかりやすい名前を付けます。
RevenueCat の概要を開き、目的のプロジェクトと期間を確認します。

複数のプロジェクトのシークレットキーを使う場合は、それぞれを正しいプロジェクトに対応付けてください。すべての項目を単に「RevenueCat」と名付けないでください。内容がわかる別名を付ければ、クライアント間で誤って比較することを防げます。

接続後に確認すること

合計を見る前に、まず対象を確認します。

アカウントまたは組織の名前
プロジェクト名とプロジェクト ID
含まれるアプリとストア
選択した期間と通貨
表示中の指標に返金や減額調整が含まれているかどうか

次に、締め済みの期間を RevenueCat のダッシュボードと比べます。小さな差は、更新のタイミング、通貨のルール、指標の定義によって生じることがあります。プロジェクトがまったく表示されない場合は、計算の誤りではなく、認証情報の範囲かプロジェクトの対応付けに原因があることがほとんどです。

ダッシュボードのアクセスと Webhook は別物

AdMate は RevenueCat を 2 つの異なる方法で使います。

Apple 向けアプリが、ユーザーが設定したプロジェクトに問い合わせてダッシュボードのデータを取得します。
AdMate の API が、通知のために RevenueCat の Webhook を受け取ることができます。

ダッシュボード用の認証情報を設定しても Webhook は自動では設定されず、Webhook を作成してもアプリにプロジェクトの指標を一覧する権限は与えられません。それぞれ別の認証情報と目的を持つ別の作業として扱ってください。

API は、通知にわかりやすい名前や通貨を表示できるよう、デバイスとプロジェクトの一時的なコンテキストを保持します。このコンテキストは、ユーザーの収益履歴全体やアクセストークンをサーバー側にコピーしたものではありません。

プロジェクトが表示されないときの対処

認証情報は有効なのに、プロジェクトが 1 つしか表示されない

その認証情報が特定のプロジェクト専用のものかどうか確認してください。必要なキーを追加または対応付けるか、適切であればサポート対象のアカウント単位の方法を使います。

有効なプロジェクトなのに指標が表示されない

取引があることがわかっている終了済みの期間を選び、プロジェクトとストアのフィルターを確認して、メインアプリで更新してください。新しいプロジェクトや稼働していないプロジェクトでは、ゼロになるのが正しい場合もあります。

突然、認可に失敗するようになった

キーが失効した、ローテーションされた、または空白付きでコピーされた可能性があります。RevenueCat でキーの状態を確認し、AdMate で差し替えてください。失効したキーを予備として残さないでください。

プロジェクト名は正しいのに合計がおかしい

指標の定義、返金、通貨、期間の境界を確認してください。範囲をそろえるまでは、RevenueCat の収益を App Store Connect の売上と直接比較しないでください。

認証情報を保護する

キーを分析データ、ログ、診断用スクリーンショットに含めない
プロジェクトのキーを想定外の組織で使い回さない
キーが漏えいした場合はローテーションする
プロジェクトを読み取る必要がなくなったデバイスから AdMate のアカウントを削除する
業務委託先やクライアントとの関係が終わったら、アクセス権を定期的に見直す

統合した収益の数字を公開する前に、各サービスの合計が異なる理由をお読みください。

よくある質問

AdMate は複数の RevenueCat プロジェクトに接続できますか？

はい。アカウントの仕組みは、複数のプロジェクトとプロジェクトごとの認証情報に対応しています。ビューを統合する前に、各プロジェクトに名前を付けて確認してください。

RevenueCat の公開 SDK キーだけで足りますか？

AdMate の RevenueCat 設定で求められる種類の認証情報を使ってください。アプリ向けの公開 SDK キーとシークレットの API 認証情報は目的が異なります。

AdMate はサブスクリプションの収益をすべて自社の API に送りますか？

いいえ。アプリは設定されたサービスに直接問い合わせます。API の RevenueCat コンテキストは Webhook 通知のためのもので、収益を蓄積する場所ではありません。

サポートには何を送ればよいですか？

プロジェクト名、期間、指標、一部を伏せたエラー内容を送ってください。シークレットキーは決して送らないでください。