Communitygithub.com

JordanCoin/ios-skills-collection

分析用户来自 App Store Connect 的实际应用性能数据——包括精确的下载量、收入、内购、订阅和试用量。

ios-skills-collection 是什么?

此技能用于分析用户通过 Appeeky 同步的官方 App Store Connect 数据。它提供第一手、精确的下载、收入、应用内购买(IAP)、订阅和试用数据,而非第三方估算。该技能通过一系列 REST API 调用获取数据,支持整体概览、单应用详查、周期对比、每日趋势、国家分布和收入质量分析。它基于预设的分析框架自动计算关键指标(如 ARPD、试用转化率),并以结构化的摘要和趋势告警输出结果。用户需拥有已关联 ASC 的 Appeeky 账号(Indie 及以上计划),数据每日同步,可回溯最多 90 天。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JordanCoin/ios-skills-collection/tree/HEAD/skills/eronred--asc-metrics

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

ASC 指标

你可以分析用户通过 Appeeky 同步的官方 App Store Connect 数据——包括精确的下载量、收入、内购、订阅和试用量。这是第一方数据,而非估算。

前提条件

  • 拥有已连接 ASC 的 Appeeky 账号(设置 → 集成 → App Store Connect)
  • 需为 Indie 或更高计划(每次请求消耗 2 个积分)
  • 数据每日同步;最多可查看 90 天的历史数据

如果未连接 ASC,请提示用户在 appeeky.com/settings 进行连接,然后返回。

初始评估

  1. 检查 app-marketing-context.md 文件——阅读以了解应用背景
  2. 询问:你想分析什么?(下载量、收入、订阅、国家分布、趋势对比)
  3. 询问:哪个时间段?(默认:最近 30 天)
  4. 询问:具体哪个应用还是所有应用?

获取数据

第一步 —— 列出可用应用

GET /v1/connect/metrics/apps

将用户的应用与 app_apple_id 匹配(如果尚未知道)。

第二步 —— 获取概览(所有应用)

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

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

GET /v1/connect/metrics/apps/:appId?from=YYYY-MM-DD&to=YYYY-MM-DD

响应包括:daily[]、countries[]、totals。

查看完整 API 参考:appeeky-connect.md

分析框架

周期对比

获取两个等长的时间窗口并进行比较:

指标上一周期当前周期变化
下载量[N][N][+/-X%]
收入$[N]$[N][+/-X%]
订阅数[N][N][+/-X%]
试用量[N][N][+/-X%]
试用 → 订阅转化率[X]%[X]%[+/-X 百分点]

需要注意的事项:

  • 下载量上升但收入持平 → 定价或付费墙问题
  • 试用量上升但转化率持平 → 付费墙或引导页问题
  • 收入上升但下载量持平 → 良好的变现能力提升

每日趋势分析

从 daily[] 数据中识别:

  • 峰值 —— 是否由功能、更新或媒体报道触发?
  • 低谷 —— 与应用更新、季节性变化或算法调整相关联
  • 趋势方向 —— 7 日移动平均线与过去 7 天比较

国家分布

按下载量和收入对 countries[] 进行排序:

  1. 按下载量排名前 5 的国家 —— 你是否有针对这些市场进行 ASO 投入?
  2. 按收入排名前 5 的国家 —— ARPD(平均每次下载收入)越高,越应优先进行 ASO
  3. 高下载量、低收入 —— 变现能力弱的市场
  4. 低下载量、高收入 —— 尚未充分利用的高价值市场(进行本地化)

收入质量检查

根据数据计算:

指标计算公式基准
ARPD收入 / 下载量> $0.05 为良好;> $0.20 为优秀
试用率试用量 / 下载量> 20% 表示付费墙覆盖效果好
订阅转化率订阅数 / 试用量> 25% 为优秀
每订阅收入收入 / 订阅数取决于定价

输出格式

性能概览

📊 [应用名称] — [时间段]

下载量:     [N]  ([+/-X%] 与上一周期相比)
收入:       $[N] ([+/-X%])
订阅数:     [N]  ([+/-X%])
试用量:     [N]  ([+/-X%])
内购次数:   [N]  ([+/-X%])
试用→订阅:  [X]%

主要市场(按下载量):
  1. [国家] — [N] 次下载,$[N]
  2. [国家] — [N] 次下载,$[N]
  3. [国家] — [N] 次下载,$[N]

关键观察:
- [趋势的含义]
- [任何异常及其可能原因]
- [发现的机会]

推荐行动:
1. [基于数据的具体行动]
2. [基于数据的具体行动]

趋势告警

当检测到显著变化(>20%)时,进行标记:

⚠️  本周下载量下降了 [X]%
    可能原因:[列出 2-3 个假设]
    后续步骤:[具体的诊断行动]

常见问题

“为什么我的下载量下降了?”

  1. 提取每日趋势——从何时开始下降?
  2. 检查当天是否有应用更新
  3. 检查关键词排名(使用 keyword-research 技能)
  4. 检查竞争对手活动(使用 competitor-analysis 技能)

“我应该针对哪些国家进行本地化?” 提取国家分布 → 按下载量排序 → 标记高下载量的非英语市场 → 使用 localization 技能

“我的变现能力在改善吗?” 逐周期比较试用率和试用→订阅转化率 → 使用 monetization-strategy 技能优化付费墙

相关技能

  • app-analytics —— 完整分析栈设置和 KPI 框架
  • monetization-strategy —— 提高订阅转化率和优化付费墙
  • retention-optimization —— 利用这些指标作为输入来降低流失率
  • localization —— 拓展在国家数据中看到的高表现市场
  • ua-campaign —— 验证付费安装是否体现在下载量峰值中

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

JordanCoin/ios-skills-collection

Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries. Use when the user asks about GitHub issues, pull requests, workflows, or wants to interact with GitHub repositories from the command line — including tasks like check CI status, create PR, list issues, or query the GitHub API.

JordanCoin/ios-skills-collection

Create media playback experiences using AVKit. Use when adding video players with AVPlayerViewController, enabling Picture-in-Picture, routing media with AirPlay, using SwiftUI VideoPlayer views, configuring transport controls, displaying subtitles and closed captions, or integrating AVFoundation playback with system UI.

JordanCoin/ios-skills-collection

Integrate and optimize Core ML models in iOS apps for on-device machine learning inference. Covers model loading (.mlmodelc, .mlpackage), predictions with auto-generated classes and MLFeatureProvider, compute unit configuration (CPU, GPU, Neural Engine), MLTensor, VNCoreMLRequest, MLComputePlan, multi-model pipelines, and deployment strategies. Use when loading Core ML models, making predictions, configuring compute units, or profiling model performance.

JordanCoin/ios-skills-collection

Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation. Use when working with Map views, annotations, markers, polylines, user location tracking, geocoding, reverse geocoding, search/autocomplete, directions and routes, geofencing, region monitoring, CLLocationUpdate async streams, or location authorization flows. Also use when working with maps, coordinates, addresses, places, directions, distance calculations, or location-based features in Swift apps.

JordanCoin/ios-skills-collection

Display and manipulate PDF documents using PDFKit. Use when embedding PDFView to show PDF files, creating or modifying PDFDocument instances, adding annotations (highlights, notes, signatures), extracting text with PDFSelection, navigating pages, generating thumbnails, filling PDF forms, or wrapping PDFView in SwiftUI.

JordanCoin/ios-skills-collection

Implement, review, or improve in-app tips and onboarding using Apple's TipKit framework. Use when adding feature discovery tooltips, onboarding flows, contextual tips, first-run experiences, coach marks, or working with Tip protocol, TipView, popoverTip, tip rules, tip events, or feature education UI.

JordanCoin/ios-skills-collection

When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features. Use when the user mentions "Google Play", "Android", "Play Store", "Play Console", "short description", "full description indexed", "Google Play ASO", or wants Google Play-specific keyword, creative, or ratings strategy. For iOS App Store optimization, see aso-audit and metadata-optimization.

JordanCoin/ios-skills-collection

When the user wants to implement, optimize, or use App Clips for app discovery and conversion. Use when the user mentions "App Clip", "app clip code", "mini app", "instant app", "App Clip card", "App Clip link", "no download required", "instant experience", or wants to understand how App Clips appear in App Store search. For general App Store discoverability, see aso-audit. For marketing campaigns, see ua-campaign.

JordanCoin/ios-skills-collection

When the user wants to plan a launch strategy for a new app or major update. Also use when the user mentions "app launch", "launch plan", "launch checklist", "pre-launch", "launch day", or "how to launch my app". For ongoing ASO after launch, see aso-audit. For paid acquisition during launch, see ua-campaign.

JordanCoin/ios-skills-collection

When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking. Also use when the user mentions "ASO audit", "ASO score", "why am I not ranking", "listing review", or "optimize my app store page". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.

JordanCoin/ios-skills-collection

Always use when working on any iOS, macOS, Swift, SwiftUI, Xcode, or Apple platform project. Routes to the correct specialized skills based on development phase and task context. This collection contains 210 skills from 28 authors covering the full iOS lifecycle.

相关技能