Advanced Features
Pro-level features for power users managing large or sophisticated loyalty programs.
Make sure you're comfortable with the Commands Reference and Configuration Guide before diving into these features.
KPI Compound Alerts
Compound alerts trigger when multiple conditions are met simultaneously. Use AND/OR logic to create sophisticated monitoring.
Creating a Compound Alert
/kpi compound-alert create name:"Server Health" conditions:"dau<100,streak<50" logic:AND
This alert fires when both conditions are true:
- Daily active users drops below 100 AND
- Streak retention drops below 50%
Logic Modes
| Mode | Behavior |
|---|---|
AND | All conditions must be true to trigger |
OR | Any condition being true triggers the alert |
Example Alerts
"Community at Risk" — Early warning system:
/kpi compound-alert create name:"Community at Risk" conditions:"dau<50,churn_rate>20,streak_retention<40" logic:OR
"Growth Plateau" — Detect stagnation:
/kpi compound-alert create name:"Growth Plateau" conditions:"new_user_conversion<10,events_per_active_user<2" logic:AND
Managing Compound Alerts
/kpi compound-alert list — See all compound alerts
/kpi compound-alert view name:"..." — View details
/kpi compound-alert toggle name:"..." enable:false — Disable temporarily
/kpi compound-alert history — See trigger history
/kpi compound-alert remove name:"..." — Delete alert
KPI Custom Metrics
Create formula-based metrics that combine built-in metrics using mathematical expressions.
Creating a Custom Metric
/kpi custom-metric create name:"Engagement Score" formula:"(dau*0.6)+(wau*0.4)"
Formula Syntax
Formulas can reference any built-in KPI metric by name and use standard math operators:
| Operator | Example |
|---|---|
+ - * / | Basic arithmetic |
() | Grouping |
| Metric names | dau, wau, streak_retention, etc. |
| Numbers | Constants like 0.6, 100 |
Example Custom Metrics
"Health Index" — Overall server health score (0-100):
/kpi custom-metric create name:"Health Index" formula:"(streak_retention*0.3)+(new_user_conversion*0.3)+(dau/wau*40)"
"Reward ROI" — Efficiency of reward spending:
/kpi custom-metric create name:"Reward ROI" formula:"events_per_active_user*repeat_event_rate"
Testing Before Creating
Test a formula without saving it:
/kpi custom-metric test formula:"dau*2+wau"
This shows the calculated result using current server data.
Managing Custom Metrics
/kpi custom-metric list — See all custom metrics
/kpi custom-metric view name:"..." — View details and current value
/kpi custom-metric edit name:"..." formula:"new formula" — Update formula
/kpi custom-metric remove name:"..." — Delete metric
KPI Presets
Save and share complete KPI configurations. Apply them to quickly set up monitoring on new servers.
Applying a Preset
/kpi preset list — See available presets
/kpi preset view name:"Gaming Server" — Preview what it configures
/kpi preset apply name:"Gaming Server" — Apply all KPIs at once
Creating Your Own Preset
After configuring your KPIs the way you want:
/kpi preset create name:"My Custom Setup" description:"Optimized for our 500-member server"
This saves your current KPI configuration (targets, alerts, custom metrics) as a reusable preset.
Managing Presets
/kpi preset list — See all presets
/kpi preset view name:"..." — Preview details
/kpi preset remove name:"..." — Delete preset
Role-Based Alert Routing
Route different severity levels to different roles and channels.
Setup
/kpi role-alerts set severity:critical role:@Admin channel:#critical-alerts
/kpi role-alerts set severity:warning role:@Moderator channel:#mod-alerts
/kpi role-alerts set severity:info role:@Staff channel:#staff-updates
How It Works
When a KPI alert triggers, the bot routes it based on severity:
- Critical → Mentions
@Adminin#critical-alerts - Warning → Mentions
@Moderatorin#mod-alerts - Info → Posts in
#staff-updates(no mention)
Managing
/kpi role-alerts list — View all routing rules
/kpi role-alerts remove severity:critical — Remove a routing rule
Scheduled Reports
Automate report delivery to any channel.
Setting Up
/reports schedule frequency:weekly channel:#admin-reports day:monday type:full
/reports schedule frequency:daily channel:#morning-brief type:stats
/reports schedule frequency:monthly channel:#leadership day:1 type:kpi
Report Types
| Type | Contents |
|---|---|
stats | User counts, engagement metrics, reward distribution |
kpi | KPI performance vs targets, trend arrows |
full | Combined stats + KPI + segments + recommendations |
Preview and Manage
/reports preview — See what the report looks like
/reports list — View active schedules
/reports disable — Turn off all reports
User Segments
Automatic user categorization for targeted engagement strategies.
Viewing Segments
/segments list — See all segment categories with counts
/segments view segment:whales — See users in a specific segment
Segment Categories
| Segment | Definition | Recommended Action |
|---|---|---|
whales | Top 10% earners | VIP perks, exclusive drops |
power_users | High activity, consistent engagement | Recognition, beta features |
new_users | Joined in last 7 days | Onboarding quests, welcome rewards |
at_risk | Activity declining (was active, now dropping) | Re-engagement drops, personal outreach |
dormant | No activity in 14+ days | Wake-up campaigns, special offers |
voice_regulars | Frequent voice channel users | Voice-specific perks, game nights |
Data Export
Export server data for external analysis.
Export Types
/export type:rewards period:month — Reward distribution history
/export type:users period:all — All user data
/export type:audit period:week — Audit log
/export type:config — Current server configuration
Audit Log with Filters
/audit — Recent 25 events
/audit user:@alice — Filter by user
/audit type:rewards — Filter by action type
/audit export:true — Export full log as CSV
/audit limit:100 — Last 100 events
Related Guides
- Commands Reference — Full command documentation
- Events & Rewards Guide — Event configuration deep-dive
- Analytics Guide — Understanding your analytics dashboard
- Sample Programs — Pre-built templates with KPI recommendations