Communitygithub.com

JordanCoin/ios-skills-collection

當使用者想要分析自己 App 在 App Store Connect 中的實際表現資料(透過 Appeeky Connect 同步的真實下載量、營收、IAP、訂閱、試用與國家細分)時使用。當使用者詢問「我的下載量」、「我的營收」、「我的 App 表現如何」、「ASC 資料」、「銷售與趨勢」、「我的訂閱人數」、「App Store Connect 指標」或想要比較不同期間或熱門市場時,請使用此技能。若是第三方 App 的估算資料,請參閱 app-analytics。若需要深入的訂閱分析,請參閱 monetization-strategy。

ios-skills-collection 是什麼?

此技能讓 AI 助手能夠分析使用者在 Appeeky 中同步的官方 App Store Connect 資料,提供準確的第一方數據,而非估算值。使用者可以查詢真實的下載量、營收、應用程式內購買(IAP)、訂閱與試用次數,並針對特定 App 或整個產品組合進行期間比較與國家細分。支援多種分析框架,包括期間對比、每日趨勢分析、國家營收品質檢查等,協助開發者診斷下載量下降原因、評估變現成效,或找出值得當地語系化的市場。AI 助手會先確認必要條件(如 Appeeky 帳戶與 ASC 整合),再透過 API 擷取資料,最後以結構化摘要與行動建議的方式呈現結果。此技能適用於任何已將 App Store Connect 與 Appeeky 連接的開發者或產品經理。

相容平台~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 資料——包含精確的下載量、營收、應用程式內購買(IAP)、訂閱與試用次數。這些是第一方資料,非估算值。

必要條件

  • 已連接 ASC 的 Appeeky 帳戶(設定 → 整合 → App Store Connect)
  • Indie 方案或更高(每次請求 2 點額度)
  • 資料每夜同步;最多 90 天的歷史資料可用

如果 ASC 尚未連接,請提示使用者在 appeeky.com/settings 進行連接,然後返回。

初步評估

  1. 檢查 app-marketing-context.md — 讀取以取得 App 背景資訊
  2. 詢問:您想要分析什麼?(下載量、營收、訂閱、國家細分、趨勢比較)
  3. 詢問:哪個時間區間?(預設:最近 30 天)
  4. 詢問:特定 App 還是所有 App?

擷取資料

步驟 1 — 列出可用 App

GET /v1/connect/metrics/apps

如果尚未知道,請將使用者的 App 對應至 app_apple_id。

步驟 2 — 取得總覽(產品組合)

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

步驟 3 — 取得 App 詳細資料(單一 App)

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 pp]

觀察重點:

  • 下載量上升但營收持平 → 定價或付費牆問題
  • 試用次數上升但轉換率持平 → 付費牆或引導流程問題
  • 營收上升但下載量持平 → 變現能力改善良好

每日趨勢分析

從 daily[] 中找出:

  • 高峰 — 是否由某項功能、更新或媒體報導觸發?
  • 低谷 — 是否與 App 更新、季節性或演算法變更相關?
  • 趨勢方向 — 7 日移動平均線與前 7 日比較

國家細分

按下載量與營收排序 countries[]:

  1. 下載量前 5 名 — 您是否在這些市場投入 ASO?
  2. 營收前 5 名 — 較高的 ARPD(平均每下載營收)表示應優先進行 ASO
  3. 高下載量、低營收 — 變現能力較弱的市場
  4. 低下載量、高營收 — 尚未充分開發的 Premium 市場(建議當地語系化)

營收品質檢查

根據資料計算:

指標公式基準
ARPD營收 / 下載量> $0.05 良好;> $0.20 優異
試用率試用次數 / 下載量> 20% 表示付費牆觸及率強
訂閱轉換率訂閱數 / 試用次數> 25% 為強勁
每訂閱營收營收 / 訂閱數取決於定價

輸出格式

表現摘要

📊 [App 名稱] — [時間區間]

下載量:     [N]  ([+/-X%] 與前期比較)
營收:       $[N] ([+/-X%])
訂閱數:     [N]  ([+/-X%])
試用次數:   [N]  ([+/-X%])
IAP 次數:   [N]  ([+/-X%])
試用→訂閱:  [X]%

熱門市場(以下載量排序):
  1. [國家] — [N] 次下載,$[N]
  2. [國家] — [N] 次下載,$[N]
  3. [國家] — [N] 次下載,$[N]

關鍵觀察:
- [趨勢代表的意義]
- [任何異常及可能原因]
- [發現的機會]

建議行動:
1. [根據資料的具體行動]
2. [根據資料的具體行動]

趨勢警示

當偵測到顯著變化(>20%)時,請標記出來:

⚠️  本週下載量下降 [X]%
    可能原因:[列出 2-3 個假設]
    後續步驟:[具體診斷行動]

常見問題

「為什麼我的下載量下降了?」

  1. 拉取每日趨勢——從何時開始下降?
  2. 檢查該日期是否有 App 更新
  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.

相關技能