【免费下载链接】app-store-connect-cli-skillsSkills to automate app store deployed and everything related to it using the asc cli项目地址https://gitcode.com/gh_mirrors/ap/app-store-connect-cli-skills点击查看免费下载还在 App Store Connect 网页里手动导出分析报表吗本文面向 iOS 开发者与数据分析师介绍 app-store-connect-cli-skills 项目中的asc-analytics-reports技能它配合 App Store Connect 命令行工具asc一键完成 App Store 分析数据的自动化采集——从发现报表请求、按处理日期与粒度筛选报表实例到批量下载全部报表分段并用 Apple 提供的大小与 MD5 元数据逐文件校验最终交给你一套可直接分析的、完整性可证明的私有数据文件。 快速上手一条命令安装 asc 技能包asc-analytics-reports是 app-store-connect-cli-skills 技能包中的成员安装有两种方式1️⃣推荐直接用asc自带命令安装全部技能asc install-skills2️⃣手动克隆仓库后交给 Agent Skills 安装器如 Codexgit clone https://gitcode.com/gh_mirrors/ap/app-store-connect-cli-skills npx skills add gh_mirrors/ap/app-store-connect-cli-skills安装完成后无需手动激活Agent 检测到下载分析报表这类任务时会自动调用该技能。技能完整定义见 skills/asc-analytics-reports/SKILL.md。 第一步校验 asc 版本与命令契约自动化之前先确认本地asc支持所需的筛选参数asc analytics view --help只有当帮助信息中同时列出--processing-date、--granularity、--paginate和--include-segments时才继续——这些参数需要asc 3.5.0 及以上版本。特别提醒不要用已废弃的--date参数替代它做的是本地粗略匹配而非 Apple 服务端的处理日期过滤容易拿到错误的报表实例。 第二步先建私有目录再谈数据采集分析报表属于机密商业数据技能的第一步反而是建保险箱umask 077 ASC_ANALYTICS_DIR$(mktemp -d ${TMPDIR:-/tmp}/asc-analytics.XXXXXX) mkdir -m 700 $ASC_ANALYTICS_DIR/segments这条命令在系统临时目录中创建一个仅属主可读写700 权限的目录后续的报表清单 JSON、下载的分段文件、错误日志全部写入其中而不是散落在仓库或聊天窗口里。整个采集流程的纪律是原始 JSON 与报错输出绝不粘贴进聊天、commit、issue 或 PR。 第三步优先复用已有报表请求创建报表请求会改变 App Store Connect 的服务端状态且需要 Admin 权限的密钥档案因此技能规定先查后建asc --profile $PROFILE analytics requests \ --app $APP_ID \ --paginate \ --output json找到可用请求直接记录返回的requestId继续往下走找不到停下来征求你的明确批准再创建ONGOING持续或ONE_TIME_SNAPSHOT一次性快照类型的请求并加上--reuse-existing参数避免重复创建。整个流程永不删除或替换已有请求已验证文件之外不做任何破坏性操作。 第四步按处理日期与粒度精准检索报表实例拿到requestId后分两步发现报表。先用asc analytics view --request-id $REQUEST_ID --paginate --output json拉取报表与实例元数据不带分段 URL挑选可用的processingDate和粒度再带上过滤条件拉取完整清单asc --profile $PROFILE analytics view \ --request-id $REQUEST_ID \ --processing-date $PROCESSING_DATE \ --granularity $GRANULARITY \ --paginate \ --include-segments \ --output json两个实用细节粒度参数接受DAILY、WEEKLY、MONTHLY可用逗号组合如DAILY,WEEKLY非法值会被直接报错拦下不会静默丢弃--processing-date是 Apple 处理报表的日期不一定是报表行数据所代表的时间周期理解这一点能避免数据日期对不上的困惑。全程使用--paginate让asc自动跟随 Apple 的分页链接切勿手工拼接分页 URL。⬇️ 第五步下载全部报表分段一个都不少解析清单 JSON 时逐个实例枚举其所有分段segment并记下每个分段的sizeInBytes与checksum元数据这是第六步校验的答案asc --profile $PROFILE analytics download \ --request-id $REQUEST_ID \ --instance-id $INSTANCE_ID \ \ --segment-id $SEGMENT_ID \ --output $ASC_ANALYTICS_DIR/segments/$SEGMENT_ID.txt.gz三个关键约定分析报表是制表符分隔的文本所以扩展名用.txt.gz而非 CSV 暗示校验之前不要加--decompress保持压缩字节原样一个实例可能有多个分段必须全部下载——只拿第一个分段就当作完整报表是最常见的错误。✅ 第六步大小 MD5 双重校验确认数据完好每个下载完的文件都要与 Apple 元数据对账压缩字节数等于sizeInBytes且小写 MD5 摘要等于checksumactual_size$(wc -c $SEGMENT_FILE | tr -d ) actual_md5$(openssl dgst -md5 -r $SEGMENT_FILE | awk {print tolower($1)})校验不一致时分段即标记失败由于asc analytics download拒绝覆盖已有输出技能会重试一次到新路径如$SEGMENT_ID.retry-1.txt.gz并独立复验两项检查都通过才采用。任何一段失败或缺失都不得宣称采集完整也绝不在校验通过前解析文件内容。️ 安全护栏私有数据始终可控这套流程把数据安全写进了每一步值得单独记住护栏说明 数据保密报表清单、签名 URL、分段文件、各类 ID 一律视为机密✋ 变更需批准创建请求会改变服务端状态必须经你明确同意 不删不替换绝不删除或替换已有请求 不泄露链接永不打印、外传分段的签名下载 URL⚖️ 不虚假报功缺段或校验失败时明确说未采集完整最终汇报只包含所选处理日期与粒度、报表/实例/分段的数量统计、完整性结论、失败分段 ID 列表不含签名 URL 与报表行——敏感值、凭据、原始数据行一概不进入任何公开产物。 常见问题Q--processing-date和我理解的报表日期是一回事吗不是。它表示 Apple 服务端处理该报表的日期报表里的行数据可能覆盖更早的统计周期。Q每次运行都要创建新请求吗不需要。技能优先发现并复用已有请求只有在读不到可用请求、且你明确批准后才创建ONGOING或ONE_TIME_SNAPSHOT请求。Q下载的文件能直接当 CSV 分析吗不能。文件是.txt.gz压缩的制表符分隔文本且必须先通过大小 MD5 校验才能交给下游分析流程解析。Q命令参数拿不准怎么办随时用asc analytics view --help自查并参考技能包中的 skills/asc-cli-usage/SKILL.md——它汇总了asc的规范动词、参数约定、分页与输出格式等通用用法。 小结asc-analytics-reports把从 App Store Connect 拿分析数据这件重复又易错的事收敛为一条有纪律的流水线验证版本契约 → 隔离私有存储 → 复用报表请求 → 按处理日期与粒度筛选实例 → 下载全部分段 → 大小 MD5 双重校验。它只负责采集与验证不做数据解读——这正是它的边界价值交给下游的永远是完整且可证明未被篡改的私有报表文件。技能全文可查阅 skills/asc-analytics-reports/SKILL.md更多配套技能发布流程、TestFlight 编排、崩溃诊断等见 README.md。赞分享【免费下载链接】app-store-connect-cli-skillsSkills to automate app store deployed and everything related to it using the asc cli项目地址https://gitcode.com/gh_mirrors/ap/app-store-connect-cli-skills点击查看免费下载相关推荐DLSS Swapper 避坑手册从装到用只花 5 分钟DLSS Swapper 避坑手册从装到用只花 5 分钟 你刚把 DLSS 换成新版 dll进游戏帧数没涨反而比昨天低了 8 帧。DLSS Swapper桌面应用如何快速上手SecretFlow10分钟搭建你的第一个隐私保护应用如何快速上手SecretFlow10分钟搭建你的第一个隐私保护应用 隐私计算框架SecretFlow是阿里巴巴开源的一款统一框架专门用于隐私保护数据分析和机人工智能机器学习深度学习联邦学习隐私计算数据科学使用 Airbyte App Store Connect Source Connector 同步 App 销量、财务与 Analytics 报表使用 Airbyte App Store Connect Source Connector 同步 App 销量、财务与 Analytics 报表 App Sto数据工程数据集成ETL后端大数据创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考