用途:通过 asc CLI 工具从 App Store Connect 下载销售与趋势数据、财务报表以及分析报表。适用于需要批量获取应用销售、订阅、财务结算或使用情况数据的场景。
主要能力:
- 销售报表(asc sales-reports download):支持 SALES、PRE_ORDER、SUBSCRIPTION、SUBSCRIPTION_EVENT、SUBSCRIBER、INSTALLS、FIRST_ANNUAL、WIN_BACK_ELIGIBILITY 等报表类型,可设 frequency 为 DAILY、WEEKLY、MONTHLY、YEARLY。
- 财务报表(asc finance-reports download):支持 FINANCIAL、FINANCE_DETAIL 类型,需 --region-code 与 --report-date。
- 分析报表(asc analytics-reports):按 request、reports、instances、segments 分步获取下载链接,类别含 APP_USAGE、APP_STORE_ENGAGEMENT、COMMERCE、FRAMEWORK_USAGE、PERFORMANCE,粒度含 DAILY、WEEKLY、MONTHLY。
使用方式:先用 asc auth login/update --vendor-number 保存供应商编号(可在 App Store Connect 的 Sales and Trends → Payments and Financial Reports 查看),之后报表命令会自动解析该编号。示例:asc sales-reports download --report-type SALES --sub-type SUMMARY --frequency DAILY --report-date 2024-01-15 --pretty。输出为动态 TSV 解析成的 JSON 数组,可用 --output table 查看表格。
限制:--report-date 仅 DAILY 可省略,WEEKLY、MONTHLY、YEARLY 必填,周报日期须为周日;财务报表必须提供 --region-code 和 --report-date;并非所有报表类型、子类型与频率组合都有效,Apple 会对无效组合返回错误;日报通常延迟约一天,月报在月末后可用;CLI 自动处理 gzip 解压与解析。