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

# How-To: Measure Recommendation Performance

> Track recommendation outcomes and iterate on contexts with analytics.

Use this guide to move from shipping recommendations to continuously improving them.

## Setup

<Steps>
  <Step title="Open Analytics">
    Open Analytics in Console.
  </Step>

  <Step title="Select a time range">
    Select a time range, for example last 7 days.
  </Step>

  <Step title="Set granularity">
    Set granularity appropriate to traffic volume.
  </Step>
</Steps>

## Common workflows

### Evaluate baseline performance

Track at least:

* Recommendations Served
* Click events
* Purchase or conversion events

Start with all contexts, then narrow to one context at a time for actionability.

### Investigate anomalies

Use context and advanced filters (`request_id`, `session_id`, `user_id`) to debug sudden drops or spikes.

### Build an optimization loop

<Steps>
  <Step title="Change one variable">
    Change one variable at a time, such as a context filter, model family, pipeline setting, or ranking rule.
  </Step>

  <Step title="Observe engagement deltas">
    Observe engagement deltas over a fixed window.
  </Step>

  <Step title="Keep the winners">
    Keep changes that improve KPI targets; revert those that regress.
  </Step>
</Steps>

## Example app journey: Improve homepage CTR

<Steps>
  <Step title="Capture a baseline">
    Baseline homepage context metrics are captured for 14 days.
  </Step>

  <Step title="Adjust context filters">
    Team adjusts homepage context filters to remove low-engagement categories.
  </Step>

  <Step title="Roll out to a sample">
    New settings roll out to 25% of traffic.
  </Step>

  <Step title="Compare against baseline">
    CTR and downstream purchase events are compared versus baseline.
  </Step>

  <Step title="Expand the winning configuration">
    Winning configuration is rolled out to 100% traffic.
  </Step>
</Steps>

## Next steps

* [Analytics guide](/guides/analytics)
* [How-To: Launch a New Context](./how-to-launch-a-new-context)