Home/Help Center/Member Intelligence: Reading the Matrix
AI & Intelligence 12 minโ€ขadvanced

Member Intelligence: Reading the Matrix

A technical deep dive into how Sovereign calculates Risk, Scores, and Value. Understand the algorithm behind the magic.

The Problem with "Activity"

Most community managers look at "Messages Per Day". This is a vanity metric. A user spamming "gm" 100 times is not valuable. A user writing one high-impact technical solution is high value.

Sovereign's Member Intelligence engine sees the difference.


1. The Engagement Score Algorithm

We don't just count messages. We weigh them.

$$ Score = (M \times 1) + (R \times 5) + (Rx \times 10) + (E \times 20) $$

  • M (Messages): Base volume.
  • R (Replies): Are they talking to people?
  • Rx (Reactions Received): Are people listening? (Upvotes, hearts).
  • E (Events): Did they attend a voice stage or gathering?

[!IMPORTANT] Decay: Scores decay over time. You cannot rest on your laurels. A legend who hasn't posted in 3 months will see their score drop, flagging them for re-activation.


2. Churn Risk: The Silent Killer ๐Ÿ“‰

How do we predict a user leaving before they leave? The churn-detector.ts job runs every midnight. It looks for Deviation from Baseline.

The Signals

  1. Velocity Drop: User usually posts 5x/day. Last week: 0.2x/day. -> Risk +20%.
  2. Sentiment Crash: User interaction shifted from "Joy" to "Neutral/Anger". -> Risk +15%.
  3. Network Isolation: User's top 3 friends have left the server. -> Risk +40% (Contagion effect).

The "At-Risk" Dashboard

When a user crosses 50% Risk, they appear in your dashboard.

  • Green: Safe (<30%)
  • Yellow: Watchlist (30-60%)
  • Red: Critical (>60%) - Act NOW.

3. Tags: Dynamic Segmentation

You are not building a mailing list. You are building a nation. Nations have subgroups.

Auto-Tags (The Bot does this)

  • whale: Lifetime Value > $1,000.
  • og: Joined in the first month.
  • lurker: Reads messages but never posts (High read count, low msg count).

Smart Targeting

When you send a Broadcast (DM or Announcement), targeting by tag is your superpower.

  • Scenario: You have a new "Developer API" product.
  • Action: Target dev + active + premium.
  • Result: 90% relevance. Zero spam complaints.

4. Identity Resolution (The Tech Stack)

How do we know User #999 is User #888?

  • Social Graph: We verify ownership via OAuth2.
  • Browser Fingerprinting: (Optional/GDPR compliant) If they visit your web dashboard.
  • Wallet Linking: If they connect an ETH/Solana wallet, we map it.

This Unified Identity is what allows you to offer "Cross-Platform Perks". A user subscribes on your Website, gets the role on Discord, and gets the private link on Telegram. Seamless.