asc-metrics

asc-metrics 技能概览

asc-metrics 的作用

asc-metrics 技能可以帮助你分析同步到 Appeeky 里的 App Store Connect 真实绩效数据：下载量、收入、IAP、订阅、试用，以及按国家/地区划分的趋势。它面向第一方报表，因此当你需要的是账户真实数据而不是预估值时，asc-metrics 才是合适选择。

谁适合使用

如果你要对比不同时间段、回看应用销售趋势、检查订阅表现，或者用权威数据回答“我的 App 表现怎么样？”，就应该使用 asc-metrics 技能。它尤其适合创始人、增长负责人和分析师，他们希望有一套可重复使用的 asc-metrics guide，用于 App Store Connect 报表分析。

采用前的主要阻碍

主要门槛在于设置和范围：Appeeky 必须已经连接到 App Store Connect，账号需要 Indie 及以上方案，而且同步是每晚执行，最多只保留 90 天历史。如果你需要的是第三方预估，这就不是合适工具；如果你需要更深入的订阅策略分析，最好把它和更专门的工作流搭配使用。

如何使用 asc-metrics 技能

安装并检查访问权限

使用 npx skills add Eronred/aso-skills --skill asc-metrics 完成 asc-metrics install 流程。开始提问前，先确认 Appeeky 已在 Settings → Integrations → App Store Connect 中完成连接，并且当前方案支持发起请求。如果 ASC 还没连上，这个技能会默认让你先把这一步补齐。

把模糊问题改成可用输入

asc-metrics usage 的效果最好，是在你同时提供四项信息时：指标、App、时间范围和对比方式。好的提问可以写成这样：“用 asc-metrics 分析 app X 过去 30 天的收入，并与前 30 天对比，同时突出国家变化和订阅趋势。” 像“帮我看看我的 App”这种弱问题，会迫使系统做太多猜测。

先读哪些文件

先从 SKILL.md 开始，因为这里包含了操作流程和前置条件。在更大的 repo 里，你通常还会检查 README.md、AGENTS.md、metadata.json 以及支持文件夹，但这个技能目前看起来主要集中在一个文件里。所以最快的路径就是先读技能说明，再立刻把它映射到你的 App 和问题上。

提升输出效果的实用工作流

这个技能的流程是：先确定 App，再明确分析目标，接着设置时间段，然后拉取相关指标。如果你已经知道 app_apple_id，就直接提供；如果不知道，就先让技能列出可用 App。对于 asc-metrics for Data Analysis，最好的结果通常来自“一次只问一个核心问题”，然后再追问更窄的对比，而不是一上来就要求一个大而全的仪表盘式输出。

asc-metrics 技能常见问题

asc-metrics 看的是预估值还是官方数据？

它分析的是从 App Store Connect 同步到 Appeeky 的官方数据。这意味着 asc-metrics 更适合内部报表和运营决策，而不是竞品情报或市场规模测算。

使用前需要先连接什么吗？

需要。这个技能默认你已经有 Appeeky 账号、App Store Connect 集成，以及允许发起指标请求的方案。如果这些条件缺失，技能设计上应该尽早停止，并把你引导去完成设置，而不是自行猜测。

asc-metrics 比普通提示词更好吗？

通常是的，前提是你想要结构化分析，并尽量减少来回追问。普通提示词可能也会问下载量或收入，但 asc-metrics 额外提供了工作流、约束条件和数据访问假设，能更快找到正确的 App 和时间范围。

什么情况下不该用 asc-metrics？

当你需要的是别家公司预估安装量、超出原始指标之外的深度变现策略分析，或者数据早于当前同步窗口时，不要用它。这些情况下，应该换别的技能，或者使用更宽泛的分析工作流。

如何改进 asc-metrics 技能

先给出决策背景

最强的输入不是只说你要哪个指标，而是先告诉技能你要做什么决策。比如：“我需要判断本月付费获客是否在改善”就比“展示下载量”更有用，因为它会引导对比方式、国家拆分和趋势解读。

明确 App 和对比方式

当你明确说明具体 App、日期范围和基准时，asc-metrics 的效果会更好。可以直接写成“全部 App”“单个 App”“最近 7 天 vs 前 7 天”或“本月至今 vs 上月同期”，这样输出就不会被无关表格撑得过满。

注意常见失败模式

最常见的问题是请求信息不够具体，结果只得到泛泛总结，而不是有价值的分析。另一个问题是要求超出同步窗口的数据，或者期待 ASC 里本来就没有的更大业务上下文；如果出现这种情况，就把问题收紧到这个技能真正能拉取的指标上。

从概览逐步追到诊断

先用一个高层级的 asc-metrics usage 请求起步，然后再针对你关心的异常继续追问：收入下滑、某个国家激增，或者订阅转化变化。通常这种两步法，比试图用一个提示词一次回答所有问题，更能得到好的 asc-metrics guide 体验。