Event Schema

Recommended analytics events for MiniApps

Event Schema

Track consistent events to power growth and quality decisions.

Core events

Event	When	Properties
MINI_APP_OPEN	App opened	source, version
PRIMARY_CTA_CLICK	Primary action clicked	cta_id, surface
AUTH_PROMPT	Auth prompt shown	reason, surface
AUTH_SUCCESS	Auth success	latency_ms, method
TX_SUBMIT	Transaction submitted	tx_type, network
TX_SUCCESS	Transaction confirmed	latency_ms, amount
ERROR	Error occurred	code, category, surface

Error categories

• network_offline
• auth_declined
• rate_limited
• contract_failure
• validation

Example payload

analytics.track("TX_SUCCESS", {
  tx_type: "mint",
  network: "base-mainnet",
  latency_ms: 12400,
  amount: "1",
});