# 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

| Metric | Benchmark | What It Indicates |
|--------|-----------|-------------------|
| Page views | - | Total traffic |
| Unique visitors | - | Reach |
| Start rate | 30-50% | Landing page effectiveness |
| Time on page | 30-90s | Engagement before starting |
| Bounce rate | <50% | First impression quality |
| Traffic source conversion | Varies | Channel effectiveness |

### Questionnaire Metrics

| Metric | Benchmark | What It Indicates |
|--------|-----------|-------------------|
| Completion rate | 60-80% | Questionnaire design quality |
| Average time to complete | 2-5 min | Question difficulty/length |
| Drop-off by question | Varies | Problem questions |
| Skip rate (if allowed) | <10% | Question clarity |
| Email capture rate | 70-90% | Lead form positioning |

### Results Page Metrics

| Metric | Benchmark | What It Indicates |
|--------|-----------|-------------------|
| PDF download rate | 30-50% | Results page value |
| Time on results | 1-3 min | Engagement with recommendations |
| CTA click rate | 15-30% | Offer relevance |
| Share rate | 5-10% | Viral potential |
| Return visits | 10-20% | Ongoing interest |

### Conversion Metrics

| Metric | Benchmark | What It Indicates |
|--------|-----------|-------------------|
| Lead-to-opportunity | 10-30% | Lead quality |
| Opportunity-to-close | 20-40% | Sales effectiveness |
| Sales cycle length | Varies | Purchase complexity |
| Revenue per lead | Varies | Overall funnel value |

---

## A/B Testing Elements

### High-Impact Elements to Test

| Element | Hypothesis Examples | Typical Impact |
|---------|---------------------|----------------|
| **Headline** | Outcome-focused vs. process-focused | 20-50% |
| **Concept hook** | Different scoring angles | 30-100% |
| **Number of questions** | Shorter vs. longer | 10-30% |
| **Question order** | Easy-first vs. hard-first | 5-15% |
| **Lead form placement** | Before vs. after questions | 20-40% |
| **Results presentation** | Score-first vs. insights-first | 10-25% |
| **CTA on results** | Single vs. multiple options | 15-35% |

### 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

| Stage | Healthy Rate | Warning Signs |
|-------|--------------|---------------|
| Landing → Start | >30% | <20%: Landing page problem |
| Start → Complete | >60% | <40%: Question/UX problem |
| Complete → Email | >70% | <50%: Value proposition problem |
| Email → Results | >80% | <60%: Delivery problem |
| Results → CTA | >15% | <10%: Results/offer mismatch |

### 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

| Segment | Score Range | Characteristics | Follow-up Strategy |
|---------|-------------|-----------------|-------------------|
| **Low scorers** | 0-33% | Need fundamentals | Educational content, introductory offers |
| **Mid scorers** | 34-66% | Have foundation, gaps to fill | Specific solutions, consultation |
| **High scorers** | 67-100% | Advanced, optimization focused | Premium offers, strategic services |

### 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

| Segment | Behavior | Strategy |
|---------|----------|----------|
| **Quick completers** | <2 min | May be rushed—send detailed PDF |
| **Thorough completers** | >5 min | Engaged—offer consultation |
| **PDF downloaders** | Downloaded report | Ready for deeper content |
| **CTA clickers** | Clicked but didn't convert | Send reminder/objection handling |
| **Returners** | Multiple quiz completions | Highly interested—priority follow-up |

---

## 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:

| Scorecard Element | CRM Points |
|-------------------|------------|
| High overall score | +20 |
| Urgent timeline selected | +15 |
| Large company size | +10 |
| Budget confirmed | +25 |
| Low score in service area | +10 |
| Downloaded PDF | +5 |
| Clicked consultation CTA | +30 |

### Workflow Triggers

| Trigger | Action |
|---------|--------|
| Quiz completed | Add to nurture sequence |
| High score + clicked CTA | Route to sales immediately |
| Low score | Send educational content first |
| Quiz abandoned | Send completion reminder (24h) |
| PDF downloaded | Send related content (3 days) |
| CTA clicked, not converted | Send reminder (48h) |

### 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

| If... | Then... |
|-------|---------|
| Start rate <30% | A/B test headline, add testimonials |
| Completion rate <60% | Reduce questions, improve UX |
| CTA click <15% | Test different offers per tier |
| Lead quality complaints | Add qualifying questions |
| Low engagement scores | Improve results page content |

### 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

| Event | Trigger | Data to Capture |
|-------|---------|-----------------|
| `quiz_started` | First question shown | utm params, timestamp |
| `question_answered` | Answer selected | question_id, answer_value, time_spent |
| `email_submitted` | Form submitted | email, name |
| `results_viewed` | Results page loaded | total_score, category_scores |
| `pdf_downloaded` | PDF button clicked | score tier |
| `cta_clicked` | Main CTA clicked | offer_type, score_tier |

### 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

# 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

# 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

| Type | Source | Example |
|------|--------|---------|
| **Pain-based** | Something you have that you wish would stop | "My business is too dependent on me" |
| **Desire-based** | Something you don't have but want | "I want the freedom to travel while earning" |
| **Frustration-based** | Something not working as it should | "My marketing isn't generating leads" |

### 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."

# 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

| Platform | Best For | Key Features | Limitations |
|----------|----------|--------------|-------------|
| **ScoreApp** | Full scorecard methodology | Built for scorecards, PDF reports, CRM integration | Pricing, learning curve |
| **Typeform** | Beautiful UX, simple quizzes | Great design, logic jumps, integrations | Limited scoring, no native PDF |
| **Outgrow** | Interactive calculators | Calculators, quizzes, polls, good analytics | Can feel template-y |
| **Interact** | Quiz funnels, e-commerce | Personality quizzes, product recommendations | Less suited for B2B scorecards |
| **Bucket.io** | Advanced branching | Complex logic, multiple outcomes | Steeper learning curve |

### Form Builders with Quiz Capabilities

| Platform | Best For | Key Features | Limitations |
|----------|----------|--------------|-------------|
| **Tally** | Simple, free option | Clean UI, logic, calculations | Limited design control |
| **JotForm** | Established forms | Calculations, PDF reports, payments | UI feels dated |
| **Gravity Forms** | WordPress sites | Deep WP integration, add-ons | WordPress only |
| **Cognito Forms** | Calculations + forms | Good calculation engine | Less marketing-focused |

### 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.

```javascript
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.

```javascript
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.

```javascript
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.

```javascript
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.

```javascript
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.

```javascript
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:**

| Tool | Language | Best For |
|------|----------|----------|
| Puppeteer | Node.js | HTML-to-PDF, complex layouts |
| PDFKit | Node.js | Programmatic PDF creation |
| WeasyPrint | Python | CSS-based PDF |
| wkhtmltopdf | CLI | Simple HTML-to-PDF |
| React-pdf | Node.js/React | React-based templates |

### Puppeteer Example

```javascript
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

```html
<!-- Page 1: Cover -->
<div class="page cover">
  <img src="logo.png" />
  <h1>Your Scorecard Results</h1>
  <p>Prepared for: {{ name }}</p>
  <p>Date: {{ date }}</p>
</div>

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

<!-- Page 3+: Category Details -->
{{ 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 }}

<!-- Final Page: Next Steps -->
<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

```javascript
// 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

```javascript
// 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

```javascript
// 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

```javascript
// 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

```javascript
// 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

```javascript
// 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

```javascript
// 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;
}
```