# Asc Metrics

When the user wants to analyze their own app's actual performance data from App Store...

- Repository: https://github.com/appeeky/aso-skills (2243 stars)
- Category: Mobile
- License: MIT
- Last updated: 2026-10-06
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add appeeky/aso-skills --skill asc-metrics -g -a claude-code -y`
Codex: `npx skills add appeeky/aso-skills --skill asc-metrics -g -a codex -y`
Cursor: `npx skills add appeeky/aso-skills --skill asc-metrics -g -a cursor -y`
Gemini CLI: `npx skills add appeeky/aso-skills --skill asc-metrics -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add appeeky/aso-skills`

## Description

When the user wants to analyze their own app's actual performance data from App Store Connect, real downloads, revenue, IAP, subscriptions, trials, or country breakdowns synced via Appeeky Connect. Use when the user asks about "my downloads", "my revenue", "how is my app performing", "ASC data", "sales and trends", "my subscription numbers", "App Store Connect metrics", or wants to compare periods or top markets. For third-party app estimates, see app-analytics. For subscription analytics depth, see monetization-strategy.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ASC Metrics

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.

## 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](https://appeeky.com) and return.

## 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?**

## Fetching Data

### Step 1, List available apps

```bash
GET /v1/connect/metrics/apps
```

Match the user's app to an `app_apple_id` if not already known.

### Step 2, Get overview (portfolio)

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

### Step 3, Get app detail (single app)

```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](../../tools/integrations/appeeky-connect.md)

## Analysis Frameworks

### Period-over-Period Comparison

Fetch two equal-length windows and compare:

| Metric | Prior Period | Current Period | Change |
|--------|-------------|----------------|--------|
| 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

### Daily Trend Analysis

The rest: https://github.com/appeeky/aso-skills/blob/HEAD/skills/asc-metrics/SKILL.md