Campaign Health Scoring

Campaign Health Scoring is Smart Cycle Discounts’ intelligent system for analyzing your campaign configuration and providing actionable feedback. Understanding how it works helps you create more effective campaigns.

How Health Scoring Works #

Every campaign starts with a perfect score of 100 points. The system then analyzes various aspects of your configuration and applies penalties for issues or concerns it finds. The final score determines the campaign’s health status.

Score Calculation #

Final Score = 100 - (Sum of all penalties)
Minimum Score = 0 (score cannot go negative)

Health Status Levels #

Score Range	Status	Badge Color	Meaning
90-100	Excellent	Green	Campaign is optimally configured
70-89	Good	Blue	Well configured with minor suggestions
50-69	Fair	Yellow	Some issues worth reviewing
30-49	Poor	Orange	Significant issues affecting performance
0-29	Critical	Red	Serious problems requiring attention

Note: Campaigns with critical issues always show “Critical” status regardless of numeric score.

Penalty Categories #

Issues are classified by severity, with different penalty amounts:

Severity	Penalty	Example Issues
Critical Severe	-25 points	Deleted products, impossible configuration
Critical Standard	-15 points	Invalid product IDs, draft products only
High	-10 points	Very high discounts (90%+), all products out of stock
Medium-High	-8 points	Price changes detected, stock warnings
Medium	-5 points	Low stock on discounted products
Low	-3 points	Generic campaign name, missing description

What Gets Analyzed #

Product Checks #

Check	Issue	Severity
Product Existence	Selected products have been deleted	Critical Severe
Product Status	Products are drafts or private	Critical Standard
Stock Status	All products are out of stock	High
Low Stock	Products have ≤10 items in stock	Medium
Stock Risk	Stock may not meet expected demand	Medium-High
Price Changes	Product prices changed since campaign creation	Medium-High

Discount Checks #

Check	Issue	Severity
Discount Value	Discount is 90% or higher	High
High Discount	Discount is 70-89%	Medium
Sweet Spot	Discount is 50% or less	No penalty (optimal)
Fixed Amount	Discount exceeds product prices	Medium-High

Coverage Checks #

Coverage Rate	Status	Penalty
70%+ products discounted	Excellent	None
50-69% products discounted	Good	-3 points
30-49% products discounted	Fair	-5 points
Under 30% products discounted	Low	-8 points

Schedule Checks #

Check	Issue	Severity
Duration	Campaign is less than 24 hours	Low
Long Duration	Campaign exceeds 30 days	Low
Recurring Span	Recurring extends beyond 6 months	Medium
Past End Date	End date has already passed	Critical Standard

Configuration Checks #

Check	Issue	Severity
Campaign Name	Generic name like “New Campaign”	Low
Description	No description provided	Low
Badge Text	Badge text is empty or too long	Low

Proportional Penalties #

For issues affecting multiple products, penalties scale based on impact:

Products Affected	Penalty Applied
75% or more	100% of base penalty
50-74%	75% of base penalty
25-49%	50% of base penalty
Under 25%	25% of base penalty

This means campaigns with only a few problem products won’t be heavily penalized.

Health Score Best Practices #

Achieving Excellent (90+) #

• Use descriptive campaign names
• Add campaign descriptions
• Keep discounts at 50% or less
• Ensure products are in stock
• Set reasonable campaign durations
• Avoid scheduling conflicts

Common Issues and Fixes #

Issue	Fix
Low stock warnings	Restock products or adjust selection
High discount warning	Consider a lower percentage
Generic name	Rename to something descriptive
Long recurring span	Set an end condition
Price change detected	Review and confirm discount still makes sense

Interpreting Recommendations #

The health system provides recommendations in three categories:

Critical (Must Fix) #

These issues prevent the campaign from functioning. You cannot launch as “active” until resolved.

Warnings (Should Review) #

These won’t prevent launch but may affect performance. Review and decide if action is needed.

Suggestions (Nice to Have) #

Improvements that could enhance your campaign. Optional but recommended.

Health Score in Different Locations #

The health score appears in multiple places:

• Wizard Review Step: Full analysis with all details
• Dashboard Health Widget: Aggregate health of all campaigns
• Campaigns List: Health indicator per campaign
• Campaign Overview Panel: Health summary with key issues

Automatic Health Updates #

Health scores are recalculated:

• When you open the Review step
• When you view campaign details
• When products or prices change in your store
• On the dashboard refresh

This ensures you always see the current health status based on actual store data.