asc-metrics

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ASC Metrics

ASC 指标

You analyze the user's official App Store Connect data synced into Appeeky — exact downloads, revenue, IAP, subscriptions, and trials. This is first-party data, not estimates.
你分析的是用户同步到 Appeeky 的官方 App Store Connect 数据——准确下载量、收入、IAP、订阅和试用数据。这是第一方数据,并非估算值。

Prerequisites

前置条件

  • Appeeky account with ASC connected (Settings → Integrations → App Store Connect)
  • Indie plan or higher (2 credits per request)
  • Data syncs nightly; up to 90 days of history available
If ASC is not connected, prompt the user to connect it at appeeky.com/settings and return.
  • Appeeky 账户,且已连接 ASC(Settings → Integrations → App Store Connect)
  • Indie 计划或更高版本(每次请求消耗 2 credits)
  • 数据每晚同步;可查看最多 90 天的历史记录
如果尚未连接 ASC,则提示用户前往 appeeky.com/settings 完成连接,然后返回。

Initial Assessment

初步评估

  1. Check for
    app-marketing-context.md
    — read it for app context
  2. Ask: What do you want to analyze? (downloads, revenue, subscriptions, country breakdown, trend comparison)
  3. Ask: Which time period? (default: last 30 days)
  4. Ask: Specific app or all apps?
  1. 检查是否存在
    app-marketing-context.md
    ——读取该文件以了解应用背景
  2. 询问:你想分析什么?(下载量、收入、订阅、国家/地区细分、趋势比较)
  3. 询问:选择哪个时间段?(默认:最近 30 天)
  4. 询问:分析特定应用还是所有应用?

Fetching Data

获取数据

Step 1 — List available apps

第 1 步——列出可用应用

bash
GET /v1/connect/metrics/apps
Match the user's app to an
app_apple_id
if not already known.
bash
GET /v1/connect/metrics/apps
如果尚不知道用户应用的
app_apple_id
,则将其与对应的 ID 匹配。

Step 2 — Get overview (portfolio)

第 2 步——获取概览(整体数据)

bash
GET /v1/connect/metrics?from=YYYY-MM-DD&to=YYYY-MM-DD
bash
GET /v1/connect/metrics?from=YYYY-MM-DD&to=YYYY-MM-DD

Step 3 — Get app detail (single app)

第 3 步——获取应用详情(单个应用)

bash
GET /v1/connect/metrics/apps/:appId?from=YYYY-MM-DD&to=YYYY-MM-DD
Response includes:
daily[]
,
countries[]
,
totals
.
See full API reference: appeeky-connect.md
bash
GET /v1/connect/metrics/apps/:appId?from=YYYY-MM-DD&to=YYYY-MM-DD
响应包含:
daily[]
、
countries[]
、
totals
。
有关完整 API 参考,请参阅 appeeky-connect.md。

Analysis Frameworks

分析框架

Period-over-Period Comparison

期间对比分析

Fetch two equal-length windows and compare:
MetricPrior PeriodCurrent PeriodChange
Downloads[N][N][+/-X%]
Revenue$[N]$[N][+/-X%]
Subscriptions[N][N][+/-X%]
Trials[N][N][+/-X%]
Trial → Sub Rate[X]%[X]%[+/-X pp]
What to look for:
  • Downloads rising but revenue flat → pricing or paywall issue
  • Trials rising but conversions flat → paywall or onboarding issue
  • Revenue rising but downloads flat → good monetization improvement
获取两个长度相同的时间窗口并进行比较:
指标上一时间段当前时间段变化幅度
下载量[N][N][+/-X%]
收入$[N]$[N][+/-X%]
订阅量[N][N][+/-X%]
试用量[N][N][+/-X%]
试用→订阅转化率[X]%[X]%[+/-X pp]
重点观察:
  • 下载量上升但收入持平 → 定价或 paywall 问题
  • 试用量上升但转化率持平 → paywall 或 onboarding 问题
  • 收入上升但下载量持平 → 变现能力有所改善

Daily Trend Analysis

每日趋势分析

From
daily[]
, identify:
  • Spikes — Did a feature, update, or press trigger them?
  • Drops — Correlate with app updates, seasonality, or algorithm changes
  • Trend direction — 7-day moving average vs prior 7 days
从
daily[]
中识别:
  • 峰值——某个功能、更新或媒体报道是否引发了这些峰值?
  • 下降——分析其与应用更新、季节性因素或算法变化的相关性
  • 趋势方向——将 7 日移动平均值与前 7 日进行比较

Country Breakdown

国家/地区细分

Sort
countries[]
by downloads and revenue:
  1. Top 5 by downloads — Are you investing in ASO for these markets?
  2. Top 5 by revenue — Higher ARPD (avg revenue per download) = prioritize ASO
  3. High downloads, low revenue — Markets with weak monetization
  4. Low downloads, high revenue — Under-tapped premium markets (localize)
按下载量和收入对
countries[]
排序:
  1. 下载量前 5 名——你是否正在为这些市场投入 ASO?
  2. 收入前 5 名——更高的 ARPD(每次下载平均收入)意味着应优先投入 ASO
  3. 高下载量、低收入——变现能力较弱的市场
  4. 低下载量、高收入——尚未充分开发的高端市场(进行本地化)

Revenue Quality Check

收入质量检查

Compute from the data:
MetricFormulaBenchmark
ARPDRevenue / Downloads> $0.05 good; > $0.20 excellent
Trial rateTrials / Downloads> 20% means strong paywall reach
Sub conversionSubscriptions / Trials> 25% is strong
Revenue per subRevenue / SubscriptionsDepends on pricing
根据数据计算:
指标计算公式基准
ARPD收入 / 下载量> $0.05 表现良好;> $0.20 表现优秀
试用率试用量 / 下载量> 20% 表明 paywall 触达能力强
订阅转化率订阅量 / 试用量> 25% 表示转化强劲
每项订阅收入收入 / 订阅量取决于定价

Output Format

输出格式

Performance Snapshot

表现概览

📊 [App Name] — [Period]

Downloads:     [N]  ([+/-X%] vs prior period)
Revenue:       $[N] ([+/-X%])
Subscriptions: [N]  ([+/-X%])
Trials:        [N]  ([+/-X%])
IAP Count:     [N]  ([+/-X%])
Trial→Sub:     [X]%

Top Markets (downloads):
  1. [Country] — [N] downloads, $[N]
  2. [Country] — [N] downloads, $[N]
  3. [Country] — [N] downloads, $[N]

Key Observations:
- [What the trend means]
- [Any anomaly and likely cause]
- [Opportunity identified]

Recommended Actions:
1. [Specific action based on data]
2. [Specific action based on data]
📊 [App Name] — [Period]

Downloads:     [N]  ([+/-X%] vs prior period)
Revenue:       $[N] ([+/-X%])
Subscriptions: [N]  ([+/-X%])
Trials:        [N]  ([+/-X%])
IAP Count:     [N]  ([+/-X%])
Trial→Sub:     [X]%

Top Markets (downloads):
  1. [Country] — [N] downloads, $[N]
  2. [Country] — [N] downloads, $[N]
  3. [Country] — [N] downloads, $[N]

Key Observations:
- [What the trend means]
- [Any anomaly and likely cause]
- [Opportunity identified]

Recommended Actions:
1. [Specific action based on data]
2. [Specific action based on data]

Trend Alert

趋势提醒

When a significant change (>20%) is detected, flag it:
⚠️  Downloads dropped [X]% this week
    Possible causes: [list 2-3 hypotheses]
    Next steps: [specific diagnostic actions]
检测到显著变化(>20%)时,进行标记:
⚠️  Downloads dropped [X]% this week
    Possible causes: [list 2-3 hypotheses]
    Next steps: [specific diagnostic actions]

Common Questions

常见问题

"Why did my downloads drop?"
  1. Pull daily trend — when did it start?
  2. Check if an update shipped on that date
  3. Check keyword rankings (use
    keyword-research
    skill)
  4. Check competitor activity (use
    competitor-analysis
    skill)
"Which countries should I localize for?" Pull country breakdown → sort by downloads → flag high-download, non-English markets → use
localization
skill
"Is my monetization improving?" Compare trial rate and trial→sub rate period over period → use
monetization-strategy
skill for paywall improvements
“我的下载量为何下降?”
  1. 拉取每日趋势——从什么时候开始下降?
  2. 检查当天是否发布了应用更新
  3. 检查关键词排名(使用
    keyword-research
    skill)
  4. 检查竞争对手动态(使用
    competitor-analysis
    skill)
“我应该为哪些国家/地区进行本地化?” 拉取国家/地区细分数据 → 按下载量排序 → 标记高下载量、非英语市场 → 使用
localization
skill
“我的变现能力正在改善吗?” 比较各时期的试用率和试用→订阅转化率 → 使用
monetization-strategy
skill 改进 paywall

Related Skills

相关 Skills

  • app-analytics
    — Full analytics stack setup and KPI framework
  • monetization-strategy
    — Improve subscription conversion and paywall
  • retention-optimization
    — Reduce churn using the metrics as input
  • localization
    — Expand top-performing markets seen in country data
  • ua-campaign
    — Validate whether paid installs show in downloads spike
  • app-analytics
    ——完整分析技术栈配置与 KPI 框架
  • monetization-strategy
    ——提升订阅转化率和 paywall 效果
  • retention-optimization
    ——以这些指标为输入,降低用户流失率
  • localization
    ——拓展国家/地区数据中表现最佳的市场
  • ua-campaign
    ——验证付费安装量是否会体现在下载量峰值中