> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Measure & Optimise

> Read the signals, tune difficulty, and keep achievements humming

Launching an achievement is only half the story. This guide shows you how to watch the numbers, spot trends, and make smart adjustments before your community loses interest—or races through everything like cheetahs on espresso.

## The Dashboard in Plain English

<CardGroup cols={2}>
  <Card title="Completion rate" icon="percentage">
    Shows how many eligible members actually unlock the achievement. Sweet spot: most engaged members finish it, but it still feels earned.
  </Card>

  <Card title="Time to complete" icon="hourglass">
    Tracks how long it takes from first qualifying action to unlock. A slow crawl signals confusion or an overly ambitious target.
  </Card>

  <Card title="Engagement lift" icon="trending-up">
    Compares behaviour before and after completion. Proof that your badge isn’t just shiny—it’s effective.
  </Card>

  <Card title="Reward impact" icon="gift">
    Keeps an eye on cost vs. value. If XP or prizes outpace engagement, dial things back.
  </Card>
</CardGroup>

<Callout type="info" icon="binoculars">
  Visit the analytics tab weekly for new achievements, monthly for evergreen ones. Early adjustments keep the experience fair and fun.
</Callout>

## Quick Troubleshooting Table

| Symptom                            | What it Means         | Next Move                                            |
| ---------------------------------- | --------------------- | ---------------------------------------------------- |
| Everyone completes it within hours | Too easy              | Raise the threshold or shorten the reset period      |
| Almost nobody starts               | Too hard or unclear   | Simplify the criteria, add guidance, or lower counts |
| Members abandon halfway            | Missing direction     | Add a follow-up message or pair with a challenge     |
| Reward costs balloon               | Incentives misaligned | Reduce XP/points or offer lighter bonuses            |

## Light-Touch Automations

<AccordionGroup>
  <Accordion title="Auto-balance difficulty" icon="scale-balanced">
    Create a rule that nudges thresholds up if completion stays above 70%, and down if it falls below 10%. Saves you from constant manual tweaking.
  </Accordion>

  <Accordion title="Seasonal swaps" icon="leaf">
    Schedule achievements to publish and retire automatically with each campaign. Update art and copy once, let the calendar do the rest.
  </Accordion>

  <Accordion title="Celebrate & convert" icon="party-popper">
    Trigger a Control Room automation that sends a congratulatory message—or a next-step challenge invite—the moment someone unlocks a badge.
  </Accordion>

  <Accordion title="Alert the team" icon="bell">
    Send Slack or email alerts if processing stalls or inventory for related rewards runs low. Better to hear about it from an internal monitor than from a frustrated llama.
  </Accordion>
</AccordionGroup>

## When You Need Raw Data

<Steps>
  <Step title="Export from the dashboard">
    Download CSVs to slice and dice in spreadsheets. Perfect for quarterly reviews.
  </Step>

  <Step title="Use webhooks">
    Subscribe to `achievement.unlocked` or `achievement.progress` events and pipe them into your CRM, analytics tool, or celebration channel.
  </Step>

  <Step title="Hit the API">
    Pull analytics or update thresholds programmatically when you need fine-grained control. The Control Room API docs have copy-paste examples.
  </Step>
</Steps>

## Keep the Loop Going

<CardGroup cols={2}>
  <Card title="Monthly retro" icon="calendar">
    Retire outdated achievements, refresh art, and note any lessons learned. Treat it like grooming a show dog: little and often.
  </Card>

  <Card title="Ask the community" icon="message-circle">
    Combine data with human feedback. A quick poll or forum thread can surface insights the charts miss.
  </Card>
</CardGroup>

You now have the tools to keep achievements performing long after launch day. Hop back to **Designing Achievements** when you’re ready to create the next chapter, or scan the **Control Room Playbook** for fresh ideas.