Communitygithub.com

ASC Metrics (App Store Connect 분석)

사용자가 App Store Connect에서 실제 앱 성과 데이터(다운로드, 매출, 인앱 구매, 구독, 체험판, 국가별 분석)를 분석하고자 할 때 사용합니다.

ASC Metrics (App Store Connect 분석)란 무엇인가요?

이 스킬은 사용자가 Appeeky에 연동된 공식 App Store Connect 데이터를 기반으로 앱 성과를 정밀하게 분석할 수 있도록 지원합니다. 추정치가 아닌 실제 데이터를 기반으로 하여, 다운로드, 매출, 인앱 구매, 구독 및 체험판 전환율 등을 기간별, 국가별로 비교하고 트렌드를 파악할 수 있습니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용되며, 사용자가 "내 앱 다운로드", "매출 추이", "구독 분석" 등과 같은 질문을 할 때 자동으로 데이터를 조회하고 인사이트를 제공합니다. SKILL.md 문서에 정의된 API 호출 절차와 분석 프레임워크를 따라, 기간 대비 비교, 일별 트렌드, 수익성 분석, 국가별 성과 등을 체계적으로 분석하여 실행 가능한 권장 조치를 제시합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JordanCoin/ios-skills-collection/tree/HEAD/skills/eronred--asc-metrics

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ASC Metrics (App Store Connect 분석)은(는) 무엇을 하나요?

사용자의 App Store Connect 공식 데이터 (Appeeky에 연동된 정확한 다운로드, 매출, 인앱 구매, 구독, 체험판)를 분석합니다. 이는 추정치가 아닌 실제 데이터입니다.

필수 조건

  • ASC가 연결된 Appeeky 계정 (설정 → 통합 → App Store Connect)
  • Indie 플랜 이상 (요청당 2 크레딧)
  • 데이터는 매일 밤 동기화되며, 최대 90일 기록 제공

ASC가 연결되어 있지 않으면 사용자에게 appeeky.com/settings에서 연결하도록 안내하고 종료합니다.

초기 평가

  1. app-marketing-context.md 파일 확인하여 앱 컨텍스트 파악
  2. 질문: 무엇을 분석하시겠습니까? (다운로드, 매출, 구독, 국가별 분석, 트렌드 비교)
  3. 질문: 어느 기간을 원하시나요? (기본값: 최근 30일)
  4. 질문: 특정 앱인가요, 아니면 모든 앱인가요?

데이터 가져오기

1단계 — 사용 가능한 앱 목록

GET /v1/connect/metrics/apps

사용자의 앱을 app_apple_id와 매칭합니다. (아직 알려지지 않은 경우)

2단계 — 개요 확인 (포트폴리오)

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

3단계 — 앱 상세 정보 (단일 앱)

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[]에서 다음을 식별합니다.

  • 급증 — 기능, 업데이트 또는 언론 노출이 원인인가?
  • 급감 — 앱 업데이트, 계절성 또는 알고리즘 변경과 연관되는가?
  • 트렌드 방향 — 7일 이동 평균 대비 이전 7일

국가별 분석

countries[]를 다운로드 및 매출 기준으로 정렬합니다.

  1. 다운로드 상위 5개국 — 해당 시장에 ASO(앱 스토어 최적화)를 투자하고 있습니까?
  2. 매출 상위 5개국 — ARPD(다운로드당 평균 매출)가 높으면 ASO 우선순위 지정
  3. 다운로드 많고 매출 낮은 국가 — 수익화가 약한 시장
  4. 다운로드 적고 매출 높은 국가 — 활용도가 낮은 프리미엄 시장 (현지화 필요)

수익성 품질 점검

데이터에서 다음을 계산합니다.

지표공식기준
ARPD (다운로드당 평균 매출)매출 / 다운로드> $0.05 양호; > $0.20 우수
체험판 전환율체험판 / 다운로드> 20%면 페이월 도달률 양호
구독 전환율구독 / 체험판> 25%면 양호
구독자당 매출매출 / 구독가격 정책에 따라 다름

출력 형식

성과 요약

📊 [앱 이름] — [기간]

다운로드:     [N]  ([+/-X%] vs 이전 기간)
매출:       $[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.

관련 스킬