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:
- First-Time Downloads:
1,1F,1T,F1,1-B,F1-B; - In-App Purchases & Subscriptions:
IA1,IA9,IAY,FI1,IA1-M,IAY-M; - Updates:
7,7F,7T,F7(excluded from download totals so numbers match App Store Connect web).
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
| Dimension | ASC Watcher | Typical Alternatives |
|---|---|---|
| Key & financial security | .p8 key stays on-device; direct JWT calls to Apple | Requires uploading .p8 key to third-party cloud servers |
| Download metric accuracy | Separates first-time downloads, IAPs, and updates to match ASC web | Often mixes version updates (Type 7) into total downloads |
| Multi-currency display | 9 target currencies + top 2 original settlement currencies | Single converted number or broken symbols on mixed currencies |
| Chart drill-down & widget | Tap any bar for item breakdown + 4×2 Home Screen Widget | Static 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
- Devlog: Devlog
- Privacy Policy: Privacy Policy
- Terms of Service: Terms of Service
- Support: Support