Prerequisites
- Your storefront must forward click, add-to-cart, and purchase events to the Beacon API with the
attributionTokenreturned by the Browse API. Without these events, the performance sheet shows empty results.
Steps
- Go to Merchandise.
- Find the rule you want to inspect.
- Click the inline performance summary on that row to open the Performance sheet.
- 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.
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. |
| 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. |