Skip to main content

Analytics & Reporting

Track your loyalty program's performance with comprehensive analytics tools.

Server Statistics

Weekly Overview

/stats

Shows:

  • Total active users
  • LTZ distributed
  • Event breakdown
  • Top earners
  • Growth trends

Different Time Periods

/stats period:day      # Daily stats
/stats period:week # Weekly stats (default)
/stats period:month # Monthly stats

Breakdowns

/stats breakdown:events   # Event-by-event breakdown
/stats breakdown:users # User segment breakdown

Audit Logging

Every admin action and reward is logged.

View Recent Activity

/audit                    # Last 25 events
/audit user:@user # Filter by user
/audit type:config # Filter by action type
/audit type:rewards # Reward distributions

Export Logs

/audit export:true        # Download as CSV

What's Logged

  • Configuration changes
  • User enable/disable actions
  • Reward distributions
  • Setup changes
  • Event creation/edits

Data Export

Export data for external analysis or backups.

Export Types

/export type:rewards period:month    # Reward history
/export type:audit period:week # Audit log
/export type:users # User database
/export type:config # Full config backup

User Segments

The bot automatically categorizes users into actionable segments.

View Segments

/segments                        # View all segment summaries
/segments view segment:at_risk # See users in a segment

Automatic Segments

SegmentCriteriaSuggested Action
🐋 WhalesTop 10% by LTZVIP treatment
Power UsersHigh daily activityPotential moderators
🆕 New UsersJoined < 7 daysOnboarding focus
⚠️ At RiskInactive 7+ daysRe-engagement needed
💤 DormantInactive 30+ daysWin-back campaigns
🎤 Voice Regulars5+ voice sessions/weekVoice event targets

Using Segments

For at-risk users:

  • Create special drops targeting this segment
  • Send re-engagement announcements
  • Consider welcome-back bonuses

For whales:

  • Offer VIP perks
  • Consider for ambassador programs
  • Gather feedback on program

KPI Tracking

Track performance against targets.

Set a KPI

/kpi set metric:daily_active_users target:500 period:week
/kpi set metric:streak_retention target:70 alert_threshold:80

Available Metrics

MetricDescriptionTypical Target
daily_active_usersUsers claiming in 24h100
weekly_active_usersUsers claiming in 7 days500
streak_retention% maintaining streaks60%
new_user_conversion% of new users engaging50%
voice_participation% using voice channels30%
reward_efficiencyAvg LTZ per active uservaries
churn_rate% becoming inactive20%
top_10_concentration% LTZ held by top 10%40%

View KPIs

/kpi list              # All KPIs
/kpi report # Performance report

KPI Alerts

Set alert thresholds to get notified when KPIs drop:

/kpi set metric:daily_active_users target:500 alert_threshold:80

When DAU drops below 400 (80% of 500), you'll get an alert in your admin channel.

Enable/Disable KPIs

/kpi enable metric:daily_active_users
/kpi disable metric:churn_rate
/kpi remove metric:old_metric

Export KPI Data

/kpi export format:csv
/kpi export format:json start_date:2024-01-01

Community Goals

Set server-wide goals for your community.

Create a Goal

/goals set name:"Q1 Growth" type:users target:1000 deadline:2024-03-31

Goal Types

TypeSynced With
usersweekly_active_users KPI
daudaily_active_users KPI
ltz_distributedreward_efficiency KPI
streak_retentionstreak_retention KPI
customNot synced

Track Progress

/goals progress        # View goal progress
/goals celebrate # Celebrate completed goals

Scheduled Reports

Automate analytics delivery to your team.

Schedule a Report

/reports schedule frequency:weekly channel:#admin-stats day:monday

Preview Format

/reports preview

Disable Reports

/reports disable

Leaderboards

Display rankings across multiple metrics.

View Leaderboard

/leaderboard metric:ltz_earned period:weekly

Available Metrics

MetricDescription
ltz_earnedTotal LTZ earned
activity_scoreCombined engagement
claims_countTotal claims
streak_currentCurrent streak
voice_minutesVoice channel time

Time Periods

  • daily
  • weekly
  • monthly
  • all_time

Best Practices

Weekly Review Checklist

  1. Check /stats for overall health
  2. Review /segments view segment:at_risk for churn risks
  3. Check /kpi report against targets
  4. Export /audit for compliance review

Monthly Review Checklist

  1. Export all data for records
  2. Review KPI trends
  3. Adjust reward amounts based on data
  4. Plan engagement events for declining metrics