Skip to main content

Account Health Score

The account health score is the composite output of evaluating all 93+ rules across 8 categories. It is stored in accounts.health_score (0-100) and updated every 5 minutes.

Composite Formula

health_score = SUM(category_score[i] * category_weight[i])
Where each category_score is:
category_score = SUM(rule_score[j] * rule_weight[j]) / SUM(rule_weight[j])

Default Category Weights

CategoryWeightContribution
Engagement0.1515%
Fit0.1010%
Intent0.1515%
Velocity0.1010%
Pipeline Health0.1515%
Relationship0.1010%
Risk0.1515%
Opportunity Quality0.1010%

Account Priority Score

A separate computed score (accounts.priority_score) that determines which accounts deserve immediate attention. Uses 8 variables:
VariableWeightInputScoring Logic
ARR Value20%account.arr500K+=100,500K+ = 100, 200K = 85, scaled down
Risk Urgency15%account.risk_scoreDirect pass-through of risk score
Expansion Potential15%whitespace_pctHigher whitespace = higher priority
Engagement Trend10%Engagement delta (-100 to +100)Mapped to 0-100 scale
Territory Impact10%territory_quota_impactQuota contribution percentage
Market Context10%budget_trend_yoy (Starbridge)Growing budget = 80, shrinking = 10
Strategic Alignment10%Strategic theme match (Starbridge)Match = 100, no match = 0
Tech Spend Propensity10%tech_spend_propensity (Starbridge)Direct pass-through, 50 if no data

Health Trend

The accounts.health_trend field stores the last 6 health score data points as a JSON array, enabling sparkline visualization in dashboards.

Engagement Rules (ENG-001 to ENG-012)

RuleNameWeightWhat It Measures
ENG-001Usage trend decline8Quarter-over-quarter usage trend
ENG-002Activity recency7Days since last recorded activity
ENG-003Activity volume (30d)6Count of activities in last 30 days
ENG-004Email and meeting engagement5Ratio of meetings/emails to total activities
ENG-005Average contact engagement6Average engagement_score across active contacts
ENG-006Product adoption depth7Average adoption % across purchased products
ENG-007Activity trend acceleration530-day activity count vs prior 60-day rate
ENG-008Login frequency6Account usage_depth metric
ENG-009NPS survey engagement4Whether account responded to NPS surveys
ENG-010Stakeholder breadth5Number of unique active contacts
ENG-011Support interaction frequency3Support ticket volume and escalation rate
ENG-012Feature breadth utilization5Products actively used vs products purchased