Analytics API

Analytics API

Track custom events and analyze user behavior with powerful querying.

Tracking Events

// Track a custom event
await aethex.analytics.track({
  event: 'level_complete',
  properties: {
    level: 5,
    score: 12500,
    time_seconds: 180
  }
});

// Track with user context
await aethex.analytics.track({
  event: 'purchase',
  userId: 'user_abc',
  properties: {
    item: 'premium_pack',
    price: 9.99,
    currency: 'USD'
  }
});

Querying Analytics

// Get event counts
const data = await aethex.analytics.query({
  event: 'level_complete',
  groupBy: 'level',
  timeframe: 'last_7_days'
});

// Funnel analysis
const funnel = await aethex.analytics.funnel({
  steps: [
    { event: 'signup' },
    { event: 'tutorial_complete' },
    { event: 'first_purchase' }
  ],
  timeframe: 'last_30_days'
});