Skip to main content
The Analytics tab in Dev Portal shows how people discover, install, and use Mini Apps published by your wallet. Publishing is free. Analytics requires a one-time paid unlock for that wallet.

​
Unlock

  1. Open Dev Portal → Analytics.
  2. Sign in with your publisher wallet (one-time SIWE-style message; proves wallet ownership via the session cookie).
  3. Pay 10 USDC on Base (transfer to the uOS treasury).
  4. Wait for confirmations (default 3 blocks), then the client claims the unlock with the tx hash.
The unlock is stored as a wallet entitlement for product analytics. It is one-time and permanent for that wallet: every app published by that wallet is included. There is no subscription.
Analytics tab before unlock: one-time 10 USDC on Base
The server verifies the USDC transfer on-chain (from your session wallet to the treasury, amount ≥ 10 USDC, unused tx hash). If activation stalls after you pay, use Retry claim. The payment is already on-chain.

​
What you get

After unlock, the dashboard loads from /api/dev/analytics. You can filter by one of your apps and by window (7d / 30d / 90d). The window applies to daily activity, opens by source, sessions, and retention. Headline totals and the funnel are lifetime. Active wallets always show last 7 days (with a last-30-days hint).
Unlocked dashboard: headline stats, daily series, funnel, and sources

​
How events are recorded

uOS records analytics server-side when people use the App Store and Mini App windows (views, installs, opens, uninstalls, sessions). The client posts events to /api/analytics/events; the server inserts them. Wallet attribution comes from the HTTP-only session cookie when present; anonymous events can still be counted without a wallet. Session length is sent when a Mini App window closes (or unmounts) and the session lasted more than 1 second.

​
Privacy

  • The analytics API returns aggregated counts only. It does not return lists of wallet addresses.
  • Access requires both a signed-in session for your publisher wallet and the analytics entitlement.
  • You only see apps owned by that wallet.

​
Good to know

  • Empty state: if you have no published apps yet, the dashboard says analytics start once an app is live.
  • Retention cohorts need installs attributed to signed-in users plus return opens; otherwise the retention table stays empty.
  • Payment age is capped (default 24 hours from block time); very old tx hashes cannot be claimed.

​
Next

Publish an app if you are not live yet, or open Dev Portal in uOS to unlock Analytics.