Scorecard Marketing Skill

A proven 4-step system for generating qualified leads through interactive assessments that arrive with rich data about each prospect.

Core Principle

Everything is downstream from lead generation. People buy to resolve psychological tension between their current reality and desired reality — a scorecard awakens dormant desires by asking revealing questions.

The foundation: Active searchers are harder to sell to (already decided, set budget); people with dormant desires buy from whoever helped them uncover the need. Interactive assessments create psychological engagement static content cannot — which is why they convert several times better than a PDF download (see Conversion Benchmarks (#conversion-benchmarks)).

Scoring

Goal: 10/10. Score a funnel against the six Quick Diagnostic (#quick-diagnostic) rows: score = round(satisfied_rows / 6 × 10). Read the bands as: 9-10 = all six pass (dormant-desire hook, email captured first, scored categories, unique per-tier content and CTA, tier-segmented follow-up); 5-7 = the funnel exists but generic results or late email capture cost it 2-3 rows; ≤3 = no concept hook or no scoring. Always give the current score and the specific rows to close to reach 10/10.

The 4-Step Scorecard System

1. Landing Page

Core concept: The landing page exists for one purpose: get visitors to start the questionnaire. It must create enough curiosity and promise enough value that clicking "Start" feels irresistible.

Why it works: A concept hook taps a dormant desire; framing around a score triggers the primal drive to measure, rank, and improve. Curiosity plus low commitment ("takes 3 minutes") removes friction.

Key insights:

• The concept hook is the single most important element — it defines what visitors score themselves on. The 5 hook types: moving toward (goal), pain removal, readiness (decision validation), category (compare yourself to a standard), knowledge (test what you know)
• "Moving toward" hooks ("Are you ready to [goal]?") outperform fear-based hooks
• The 3 Cs — Clarity, Credibility, Connection — must all be present
• Bonuses (free book, consultation, report) lift completion; a time expectation ("less than 3 minutes") reduces abandonment

Product applications:

Copy patterns:

• "[HEADLINE: Concept hook + promise] Are you ready to [desired outcome]?"
• "Answer [X] quick questions to discover [specific insight] and get personalized recommendations"
• "[CTA BUTTON] Start the Quiz (Takes less than 3 minutes)"

Ethical boundary: The hook must promise value the assessment actually delivers — never bait-and-switch into a sales pitch disguised as results.

See references/industry-examples.md when you need a starting hook for a specific niche — 50+ scorecard concepts and landing-page headlines across industries.

2. Questionnaire

Core concept: The questionnaire collects lead data while providing a gamified experience: capture contact information first, then ask scored questions grouped into categories that surface pain points, desires, and qualification signals.

Why it works: People enjoy answering questions about themselves (self-referential encoding), and capturing email before questions retains the lead even on abandonment. Scored categories make results feel scientific, increasing trust in the recommendations.

Key insights:

• Lead capture form goes first (name, email, optional phone)
• Question count scales with funnel stage: 8-15 cold-to-warm, 20-50 warm-to-sales, 30-150 client-to-fan
• Group questions into 2-7 measurable categories; assign 1-5 points per answer, weighting significant answers higher
• Add qualifying questions (budget, urgency, company size) in an "Uncategorised" group
• Avoid salesy, leading, lookup, and jargon questions

Product applications:

Copy patterns:

• Use "you" language: "How confident are you in your..." not "Rate your confidence level in..."
• Progress indicators ("Question 5 of 12") reduce abandonment; "Almost done!" maintains momentum
• Category names should be meaningful to the respondent, not internal jargon

Ethical boundary: Don't collect data you won't use to improve their results — every qualifying question (budget, urgency, size) must visibly shape the recommendation, not just route them to sales.

See references/psychology.md when writing or critiquing questions — the tension taxonomy (pain/desire/frustration), the 4-6 quantification sweet spot, and the personalization stats.

3. Results Page

Core concept: The results page delivers personalized value based on the respondent's score, creating tension between where they are and where they could be, with a clear next step calibrated to their tier.

Why it works: Scored, personalized results feel more valuable than generic advice and trigger the drive to improve (see Psychology (#psychology-behind-why-this-works) below).

Key insights:

• Show overall score plus category breakdown to highlight strengths and weaknesses
• Write dynamic content per tier — default Low / Medium / High; custom tiers ("Startup / Scaleup / Performer / Unicorn") increase engagement
• The sweet spot: prospects scoring "strong foundations with room to improve" convert best
• PDF reports (personalized cover, detailed recommendations) extend value and travel into sales meetings
• Different CTAs per tier: Low → free event; Medium → book + discovery call; High → direct consultation

Product applications:

Copy patterns:

• "Your [Topic] Score is [X]/[Total]. Here's what that means..."
• Low tier: "This area needs attention. Here are easy first steps... Our team specializes in helping people at your stage."
• High tier: "Excellent foundation! Focus on maintaining standards. We work with advanced clients like yourself on [specific advanced offer]."

Ethical boundary: Never inflate or deflate the computed score to steer a prospect toward the offer — the tier must reflect their actual answers.

See references/technical-implementation.md when building the actual tool — scoring/weighting logic, conditional content rules, PDF generation, and platform comparison.

4. Sales and Marketing

Core concept: Turn assessment data into a systematic engine: promotion drives traffic to the landing page, while follow-up sequences segment leads by score tier and nurture them toward a conversion event.

Why it works: Scorecard leads arrive with self-reported pain points, qualification signals, and scores — sales conversations shift from discovery to recommendation, and automated segmentation gives every lead relevant follow-up.

Key insights:

• Promote via LinkedIn polls, Facebook/Google ads, email lists, podcast CTAs, book QR codes
• Fire the results email + PDF immediately after completion; send abandon emails to recover incomplete starts
• Segment nurture campaigns by tier — not one-size-fits-all drip
• Multi-step funnels for high-ticket: Stage 1 (8-15 questions, basic score), Stage 2 (15-25, detailed report), Stage 3 (30-50, baseline + roadmap)

Product applications:

Copy patterns:

• "Take the [Topic] Scorecard" as a universal CTA across all channels
• Results email: "Your [Topic] Score is ready. Here's what we recommend based on your results."
• Nurture: "Last week you scored [X] on [category]. Here are 3 ways to improve that score this month."

Ethical boundary: Never weaponize self-reported pain points to pressure a prospect — the data they volunteered is for tailoring help, not for manufacturing urgency.

See references/analytics-optimization.md when a live funnel underperforms or you're setting up tracking — key metrics, what to A/B test, funnel-drop analysis, CRM integration, and lead scoring.

Scorecard Naming Strategy

Effective names combine topic clarity, outcome promise, and brevity.

Formulas:

• "The [Topic] Scorecard" — "The Business Growth Scorecard"
• "[Outcome] Readiness Assessment" — "Leadership Readiness Assessment"
• "What's Your [Topic] Score?" — "What's Your Marketing Score?"
• "The [Adjective] [Topic] Quiz" — "The Complete Wellness Quiz"

Conversion Benchmarks

• Traditional PDF lead magnets: 3-10% conversion
• Scorecard/quiz funnels: 30-50% conversion
• Top performers: 70%+ with optimized landing pages

Psychology Behind Why This Works

1. Tension creation: Questions surface dormant desires
2. Reciprocity: You gave value (insights), they're open to conversation
3. Self-qualification: They told you their problems and budget
4. Personalization: people willingly trade data for a tailored result, then expect the offer to match it (the supporting stats live in references/psychology.md)
5. Gamification: Primal drive to score, rank, and improve
6. Commitment: Time invested increases follow-through

Implementation Checklist

1. Define ideal customer and their desired outcome
2. Choose a concept hook (one of the 5 types from the Landing Page section)
3. Write 2-7 scoring categories based on your methodology
4. Create 10-40 questions with point values
5. Set up 3 scoring tiers with dynamic content
6. Write landing page with 3 Cs (Clarity, Credibility, Connection)
7. Configure lead form fields
8. Set up automated email with results
9. Create follow-up sequence by tier
10. Test with 5-10 people before launch

Common Mistakes

Quick Diagnostic

Further Reading

For the complete system, additional examples, and advanced strategies:

• "Scorecard Marketing: The four-step playbook for getting better leads and bigger profits" by Daniel Priestley and Glen Carlson

About the Author

Daniel Priestley is a serial entrepreneur, founder of the accelerator Dent Global, and co-founder of ScoreApp, the platform built around the scorecard methodology that has generated millions of leads. He is the author of Key Person of Influence, Oversubscribed, and Scorecard Marketing.

---

Supporting file: references/analytics-optimization.md

Scorecard Analytics & Optimization

Metrics, A/B testing elements, funnel analysis, and CRM integration for scorecard marketing.

Table of Contents

1. Key Metrics to Track (#key-metrics-to-track)
2. A/B Testing Elements (#ab-testing-elements)
3. Funnel Analysis Framework (#funnel-analysis-framework)
4. Score-Based Segmentation (#score-based-segmentation)
5. CRM Integration (#crm-integration)
6. Optimization Playbook (#optimization-playbook)
7. Advanced Tracking (#advanced-tracking)
8. Reporting Dashboard (#reporting-dashboard)

---

Key Metrics to Track

Landing Page Metrics

Questionnaire Metrics

Results Page Metrics

Conversion Metrics

---

A/B Testing Elements

High-Impact Elements to Test

Testing Priorities (ICE Framework)

Test first (high impact, easy):

• Headline copy
• CTA button text
• Lead form fields (less = more conversion)
• Result page CTA

Test second (high impact, moderate effort):

• Number of questions
• Question wording
• Results page layout
• Email subject lines

Test later (lower impact or harder):

• Visual design elements
• Animation/transitions
• Gamification elements
• Advanced personalization

What NOT to A/B Test

• Questions that affect scoring (changes data meaning)
• Core scoring logic (unless starting fresh)
• Brand elements (logo, colors)
• Compliance/legal text

---

Funnel Analysis Framework

The Scorecard Funnel

Traffic → Landing Page → Start Quiz → Complete Questions → Email Capture → Results View → CTA Click → Sale

Identifying Bottlenecks

Question-Level Drop-off Analysis

Track completion rate at each question:

Q1: 100% →
Q2: 95% →
Q3: 88% →
Q4: 85% →
Q5: 70% → ← Problem question
Q6: 68% →
Q7: 65% →

Fix problem questions by:

• Simplifying wording
• Changing from open text to multiple choice
• Reordering (move difficult questions later)
• Making optional
• Removing entirely

Cohort Analysis

Compare performance across:

• Traffic sources
• Time periods
• Score segments
• Demographic segments

Example insight: "LinkedIn traffic has 40% higher completion rate but 20% lower CTA click rate—they engage but need different offer."

---

Score-Based Segmentation

Segment Definitions

Category-Level Segmentation

Beyond total score, segment by category scores:

Marketing Score: 85% | Operations: 45% | Finance: 70%

Insight: Strong marketing, weak operations—target operations content/services

Behavioral Segments

---

CRM Integration

Data to Capture

Standard fields:

• Name, email, phone
• Total score
• Category scores
• Completion timestamp
• Traffic source

Custom fields:

• Individual question responses (high-value questions)
• Score tier (Low/Medium/High)
• Key qualifying answers
• Time to complete

Lead Scoring Integration

Map scorecard results to CRM lead scores:

Workflow Triggers

Integration Best Practices

1. Map fields before launch - Plan CRM fields and tags in advance
2. Test data flow - Submit test entries through entire flow
3. Avoid data overload - Don't capture every answer—focus on actionable data
4. Enable scoring flexibility - Build in ability to adjust lead scoring

---

Optimization Playbook

Weekly Review Checklist

• Check completion rate (target: >60%)
• Review question drop-off points
• Compare conversion by traffic source
• Check email delivery rates
• Review CTA click rates by score tier
• Monitor qualification rate from sales

Monthly Optimization Actions

Quarterly Review

1. Full funnel audit - Map conversion at every stage
2. Question performance - Which questions predict conversion?
3. Offer alignment - Are tier-specific offers converting?
4. Benchmark comparison - Compare to industry averages
5. Score distribution - Is scoring differentiating effectively?

---

Advanced Tracking

UTM Parameters

Track traffic sources with consistent UTM tagging:

?utm_source=linkedin
&utm_medium=organic
&utm_campaign=scorecard_2024
&utm_content=post_v1

Capture and store UTMs with lead data for attribution.

Event Tracking Setup

Heatmap and Session Recording

Use tools like Hotjar or FullStory to:

• Watch real users complete the quiz
• Identify confusion points
• See where users hover/pause
• Understand results page engagement

---

Reporting Dashboard

Executive Summary Metrics

┌──────────────────────────────────────────────────────────────┐
│ SCORECARD PERFORMANCE (Last 30 Days)                         │
├──────────────────────────────────────────────────────────────┤
│ Visitors:        5,234    │  Leads Generated:     1,832     │
│ Start Rate:      45.2%    │  Lead Quality Score:  7.4/10    │
│ Completion Rate: 77.4%    │  CTA Click Rate:      23.1%     │
│ Lead Cost:       $2.47    │  Pipeline Generated:  $127,500  │
└──────────────────────────────────────────────────────────────┘

Trend Charts

• Weekly lead volume and quality
• Conversion rates over time
• Score distribution changes
• Traffic source performance

Actionable Alerts

Set alerts for:

• Completion rate drops >10%
• Lead quality score drops
• Significant traffic spikes (opportunity to capitalize)
• Unusual drop-off patterns

---

Supporting file: references/industry-examples.md

Industry Examples & Question Templates

Scorecard Concepts by Industry

Business & Consulting

• "Business Growth Scorecard" - Marketing, Operations, Finance, Leadership
• "Scale Ready Assessment" - Systems, Team, Revenue, Investment Readiness
• "Pitch Ready Scorecard" - Deck, Financials, Team, Market, Traction
• "Key Person of Influence Scorecard" - Pitch, Publish, Product, Profile, Partnerships

Health & Fitness

• "Sleep Quality Scorecard" - Habits, Environment, Stress, Nutrition
• "Fitness Readiness Quiz" - Current Level, Goals, Time, Motivation
• "Weight Loss Success Predictor" - Diet, Exercise, Mindset, Support
• "Marathon Runner Checklist" - Training, Nutrition, Gear, Recovery

Finance & Investments

• "Investment Readiness Assessment" - Risk Profile, Goals, Timeline, Knowledge
• "Retirement Planning Scorecard" - Savings, Income, Expenses, Goals
• "Wealth Discovery Quiz" - Financial Situation, Money Mindset, Goals
• "Home Buyer Readiness Quiz" - Budget, Credit, Timeline, Knowledge

Relationships & Personal

• "Relationship Health Scorecard" - Communication, Conflict, Connection, Goals
• "Are You Ready for a Serious Relationship?" - Emotional readiness, Lifestyle, Values
• "Parenting Style Assessment" - Discipline, Communication, Support, Balance
• "Wheel of Life Assessment" - Career, Finance, Health, Relationships, Fun, Growth

Technology & IT

• "Cybersecurity Risk Scorecard" - Systems, Training, Policies, Response
• "Digital Transformation Readiness" - Tech, Culture, Data, Skills
• "IT Infrastructure Health Check" - Security, Performance, Scalability, Support

Real Estate

• "Sell Your Home Readiness Quiz" - Timing, Preparation, Pricing, Market Knowledge
• "Property Investment Scorecard" - Budget, Knowledge, Risk, Goals
• "First Home Buyer Checklist" - Finance, Location, Timeline, Knowledge

Professional Services

• "Marketing Effectiveness Scorecard" - Strategy, Content, Channels, Analytics
• "Sales Excellence Assessment" - Process, Skills, Tools, Results
• "Leadership Impact Scorecard" - Vision, Communication, Team, Results

---

Question Writing Templates

Yes/No Best Practice Questions

For Habits:

• Do you [specific behavior] at least [frequency]?
• Have you [action] in the last [timeframe]?
• Do you currently have a [system/process] for [goal]?

For Knowledge:

• Do you know your [specific metric]?
• Have you researched [topic] before making a decision?
• Are you aware of [common pitfall/opportunity]?

For Results:

• Has your [metric] improved in the last [timeframe]?
• Have you achieved [specific milestone]?
• Do you feel confident about your [area]?

Sliding Scale Questions (1-10)

• How satisfied are you with your current [area]?
• How confident are you in your ability to [action]?
• How important is [outcome] to you right now?
• How often do you [behavior]?
• How stressful is [situation] for you?

Multiple Choice (Radio Button) Questions

Current Situation: "Which best describes your current [area]?"

• Just getting started
• Building foundations
• Growing steadily
• Scaling rapidly
• Optimizing for maximum results

Desired Outcome (90 days): "What do you most want to achieve in the next 90 days?"

• [Outcome A]
• [Outcome B]
• [Outcome C]
• Not sure yet

Main Obstacle: "What's your biggest challenge with [area]?"

• Lack of time
• Lack of knowledge
• Lack of budget
• Lack of support
• Not sure where to start

Budget/Investment Signals: "What best describes your situation?"

• I'm researching options (browsing)
• I'm ready to invest in a solution (buyer)
• I've already tried solutions that didn't work (frustrated buyer - high value)
• I need to convince others first (influencer, not decider)

Qualifying Questions (Add to Uncategorised)

Budget indicators:

• "What have you invested in [area] in the past 12 months?"
  • Nothing / Under $500 / $500-$2000 / $2000-$10000 / Over $10000

Timeline/Urgency:

• "When do you want to start making changes?"
  • Immediately / Within 30 days / Within 3 months / Just researching

Decision authority:

• "Who else is involved in this decision?"
  • Just me / Partner/spouse / Business partner / Team/board

Company size (B2B):

• "How large is your team?"
  • Solo / 2-5 / 6-20 / 21-100 / 100+

---

Dynamic Results Copy Templates

Low Score (0-40%)

Tone: Encouraging, not judgmental. Focus on potential.

Your [Area] Score: [X]%

It looks like there's significant room for improvement in [area]. 
The good news? You've taken the first step by identifying where to focus.

Key insight: [Specific observation based on their answers]

Your recommended next steps:
1. [Simple action they can take today]
2. [Resource to consume - video, guide, checklist]
3. [Offer appropriate for beginners]

Many of our most successful clients started exactly where you are now. 
[Social proof: name/result from similar starting point]

Medium Score (41-70%)

Tone: Acknowledging progress, highlighting opportunity.

Your [Area] Score: [X]%

You've built solid foundations in [area]. Now it's about 
taking things to the next level.

Your strengths: [Category they scored highest]
Your opportunity: [Category they scored lowest]

Key insight: [Specific observation]

Your recommended next steps:
1. [Action to optimize their strength]
2. [Action to address their weakness]
3. [Mid-tier offer - book + call, workshop, etc.]

You're in a great position to accelerate your progress.

High Score (71-100%)

Tone: Celebratory, but with advanced opportunities.

Your [Area] Score: [X]%

Congratulations! You're performing at an advanced level in [area].

You've clearly put in the work. Your score puts you in 
the top [X]% of people who've taken this assessment.

At this level, the focus shifts to:
- Maintaining your high standards
- Fine-tuning for marginal gains
- Working with specialists who understand advanced challenges

Your recommended next step:
[Premium offer - direct consultation, advanced program]

Our team works with a select number of high-performers like yourself.

---

Email Sequence Templates

Immediate Results Email

Subject: Your [Scorecard Name] Results: [X]%

Hi [Name],

Thanks for taking the [Scorecard Name]. 

Your overall score: [X]% ([Tier Label])

Quick summary:
- [Strength category]: [Score]% ✓
- [Opportunity category]: [Score]% ←

[1-2 sentence insight]

📄 Your full personalized report is attached.

[CTA based on tier]

[Signature]

P.S. [Urgency element if applicable]

Abandon Email (Didn't Complete)

Subject: You're almost there...

Hi [Name],

You started the [Scorecard Name] but didn't quite finish.

I get it - life gets busy. But you were clearly curious about 
your [area] score for a reason.

The good news: I saved your progress. 
You can pick up right where you left off:

[Continue My Assessment →]

It'll only take another [X] minutes, and you'll get:
- Your personalized score across [X] areas
- Specific recommendations based on your answers
- [Bonus if applicable]

[Signature]

Follow-Up Sequence (3-email minimum)

Email 2 (Day 3): Educational + Soft CTA

• Share insight related to their lowest-scoring category
• Link to relevant content (video, article, case study)
• Mention offer at the end

Email 3 (Day 7): Social Proof + Stronger CTA

• Case study of someone with similar score who improved
• Clear offer with deadline if applicable

Email 4 (Day 14): Direct Ask

• "I noticed you scored [X] in [category]"
• "Would a quick call help?"
• Calendar link

---

Supporting file: references/psychology.md

Buyer Psychology & Tension Creation

Why People Buy: Psychological Tension

All purchases resolve psychological tension - the gap between current reality and desired reality.

Three Types of Tension

Dormant vs Active Desires

Active desire: Person is already searching for solutions

• Harder to sell to (already decided, set budget)
• Looking for established brands, social proof
• Comparing options

Dormant desire: Tension exists but not acted upon

• Easier to influence (open to options)
• Will buy from whoever awakened the desire
• Open to exploring price ranges

The scorecard targets dormant desires by asking revealing questions.

---

The 3 Conditions for Purchase

All three must be present for a sale:

1. Emotion

• Feeling respected and understood
• Trust established
• Emotional payoff visualized
• Stories with heroes, struggles, triumphs

2. Logic

• Clear ROI calculation
• Cost-benefit analysis understood
• Comparison with alternatives favorable
• Facts, statistics, data supporting decision

3. Urgency

• Cost of inaction is clear
• Limited availability/time
• Price may increase
• Quality may deteriorate
• Opportunity may pass

A scorecard creates a loop of all three:

• Landing page: Emotional hooks + logical benefits
• Questions: Engagement creating emotional investment
• Results: Quantified logic + urgent next step

---

Scoring Psychology

Why Scoring Works

Humans have primal drives to:

• Measure everything that can be measured
• Rank themselves against standards
• Improve and optimize continuously

This is evolutionary - ancestors who didn't measure and improve didn't survive.

The Power of Quantification

When you ask "On a scale of 1-10, how satisfied are you with [X]?":

• Emotion (the dissatisfaction) meets logic (the number)
• Below 4 = unbearable, will take action
• 7+ = satisfactory, low motivation
• Sweet spot: 4-6 (knows there's a problem, sees possibility)

The Feedback Effect

• Gold stars motivate preschoolers
• Stock price motivates CEOs
• Scores motivate everyone in between

Scorecard results provide the feedback loop people crave.

---

Warming Up Leads

Google's ZMOT (Zero Moment of Truth)

People consume ~11 pieces of content before purchasing.

Dunbar's Research

Multiple quality interactions over time accelerate trust.

Implication for Scorecards

The scorecard isn't the end - it's the beginning of a content journey:

1. Scorecard (5 min) - Initial engagement, data collected
2. Results email - Personalized, links to relevant content
3. Educational content - Based on their weak areas
4. Social proof - Case studies matching their situation
5. Offer - Positioned as path of least resistance

---

Path of Least Resistance

After creating tension, offer clear resolution:

Forms of Path of Least Resistance

1. Methodology - Named, step-by-step process

   • "The 5P Method" / "The 3-Step System"
   • Shows you've solved this before

2. Product/Service Bundle - Curated solution

   • Removes decision fatigue
   • "Everything you need to achieve [result]"

3. Intervention - Change of direction

   • Stop doing wrong thing
   • Start doing right thing
   • Value based on outcome, not time

The Perfect Fit Principle

Without questions first:

"I have the perfect solution for you!" → Skepticism

After questions answered:

"Based on your answers, here's what I recommend..." → Trust

The scorecard earns the right to recommend.

---

Personalization Statistics

Key data points supporting this approach:

• 91% of consumers more likely to buy from brands with relevant offers
• 83% willing to share data for personalized experience
• 72% only engage with personalized messaging
• 71% frustrated when experience is impersonal
• 67% expect automatic content adjustment
• 202% better conversion with personalized CTAs

---

Common Psychological Mistakes

In Questions

• Asking obvious leading questions - Feels manipulative
• Too many open-ended questions - Decision fatigue
• Industry jargon - Excludes, doesn't include

In Results

• Same content regardless of score - Breaks personalization promise
• Only negative feedback - Demotivates action
• No clear next step - Momentum dies

In Follow-up

• Generic emails - Wastes the data collected
• Too aggressive - Breaks trust built
• Too passive - Misses the moment of motivation

---

Emotion/Logic/Urgency in Practice

Landing Page Example

Emotion (Visual): Happy couple reviewing finances together

Logic (Copy): "This assessment is based on 15 years of research with 10,000+ households. You'll discover your exact score across 5 key areas."

Urgency (CTA): "Get your free score now - results instantly delivered"

Results Page Example

Emotion: "You've built a solid foundation. Here's what's possible..."

Logic: "Your Marketing score of 42% is below the 67% benchmark for businesses at your stage."

Urgency: "Book a free strategy call this week and receive our exclusive [bonus] - only 3 spots remaining."

---

Supporting file: references/technical-implementation.md

Scorecard Technical Implementation

Platform comparison, conditional logic patterns, PDF generation, and integration architecture.

Table of Contents

1. Platform Comparison (#platform-comparison)
2. Scoring Logic Patterns (#scoring-logic-patterns)
3. Conditional Logic Patterns (#conditional-logic-patterns)
4. PDF Report Generation (#pdf-report-generation)
5. Integration Architecture (#integration-architecture)
6. Performance Optimization (#performance-optimization)
7. Security Considerations (#security-considerations)

---

Platform Comparison

Dedicated Quiz/Scorecard Platforms

Form Builders with Quiz Capabilities

Custom Development

When to build custom:

• Unique scoring logic not supported by platforms
• Deep product integration required
• High volume with cost concerns
• Specific compliance requirements

Tech stack options:

• React/Next.js + headless CMS
• Static form with serverless functions
• WordPress + custom plugin
• Low-code (Webflow + integrations)

---

Scoring Logic Patterns

Simple Additive Scoring

Each answer adds points to a total.

const questions = [
  {
    id: 'q1',
    options: [
      { value: 'never', points: 1 },
      { value: 'sometimes', points: 3 },
      { value: 'always', points: 5 },
    ]
  }
];

function calculateScore(answers) {
  return Object.values(answers).reduce((total, answer) => {
    return total + answer.points;
  }, 0);
}

Category-Based Scoring

Score multiple dimensions separately.

const questions = [
  {
    id: 'q1',
    category: 'marketing',
    options: [
      { value: 'a', points: 1 },
      { value: 'b', points: 3 },
      { value: 'c', points: 5 },
    ]
  },
  {
    id: 'q2',
    category: 'operations',
    options: [...]
  }
];

function calculateCategoryScores(answers, questions) {
  const categories = {};

  questions.forEach(q => {
    if (!categories[q.category]) {
      categories[q.category] = { total: 0, max: 0 };
    }

    const answer = answers[q.id];
    const maxPoints = Math.max(...q.options.map(o => o.points));

    categories[q.category].total += answer.points;
    categories[q.category].max += maxPoints;
  });

  // Convert to percentages
  Object.keys(categories).forEach(cat => {
    categories[cat].percentage = Math.round(
      (categories[cat].total / categories[cat].max) * 100
    );
  });

  return categories;
}

Weighted Scoring

Some questions matter more than others.

const questions = [
  {
    id: 'q1',
    weight: 2,  // Double importance
    options: [...]
  },
  {
    id: 'q2',
    weight: 1,  // Normal importance
    options: [...]
  }
];

function calculateWeightedScore(answers, questions) {
  let weightedTotal = 0;
  let maxWeightedTotal = 0;

  questions.forEach(q => {
    const answer = answers[q.id];
    const maxPoints = Math.max(...q.options.map(o => o.points));

    weightedTotal += answer.points * q.weight;
    maxWeightedTotal += maxPoints * q.weight;
  });

  return Math.round((weightedTotal / maxWeightedTotal) * 100);
}

Tier Assignment

Map scores to meaningful tiers.

function getTier(score) {
  if (score >= 80) return { name: 'Advanced', level: 3 };
  if (score >= 50) return { name: 'Intermediate', level: 2 };
  return { name: 'Beginner', level: 1 };
}

// Category-specific tiers
function getCategoryTier(categoryScore) {
  const tiers = {
    marketing: [
      { min: 0, max: 40, name: 'Foundation' },
      { min: 41, max: 70, name: 'Growing' },
      { min: 71, max: 100, name: 'Optimized' },
    ],
    // Different tiers per category if needed
  };

  return tiers[category].find(t =>
    categoryScore >= t.min && categoryScore <= t.max
  );
}

---

Conditional Logic Patterns

Question Branching

Show different questions based on previous answers.

const questions = [
  {
    id: 'business_type',
    text: 'What type of business are you?',
    options: ['B2B', 'B2C', 'Both']
  },
  {
    id: 'b2b_sales',
    text: 'How long is your typical sales cycle?',
    showIf: { business_type: ['B2B', 'Both'] }
  },
  {
    id: 'b2c_volume',
    text: 'How many customers do you serve monthly?',
    showIf: { business_type: ['B2C', 'Both'] }
  }
];

function shouldShowQuestion(question, answers) {
  if (!question.showIf) return true;

  return Object.entries(question.showIf).every(([questionId, validValues]) => {
    const answer = answers[questionId];
    return validValues.includes(answer);
  });
}

Dynamic Results

Show different content based on score patterns.

const resultContent = {
  overall: {
    low: {
      headline: "You're just getting started",
      description: "Focus on fundamentals first...",
      cta: { text: "Get our beginner guide", url: "/guide" }
    },
    medium: {
      headline: "You have solid foundations",
      description: "Time to optimize and scale...",
      cta: { text: "Book a strategy call", url: "/call" }
    },
    high: {
      headline: "You're operating at high level",
      description: "Let's fine-tune for excellence...",
      cta: { text: "Explore advanced services", url: "/premium" }
    }
  },
  categories: {
    marketing: {
      low: "Your marketing needs attention. Start with...",
      medium: "Your marketing is working. Next step...",
      high: "Your marketing is strong. Consider..."
    }
  }
};

function getResultContent(scores) {
  const tier = scores.overall < 40 ? 'low' :
               scores.overall < 70 ? 'medium' : 'high';

  return {
    overall: resultContent.overall[tier],
    categories: Object.entries(scores.categories).map(([cat, score]) => ({
      category: cat,
      content: resultContent.categories[cat][getTier(score)]
    }))
  };
}

---

PDF Report Generation

Server-Side Generation

Popular options:

Puppeteer Example

const puppeteer = require('puppeteer');

async function generatePDF(data) {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();

  // Load HTML template with data
  const html = renderTemplate('report.html', data);
  await page.setContent(html, { waitUntil: 'networkidle0' });

  // Generate PDF
  const pdf = await page.pdf({
    format: 'A4',
    printBackground: true,
    margin: { top: '1cm', right: '1cm', bottom: '1cm', left: '1cm' }
  });

  await browser.close();
  return pdf;
}

PDF Content Structure

<div class="page cover">
  <img src="logo.png" />
  <h1>Your Scorecard Results</h1>
  <p>Prepared for: {{ name }}</p>
  <p>Date: {{ date }}</p>
</div>


<div class="page">
  <h2>Overall Score: {{ overallScore }}%</h2>
  <div class="score-gauge"></div>
  <p>{{ overallInterpretation }}</p>
</div>


{{ for category in categories }}
<div class="page">
  <h2>{{ category.name }}: {{ category.score }}%</h2>
  <p>{{ category.interpretation }}</p>
  <h3>Recommendations:</h3>
  <ul>
    {{ for rec in category.recommendations }}
    <li>{{ rec }}</li>
    {{ endfor }}
  </ul>
</div>
{{ endfor }}


<div class="page">
  <h2>Your Next Steps</h2>
  <ol>
    {{ for step in nextSteps }}
    <li>{{ step }}</li>
    {{ endfor }}
  </ol>
  <div class="cta">
    <p>Ready to improve your score?</p>
    <p>Book a call: {{ ctaUrl }}</p>
  </div>
</div>

Third-Party PDF Services

If building is too complex:

• PDF.co - API-based PDF generation
• DocRaptor - HTML-to-PDF API
• Anvil - PDF filling and generation

---

Integration Architecture

Data Flow

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Landing   │────▶│   Quiz      │────▶│   Results   │
│    Page     │     │   Form      │     │    Page     │
└─────────────┘     └─────────────┘     └─────────────┘
                           │                    │
                           ▼                    ▼
                    ┌─────────────┐     ┌─────────────┐
                    │    Lead     │     │     PDF     │
                    │   Capture   │     │  Generation │
                    └─────────────┘     └─────────────┘
                           │                    │
              ┌────────────┴────────────┬───────┘
              ▼                         ▼
       ┌─────────────┐          ┌─────────────┐
       │     CRM     │          │    Email    │
       │  (HubSpot,  │          │   Service   │
       │ Salesforce) │          │  (Mailchimp)│
       └─────────────┘          └─────────────┘

Webhook Integration

// On quiz completion
async function handleQuizComplete(data) {
  const { answers, scores, contact } = data;

  // 1. Generate PDF
  const pdf = await generatePDF({ scores, contact });
  const pdfUrl = await uploadPDF(pdf, contact.email);

  // 2. Send to CRM
  await crmClient.createContact({
    email: contact.email,
    name: contact.name,
    properties: {
      scorecard_overall: scores.overall,
      scorecard_tier: scores.tier,
      scorecard_pdf: pdfUrl,
      ...formatCategoryScores(scores.categories)
    }
  });

  // 3. Send email with results
  await emailClient.send({
    to: contact.email,
    template: 'scorecard-results',
    data: {
      name: contact.name,
      scores,
      pdfUrl
    }
  });

  // 4. Track analytics
  await analytics.track('scorecard_completed', {
    tier: scores.tier,
    overall_score: scores.overall
  });
}

Zapier/Make Integration

For no-code connections:

Trigger: Webhook when quiz completes Actions:

1. Add row to Google Sheet (backup)
2. Create/update HubSpot contact
3. Send email via Mailchimp
4. Post to Slack (for high scores)

---

Performance Optimization

Fast Loading

// Lazy load questions
const [visibleQuestions, setVisibleQuestions] = useState(
  questions.slice(0, 3)
);

// Preload next questions
useEffect(() => {
  const nextIndex = visibleQuestions.length;
  if (nextIndex < questions.length) {
    // Preload next 2 questions
    const nextQuestions = questions.slice(nextIndex, nextIndex + 2);
    preloadImages(nextQuestions);
  }
}, [visibleQuestions]);

Progress Persistence

// Save progress to localStorage
function saveProgress(answers) {
  localStorage.setItem('quiz_progress', JSON.stringify({
    answers,
    timestamp: Date.now()
  }));
}

// Restore on page load
function loadProgress() {
  const saved = localStorage.getItem('quiz_progress');
  if (saved) {
    const { answers, timestamp } = JSON.parse(saved);
    // Only restore if less than 24 hours old
    if (Date.now() - timestamp < 24 * 60 * 60 * 1000) {
      return answers;
    }
  }
  return null;
}

Abandonment Recovery

// Capture email early
const emailCaptureAt = 3; // After question 3

// On abandonment
window.addEventListener('beforeunload', () => {
  if (currentQuestion > emailCaptureAt && email) {
    // Trigger abandonment workflow
    navigator.sendBeacon('/api/quiz-abandoned', JSON.stringify({
      email,
      progress: answers,
      lastQuestion: currentQuestion
    }));
  }
});

---

Security Considerations

Data Protection

// Don't store sensitive answers client-side
const sensitiveFields = ['revenue', 'employee_count'];

function sanitizeForStorage(answers) {
  return Object.fromEntries(
    Object.entries(answers).filter(
      ([key]) => !sensitiveFields.includes(key)
    )
  );
}

Rate Limiting

// Prevent spam submissions
const rateLimiter = rateLimit({
  windowMs: 15 * 60 * 1000, // 15 minutes
  max: 5, // 5 submissions per window
  message: 'Too many submissions, please try again later'
});

app.post('/api/submit-quiz', rateLimiter, handleSubmit);

Validation

// Server-side validation
function validateSubmission(data) {
  const errors = [];

  // Required fields
  if (!data.email || !isValidEmail(data.email)) {
    errors.push('Valid email required');
  }

  // Answer validation
  questions.forEach(q => {
    const answer = data.answers[q.id];
    if (!q.options.some(o => o.value === answer)) {
      errors.push(`Invalid answer for ${q.id}`);
    }
  });

  return errors;
}