โ† Back to Home

๐Ÿง  Intelligence Layers & Health Scores

Transform raw biomarkers into actionable insights with scores, archetypes, trends, and comparisons

From Raw Data to Actionable Intelligence

Raw biomarkers tell you what happened. Steps taken, hours slept, heart rate measuredโ€”these are valuable data points, but they're just the beginning.

Intelligence layers tell you what it means. Is this user's sleep quality improving or declining? Are they a "Consistent Early Riser" or "Highly Irregular Sleeper"? How does their activity compare to their demographic group?

By applying advanced analytics and pattern recognition to biomarker data, intelligence layers provide:

  • Scores: Normalized 0-1 values for holistic health assessment
  • Archetypes: Behavioral labels that capture lifestyle and persona
  • Trends: 4-week rolling analysis showing directional change
  • Comparisons: Context against global, demographic, and personal baselines

This transforms health data from passive monitoring into proactive insights that drive engagement, personalization, and outcomes.

Why Behavioral Intelligence Matters

Behavioral archetypes and insights represent a fundamentally different kind of intelligence than scores or raw metrics. While a score tells you how much (0.7 sleep quality, 8,247 steps), behavioral intelligence tells you who someone is and how they behave over time.

The Power of Behavioral Identity

People don't identify with numbers, they identify with behaviors.

Tell a user "Your sleep score is 0.68" and they nod but don't internalize it. Tell them "You're a Consistent Early Riserโ€”your routine is your superpower" and they recognize themselves. This is behavioral identity: a label that captures lifestyle patterns and creates meaning. When users see their behavioral archetype, they understand not just their current state, but their typical patterns and tendencies.

Prediction requires understanding patterns, not just data points.

A single night's sleep score doesn't predict much. But "Highly Irregular Sleeper"โ€”someone whose sleep varies wildly from night to nightโ€”carries meaningful information. This person is more vulnerable to burnout, mental health fluctuations, and disengagement. The archetype captures weeks or months of behavior compressed into a single meaningful label that enables proactive intervention.

Personalization at scale requires automated segmentation.

Without behavioral archetypes, you face a choice: send generic messages to everyone (low engagement) or manually segment users (doesn't scale). Archetypes solve this by automatically categorizing behavioral patterns. "Sedentary" users need gentle encouragement. "Weekend Warriors" need injury prevention guidance. "Inconsistent" users need routine-building support. The archetype becomes the basis for intelligent, automated personalization across your entire user base.

The Challenge of Creating Meaningful Behavioral Intelligence

Classification complexity goes beyond simple thresholds.

You can't just say "sleep duration < 6 hours = poor sleeper." Meaningful behavioral archetypes require analyzing regularity (week-to-week consistency), continuity (nightly interruptions), debt (cumulative sleep deficit), circadian alignment (biological clock synchronization), and recovery patterns (physical and mental restoration). Each archetype represents a cluster in this multi-dimensional behavioral space, where boundaries are fuzzy and context-dependent.

Validation demands longitudinal data and clinical expertise.

Creating archetypes that are statistically accurate is straightforward. Creating archetypes that are clinically meaningful and predictively valuable is exceptionally difficult. You need longitudinal data showing how behaviors correlate with outcomes over months or years. You need clinical expertise to ensure archetypes align with established behavioral science. You need validation studies proving that your classifications actually predict what you claim they predict. This is why Sahha's archetypes were developed in partnership with the University of Otago using thousands of participants tracked over extended periods.

Behavioral patterns evolve and models degrade.

A behavioral model trained on pre-pandemic data may not apply to post-pandemic behavior patterns. Seasonal changes affect activity and sleep. Demographic shifts alter what "typical" looks like. Population behavior evolves. Maintaining accurate behavioral intelligence means continuous model updates, retraining on new data, incorporating latest research, and validating that classifications remain predictive. This is an ongoing commitment, not a one-time development effort.

What Validated Behavioral Intelligence Enables

When behavioral archetypes are properly developed and validated, they unlock capabilities that raw biomarkers and simple scores cannot provide:

  • Early warning systems: Detect behavioral changes that precede negative outcomes (churn, health deterioration, disengagement)
  • Contextual recommendations: Tailor guidance to behavioral patterns, not just current state
  • Meaningful communication: Speak to users about their identity and tendencies, not just numbers
  • Clinical credibility: Use classifications backed by peer-reviewed research and validation studies
  • Population insights: Understand behavioral distribution across your user base for product decisions

Behavioral intelligence transforms health data from measurement into understanding. It's the difference between knowing someone walked 8,247 steps today and knowing they're a "Weekend Warrior" who needs weekday consistency coaching. This is the foundation for truly personalized health applications.

๐ŸŽฏ Health Scores (5 Core Scores)

360ยฐ measures of health and wellness โ€ข Normalized 0.0-1.0 range โ€ข No wearable required

Score Name Range Key Factors Description Wearable?
Wellbeing 0.0-1.0 steps, active_hours, active_calories, intense_activity_duration, extended_inactivity, floors_climbed, sleep_duration, sleep_regularity, sleep_continuity, sleep_debt, circadian_alignment, physical_recovery, mental_recovery Holistic measure combining physical, mental, and behavioral health data ๐ŸŸข No
Activity 0.0-1.0 steps, active_hours, active_calories, intense_activity_duration, extended_inactivity, floors_climbed Evaluates daily physical activity levels and intensity ๐ŸŸข No
Sleep 0.0-1.0 sleep_duration, sleep_regularity, sleep_continuity, sleep_debt, circadian_alignment, physical_recovery, mental_recovery Assesses sleep quality, duration, regularity, and stages ๐ŸŸข No
Mental Wellbeing 0.0-1.0 steps, active_hours, extended_inactivity, activity_regularity, sleep_regularity, circadian_alignment Measures mental wellness through behavioral pattern analysis ๐ŸŸข No
Readiness 0.0-1.0 sleep_duration, physical_recovery, mental_recovery, sleep_debt, walking_strain_capacity, exercise_strain_capacity, resting_heart_rate, heart_rate_variability Gauges daily readiness and recovery metrics ๐ŸŸข No

Why Scores Matter

  • Simplify complexity: Convert 50+ biomarkers into 5 actionable scores
  • Enable thresholds: Trigger interventions when scores drop below 0.6 or rise above 0.8
  • Track progress: Show users their wellness improving from 0.4 to 0.7 over time
  • Predict outcomes: Sleep scores below 0.5 correlate with increased churn risk
  • Personalize experiences: Adjust workout recommendations based on Readiness score

๐Ÿท๏ธ Behavioral Archetypes (14 Labels)

Labels that capture persona and lifestyle โ€ข Weekly/Monthly periodicity โ€ข Smartphone-only data

Archetype Type Periodicity Possible Values Description Wearable?
activity_level Ordinal Weekly, Monthly sedentary, lightly_active, moderately_active, highly_active Overall level of physical activity ๐ŸŸข No
exercise_frequency Ordinal Weekly, Monthly rare_exerciser, occasional_exerciser, regular_exerciser, frequent_exerciser How often the individual exercises ๐ŸŸข No
mental_wellness Ordinal Weekly, Monthly poor_mental_wellness, fair_mental_wellness, good_mental_wellness, optimal_mental_wellness Mental wellness and resiliency ๐ŸŸข No
overall_wellness Ordinal Weekly, Monthly poor_wellness, fair_wellness, good_wellness, optimal_wellness Overall wellbeing across all health aspects ๐ŸŸข No
primary_exercise Categorical Weekly, Monthly See possible exercise types Most frequently performed exercise ๐ŸŸข No
primary_exercise_type Categorical Weekly, Monthly strength_oriented, cardio_oriented, mind_body_oriented, hybrid_oriented, sport_oriented, outdoor_oriented Categorizes primary exercise type ๐ŸŸข No
secondary_exercise Categorical Weekly, Monthly See possible exercise types Second most frequently performed exercise ๐ŸŸข No
sleep_duration Ordinal Weekly, Monthly very_short_sleeper, short_sleeper, average_sleeper, long_sleeper Typical sleep duration relative to norms ๐ŸŸข No
sleep_efficiency Ordinal Weekly, Monthly highly_inefficient_sleeper, inefficient_sleeper, efficient_sleeper, highly_efficient_sleeper Sleep maintenance effectiveness ๐ŸŸก Yes
sleep_pattern Categorical Weekly, Monthly consistent_early_riser, inconsistent_early_riser, consistent_late_sleeper, inconsistent_late_sleeper, early_morning_sleeper, chronic_short_sleeper, inconsistent_short_sleeper Overall sleep behavior patterns ๐ŸŸข No
sleep_quality Ordinal Weekly, Monthly poor_sleep_quality, fair_sleep_quality, good_sleep_quality, optimal_sleep_quality Long-term sleep quality assessment ๐ŸŸข No
sleep_regularity Ordinal Weekly, Monthly highly_irregular_sleeper, irregular_sleeper, regular_sleeper, highly_regular_sleeper Consistency in sleep timings ๐ŸŸข No
bed_schedule Ordinal Weekly, Monthly very_early_sleeper, early_sleeper, late_sleeper, very_late_sleeper Typical bedtime patterns ๐ŸŸข No
wake_schedule Ordinal Weekly, Monthly very_early_riser, early_riser, late_riser, very_late_riser Typical wake-up time patterns ๐ŸŸข No

Why Archetypes Matter

  • Segmentation: Group users by "highly_active + regular_sleeper" for targeted content
  • Personalization: Recommend yoga to "mind_body_oriented" users, HIIT to "cardio_oriented"
  • Churn prediction: "Highly Irregular Sleeper" with "Poor Mental Wellness" = high-risk segment
  • Content matching: Show early morning classes to "very_early_riser" users
  • Community building: Connect users with similar archetypes (e.g., "Night Owl Runners")

Why Trends Matter

  • Early intervention: Detect declining sleep quality 2-3 weeks before self-reporting
  • Progress tracking: Show users "Your activity is increasing by 15% this month!"
  • Churn prediction: 3 consecutive weeks of decreasing wellbeing = intervention trigger
  • Coaching automation: Send "Your sleep regularity is improvingโ€”keep it up!" messages
  • Clinical monitoring: Alert clinicians when mental wellbeing trends downward

๐Ÿ” Comparisons (Global, Demographic, Baseline)

Contextualize metrics with 3 reference points โ€ข Percentile rankings โ€ข 5 scores + 6 biomarkers

How Comparisons Work

Comparisons provide three distinct reference points to contextualize metric values:

  • Global: Comparison against global population averages
  • Demographic: Comparison against people with similar characteristics (e.g., age and gender)
  • Baseline: Comparison against individual's historical average over last 30 days

Each comparison includes: reference group's average value, percentile position, absolute and percentage differences, and descriptive state label (very_low, low, average, high, very_high).

Category Name Description Unit Higher = Better?
SCORES (5 total)
score sleep Overall sleep quality index โœ… Yes
score activity Physical activity and movement levels index โœ… Yes
score readiness Body's recovery state and preparedness for exertion index โœ… Yes
score wellbeing Holistic health combining sleep and activity index โœ… Yes
score mental_wellbeing Mental wellbeing state based on behavioral patterns index โœ… Yes
BIOMARKERS (6 total)
biomarker steps Daily step count count โœ… Yes
biomarker sleep_duration Total time spent asleep minute โœ… Yes
biomarker heart_rate_resting Resting heart rate bpm โŒ No (lower is better)
biomarker heart_rate_variability_sdnn HRV measured as SDNN ms โœ… Yes
biomarker heart_rate_variability_rmssd HRV measured as RMSSD ms โœ… Yes
biomarker vo2_max Maximum oxygen uptake mL/kg/min โœ… Yes

Why Comparisons Matter

  • Social motivation: "Your activity is in the top 15% of your age group!"
  • Personalized goals: Set targets based on demographic averages, not generic numbers
  • Progress celebration: "You're sleeping 20% better than your 30-day baseline!"
  • Risk stratification: Users in bottom 10th percentile for sleep quality need intervention
  • Gamification: Unlock badges for reaching 75th percentile in wellbeing score

๐Ÿ’ก Real-World Applications

๐Ÿ‹๏ธ Fitness Apps

  • Use Readiness score to adjust workout intensity
  • Segment users by exercise_frequency archetype
  • Alert when activity trends decrease for 2+ weeks
  • Show demographic comparisons for motivation

๐Ÿข Corporate Wellness

  • Track wellbeing scores across departments
  • Identify "poor_mental_wellness" archetype employees
  • Monitor sleep quality trends during busy seasons
  • Compare teams to baseline performance

๐Ÿฅ Digital Health

  • Use mental wellbeing score for screening
  • Classify patients by sleep pattern archetype
  • Alert clinicians to declining trends
  • Compare patient progress to demographic norms

๐ŸŽฎ Health Gaming

  • Award points based on score improvements
  • Match players by activity_level archetype
  • Create challenges around trend improvement
  • Show global comparison leaderboards

Source Attribution

All intelligence layer data (scores, archetypes, trends, comparisons) is sourced from Sahha API Documentation. Sahha is a leading health data intelligence platform that transforms biomarkers into actionable insights for health applications.