App Store Connect を AdMate に接続する方法

App Store Connect には、アプリのメタデータ、レビュー、分析、売上、見積もり収益、確定した財務レポートといった複数の種類のデータがあります。AdMate はこれらを AdMob や RevenueCat と同じアプリにまとめられますが、接続には正しい識別子と権限が必要です。

設定には App Store Connect の API キーを使います。秘密鍵はパスワードと同じように扱い、認証情報の画面にだけ読み込み、サポートへの問い合わせに添付しないでください。

AdMate

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

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

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

App Store Connect で用意するもの

Apple の「ユーザとアクセス」で API キーについて表示される値を用意します。

API キーを識別する Key ID
App Store Connect API の発行者を識別する Issuer ID
秘密鍵 .p8 キーの内容またはファイル
AdMate でわかりやすいアカウントの別名
必要な売上レポートや財務レポートで求められる場合はベンダー番号

Apple が返すデータは、キーに割り当てられたロールで決まります。アプリを一覧できるキーでも、売上や財務のデータにはアクセスできない場合があります。必要最小限のロールを使いつつ、実際に確認したいレポートをカバーしているかを確かめてください。

Apple では通常、秘密鍵のファイルは一度しかダウンロードできません。原本はリポジトリやスクリーンショットに含めず、安全な場所に保管してください。ファイルを紛失したり漏えいしたりした場合は、チャットで誰かに送ってもらうのではなく、キーを無効にして新しいキーを作成します。

AdMate にアカウントを追加する

設定を開き、アカウント管理に移動します。
App Store Connect アカウントの追加を選びます。
わかりやすい表示名を入力します。
Key ID と Issuer ID を Apple が示すとおり正確に入力します。
認証情報の画面から秘密鍵を読み込むか貼り付けます。
財務レポートや売上レポートに必要な場合はベンダー番号を追加します。
アカウントを保存し、AdMate に認証情報を検証させます。
アカウントの概要を開き、想定どおりのアプリが表示されることを確認します。

.p8 キーのヘッダーやフッターを手作業で編集しないでください。余計な文字、改行の欠落、別の発行者のキーがあると、トークンを作成できません。

データの種類ごとに個別に確認する

概要がすべて正常に見えても、App Store Connect のすべてのエンドポイントが使えるとは限りません。使う予定の項目を確認してください。

アプリとメタデータ

想定したアプリとアイコンが表示されることを確認します。アプリが表示されない場合は、キーが別のプロバイダ組織のものか、ロールが制限されている可能性があります。

レビュー

レビューの画面を開き、よく知っているアプリを確認します。レビューはストアと地域ごとのデータなので、正常な空の表示は、該当するレビューがないだけということもあります。

分析

完了した期間を選び、Apple がレポートを提供するまでの時間を考慮してください。分析レポートの中にはすぐには反映されず、独自の粒度や遅延があるものもあります。

売上と収益

顧客の購入額とデベロッパの収益は分けて表示してください。両者は同じ値ではなく、どちらも銀行への入金と混同してはいけません。

財務レポート

財務レポートは Apple の締め済みの報告期間を使い、正しいベンダー番号とロールが必要になる場合があります。当日分が表示されることを期待せず、照合用に使ってください。

接続のトラブルシューティング

キーまたは署名が無効

Key ID、Issuer ID、秘密鍵を 1 つのセットとして確認し直します。有効なキーでも、発行者が違えば失敗します。漏えいの可能性がある場合は、テストを続ける前にキーを無効にしてください。

アプリは読み込まれるが財務レポートが表示されない

API キーのロール、ベンダー番号、要求した財務期間を確認してください。メタデータにアクセスできても、財務データにアクセスできるとは限りません。

分析にデータが表示されない

サポートされている過去の期間を使い、レポートがすでに提供されているかを確認し、選択したアプリが要求した指標を生成しているかを確かめてください。

別の組織のアプリが表示される

アカウントを削除し、正しいプロバイダのキーを追加してください。アプリのバンドル名の付け方が同じだからといって、2 つの組織の合計をまとめないでください。

複数の App Store Connect アカウント

AdMate は複数のアカウントに対応しています。キーを作成した人ではなく、組織がわかる別名を使ってください。キーをローテーションしたら正しいアカウントで差し替え、アプリ、分析、財務をそれぞれ別にテストします。

サブスクリプション分析と比較する場合は、App Store Connect と RevenueCat の合計が異なる理由をお読みください。

よくある質問

AdMate に Apple ID のパスワードは必要ですか？

いいえ。接続には App Store Connect の API キー、発行者、関連する識別子を使います。この設定のために Apple ID のパスワードを入力したり共有したりしないでください。

アプリは読み込まれるのに収益が表示されないのはなぜですか？

キーにアプリのメタデータを読む権限はあっても、売上や財務の権限がない可能性があります。また、ベンダー番号やレポート期間が不足している場合もあります。

1 つのキーを複数の AdMate 端末で使い回せますか？

技術的には同じ認証情報で動作することもありますが、コピーが増えるほど漏えいのリスクが高まります。組織のキー管理ポリシーに従い、アクセスが不要になった端末のキーは無効にしてください。

App Store Connect の見積もりは確定した会計上の値ですか？

いいえ。会計処理には、締め済みの財務レポートと実際の支払いを使ってください。