asc-reports

asc の売上・財務レポート

App Store Connect から売上とトレンドのデータ、および財務レポートをダウンロードします。フラグの詳細なリファレンスと有効な列挙値については、commands.md を参照してください。

コマンド

売上レポートをダウンロードする

asc sales-reports download \
  [--vendor-number <VENDOR_NUMBER>] \
  --report-type SALES \
  --sub-type SUMMARY \
  --frequency DAILY \
  [--report-date 2024-01-15] \
  [--output json|table] \
  [--pretty]

--vendor-number は、asc auth login --vendor-number または asc auth update --vendor-number で保存されている場合、アクティブなアカウントから自動解決されます。明示的に指定した --vendor-number は、保存された値より優先されます。--report-date を省略できるのは、頻度が DAILY の場合に限られます。省略すると、最新の利用可能な日次レポートが取得されます。頻度が WEEKLY、MONTHLY、YEARLY の場合、--report-date は必須です（指定しないと、Apple は PARAMETER_ERROR.INVALID を返します）。

財務レポートをダウンロードする

asc finance-reports download \
  [--vendor-number <VENDOR_NUMBER>] \
  --report-type FINANCIAL \
  --region-code US \
  --report-date 2024-01 \
  [--output json|table] \
  [--pretty]

--vendor-number は、保存されている場合、アクティブなアカウントから自動解決されます。財務レポートでは、その他すべてのフラグ（--report-date を含む）が必須です。

レポートの種類：クイックリファレンス

売上レポートの種類	説明
SALES	アプリとアプリ内購入の売上
PRE_ORDER	予約注文データ
SUBSCRIPTION	自動更新サブスクリプションのアクティビティ
SUBSCRIPTION_EVENT	サブスクリプションのライフサイクルイベント
SUBSCRIBER	アクティブなサブスクリプション登録者数
INSTALLS	初回ダウンロード数
FIRST_ANNUAL	初回の年間サブスクリプション更新
WIN_BACK_ELIGIBILITY	再獲得オファーの対象ユーザー

財務レポートの種類	説明
FINANCIAL	収益を含む財務概要
FINANCE_DETAIL	詳細な財務内訳

出力形式

レポートは Apple から動的な TSV データとして返され、JSON 配列に解析されます。列名はレポートの種類によって異なります。

{
  "data" : [
    {
      "Provider" : "APPLE",
      "SKU" : "com.example.app",
      "Title" : "My App",
      "Units" : "10",
      "Developer Proceeds" : "6.99",
      "Currency of Proceeds" : "USD"
    }
  ]
}

同じデータを表形式で表示するには、--output table を使用してください。

一般的なワークフロー

# 0. Save vendor number once (found in App Store Connect → Payments and Financial Reports)
asc auth update --vendor-number 88012345

# 1. Get daily sales summary (vendor number auto-resolved)
asc sales-reports download \
  --report-type SALES \
  --sub-type SUMMARY \
  --frequency DAILY \
  --report-date 2024-01-15 \
  --pretty

# 2. Check monthly subscription metrics
asc sales-reports download \
  --report-type SUBSCRIPTION \
  --sub-type SUMMARY \
  --frequency MONTHLY \
  --report-date 2024-01 \
  --pretty

# 3. Download financial report for US proceeds
asc finance-reports download \
  --report-type FINANCIAL \
  --region-code US \
  --report-date 2024-01 \
  --pretty

重要な注意事項

• ベンダー番号の自動解決：asc auth update --vendor-number <number> または asc auth login --vendor-number <number> で一度保存してください。すべてのレポートコマンドで、アクティブなアカウントから自動解決されます。上書きするには --vendor-number を使用してください。
• ベンダー番号は、App Store Connect の「売上とトレンド」→「支払いと財務レポート」で確認できます。
• レポートは Apple の API から gzip 圧縮された TSV として返されます。CLI が自動的に解凍して解析します。
• --report-date を省略できるのは、頻度が DAILY の場合に限られます。WEEKLY、MONTHLY、YEARLY では必須です。週次レポートの日付は日曜日である必要があります。
• レポートの種類、サブタイプ、頻度の組み合わせによっては無効です。サポートされていない組み合わせの場合、Apple はエラーを返します。
• 財務レポートでは、--region-code（例：US、EU、JP、AU）と --report-date が必須です。
• 日次レポートは通常1日遅れで、月次レポートは通常その月の終了後に利用可能になります。

アナリティクスレポート

アプリのエンゲージメント、コマース、使用状況、フレームワーク、パフォーマンスのアナリティクスを取得するための複数ステップのワークフローです。

コマンド

# Create a report request
asc analytics-reports request --app-id <id> --access-type ONE_TIME_SNAPSHOT|ONGOING

# List existing requests
asc analytics-reports list --app-id <id> [--access-type ONGOING]

# Delete a request
asc analytics-reports delete --request-id <id>

# List reports by category
asc analytics-reports reports --request-id <id> [--category APP_USAGE|APP_STORE_ENGAGEMENT|COMMERCE|FRAMEWORK_USAGE|PERFORMANCE]

# List instances by granularity
asc analytics-reports instances --report-id <id> [--granularity DAILY|WEEKLY|MONTHLY]

# Get download URLs
asc analytics-reports segments --instance-id <id>

アナリティクスのワークフロー

# 1. Request analytics
asc analytics-reports request --app-id 6450000000 --access-type ONE_TIME_SNAPSHOT --pretty

# 2. List commerce reports
asc analytics-reports reports --request-id req-abc --category COMMERCE --pretty

# 3. Get daily instances
asc analytics-reports instances --report-id rpt-xyz --granularity DAILY --pretty

# 4. Get download URLs
asc analytics-reports segments --instance-id inst-123 --pretty

アナリティクスのレスポンスには、階層内の各ステップをエージェントに案内する CAEOAS アフォーダンスが含まれます。

リファレンス

各フラグで使用できる列挙値の一覧については、commands.md を参照してください。