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]

如果通过 asc auth login --vendor-number 或 asc auth update --vendor-number 保存了 --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	App 和 App 内购买销售额
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 会自动处理解压和解析。
• 只有频率为 DAILY 时，--report-date 才可选；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 辅助信息，可指导 Agent 完成层级中的每一步。

参考

有关各标志的有效枚举值完整列表，请参阅 commands.md。