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

# View merchandising rule performance

> Open the performance sheet for an active merchandising rule to review KPIs, conversion trends, and top-performing products over selectable date ranges.

Each row on the **Merchandising rules** list shows a 7-day inline performance summary. To see a longer timeframe, position-by-position breakdown, and the products driving conversion while the rule was active, open the **Performance** sheet.

## Prerequisites

* Your storefront must forward click, add-to-cart, and purchase events to the [Beacon API](/tracking-api/send-events) with the `attributionToken` returned by the [Browse API](/api-reference/browse). Without these events, the performance sheet shows empty results.

## Steps

1. Go to **Merchandise**.
2. Find the rule you want to inspect.
3. Click the inline performance summary on that row to open the **Performance** sheet.
4. Use the timeframe toggle at the top of the sheet to switch between **7 days**, **14 days**, and **30 days**.

## What you can see

The sheet is organized into four sections:

* **KPI cards** — Impressions, CTR, add-to-cart rate, purchase rate, revenue, and revenue per impression (RPI). Each card shows the absolute value and the percent change versus the prior period of the same length.
* **Trend** — A combined line and bar chart showing impressions, clicks, add-to-carts, and purchases across the selected timeframe.
* **Position** — How products in pinned and expression-driven positions perform compared to the rest of the collection. Use it to confirm whether your top pins are earning their spot.
* **Top products** — The products that received the most impressions, clicks, and revenue while the rule was active.

Performance counts only include impressions where this rule was active. If a rule is published mid-period or paused for part of the timeframe, only the active days are included.

## How clicks, add-to-carts, and purchases are counted

The KPI cards report **blended** counts: a sum of events tied directly to the request's `attributionToken` plus modeled events from the same browsing session that happened within ten minutes of the rule being applied. Modeled events that occurred more than two minutes after the impression are weighted at half a count to reflect the lower confidence that the rule drove them.

This keeps your rule's totals accurate even when the `attributionToken` doesn't survive the full path to checkout. See [Metrics: Blended attribution](/platform/metrics#blended-attribution) for the full set of attribution categories and how they're weighted.

The KPI cards in the **Performance** sheet also surface a deterministic-versus-modeled breakdown so you can see how much of each total came from token-matched events.

## Troubleshooting

| Symptom                                      | Likely cause                                                                                                | What to do                                                                                                                                                                 |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| All metrics show `—`                         | No tracked events received yet, or the rule is unpublished                                                  | Publish the rule and confirm your storefront forwards the `attributionToken` to the [Beacon API](/tracking-api/send-events).                                               |
| Lower numbers than expected                  | Layers counts only impressions where this specific rule was the active rule for the collection + sort order | A rule with a more specific contextual condition or a competing rule may have served instead. See [Multiple rules per collection](/platform/merchandising/multiple-rules). |
| Modeled counts are higher than deterministic | Your storefront forwards the token on click but not on add-to-cart or purchase pages                        | Forward the `attributionToken` to the [Beacon API](/tracking-api/send-events) on every event so more conversions are counted as deterministic.                             |

## Next steps

* [Edit, disable, or delete a rule](/help/merchandising/edit-disable-delete-merchandising-rule)
* [Merchandising overview](/platform/merchandising)
* [Metrics overview](/platform/metrics)
