Apple App Store を接続する
適切な権限を持つ App Store Connect API キーを作成し、追加して、アプリを選びます。
Apple はレポート用にサインインポップアップを使いません。App Store Connect で API キーを作成し、一度だけダウンロードして、その内容を Revenue Sensor に貼り付けます。コンソールではこのソースは Apple IAP と呼ばれます。
始める前に
- キーを作成できるよう、App Store Connect の Account Holder または Admin 権限。
- Vendor Number。App Store Connect → Reports → Payments and Financial Reports で確認できます。左上のアカウント名の下に表示されています。
API キーを作成する
- 1
Integrations のキー画面を開く
App Store Connect → Users and Access → Integrations → App Store Connect API。
- 2
キーを生成する
Active の横にある + をクリックし、“Revenue Sensor”など後で分かる名前をキーに付けます。
- 3
レポート権限を与える
Access で Sales、Finance、または Admin を選びます。いずれも Revenue Sensor が取り込む Sales and Trends レポートを読めます。App Store Connect の正確な数字も取得できるのは Admin だけです（後述）。Developer または App Manager のアクセスしかないキーでは収益を読めません。
- 4
.p8 ファイルをダウンロードする
Apple が秘密鍵をダウンロードさせてくれるのは一度きりです。ページを離れる前に安全な場所に保存してください。紛失した場合は新しいキーを生成し、その新しい Key ID と .p8 ファイルを使ってください。
最も多い失敗
収益が空で返ってくる場合、またはアカウントに “Your API key needs the Sales role” と表示される場合、原因はほぼ確実にキーのロールです。App Store Connect でキーに Sales または Finance ロールを付与してから再接続してください。また、Vendor Number がキーと同じ App Store Connect アカウントのものであることも確認してください。
認証情報を追加する
- Issuer ID: App Store Connect の API キーページの上部に表示されます。すべてのキーで同じ値です。
- Key ID: 作成したキーの行に表示されます。
- 秘密鍵: ダウンロードした .p8 ファイル。アップロードするか、ドラッグして入れます。暗号化して保存され、二度と表示されません。
- Vendor Number: Payments and Financial Reports から。
アプリを選ぶ
Revenue Sensor は、そのキーで見える公開済みのアプリを一覧表示します。追跡したいものを選択してください。同期されるのは選択したアプリだけです。
取り込まれるデータ
収益は、Apple の日次 Sales サマリーレポートにある販売数と Developer Proceeds を掛けたものです。Proceeds は、Apple の手数料と Apple が徴収する税金を差し引いた後に Apple があなたに支払う金額なので、このソースの収益ベースは Payout のみです。返金は販売数がマイナスの行として届くため、Apple が処理した日に差し引かれます。ダウンロード数と返金も同じレポートから取り込まれます。
レポートの遅延
Apple は各日の売上レポートをその日が終わった後に公開するため、今日の分はまだ表示されません。Apple が再集計するのに合わせて直近の日は多少動くことがあります。同期のたびに直近14日分を読み直します。