How It Works & FAQ

ASC Watcher · Architecture, Metrics & FAQ

A complete technical reference on how ASC Watcher signs requests locally, calibrates App Store Connect metrics, and protects your credentials.

Synchronized with llms.en.txt / llms-full.en.txt from site.config.json.

1. What It Is

ASC Watcher is a local-first App Store Connect sales, first-time download, and In-App Purchase analytics dashboard for indie developers and teams on iOS and Android. With zero accounts and zero middleman servers, your .p8 private key, Issuer ID, Key ID, and Vendor Number stay strictly on your device.

2. Core Architecture

2.1 On-Device ES256 JWT Signing

ASC Watcher parses your PKCS#8 (.p8) ECDSA P-256 key on-device, generates short-lived ES256 JWT tokens, and queries https://api.appstoreconnect.apple.com/v1/salesReports and /v1/apps directly over HTTPS, decompressing GZIP TSV streams in memory.

2.2 Calibrated First-Time Downloads vs. IAP vs. Updates

Apple's raw TSV reports include multiple Product Type Identifiers. ASC Watcher strictly separates:

2.3 Multi-Currency Conversion & Top-2 Original Currencies

Switch seamlessly between 9 display currencies (USD, CNY, EUR, GBP, JPY, HKD, TWD, AUD, CAD) while viewing up to the top 2 original settlement currencies sorted by converted value (e.g., $12.83 ($6.79 + ₹575.55)).

2.4 Interactive Bar Drill-Down & Home Screen Widget

Tap any bar on a chart to lock it and inspect the exact apps, IAP items, or countries contributing to that day's total. Add the 4×2 Home Screen Widget to monitor net developer proceeds and downloads right from your phone's home screen.

3. Comparison

DimensionASC WatcherTypical Alternatives
Key & financial security.p8 key stays on-device; direct JWT calls to AppleRequires uploading .p8 key to third-party cloud servers
Download metric accuracySeparates first-time downloads, IAPs, and updates to match ASC webOften mixes version updates (Type 7) into total downloads
Multi-currency display9 target currencies + top 2 original settlement currenciesSingle converted number or broken symbols on mixed currencies
Chart drill-down & widgetTap any bar for item breakdown + 4×2 Home Screen WidgetStatic charts without breakdown or widget

4. FAQ

Does ASC Watcher upload my .p8 private key or sales data to your servers?

Never. ASC Watcher has no user accounts and no backend servers of its own. Your Issuer ID, Key ID, Vendor Number, and .p8 private key are stored strictly on your device, and ES256 JWT tokens are signed locally to communicate directly with Apple (api.appstoreconnect.apple.com).

Why can I see data before configuring an API key?

When launched without credentials, ASC Watcher provides a built-in Demo Mode with realistic sample data so you can explore every chart, currency switch, and breakdown immediately. Configure your real key anytime under More → Credentials Setup.

What role should I assign to my App Store Connect API Key?

We recommend creating a key under App Store Connect → Users and Access → Integrations with read-only 'Sales and Reports' or 'Finance' access, following the principle of least privilege.

How do I add the Home Screen Widget?

Go to More → Home Screen Widget to preview the widget and tap 'Pin Widget to Home Screen', or long-press an empty area on your phone's home screen and select ASC Watcher from the system widget gallery.

5. Links