Skip to main content

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.

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 with the attributionToken returned by the Browse API. 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 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

SymptomLikely causeWhat to do
All metrics show —No tracked events received yet, or the rule is unpublishedPublish the rule and confirm your storefront forwards the attributionToken to the Beacon API.
Lower numbers than expectedLayers counts only impressions where this specific rule was the active rule for the collection + sort orderA rule with a more specific contextual condition or a competing rule may have served instead. See Multiple rules per collection.
Modeled counts are higher than deterministicYour storefront forwards the token on click but not on add-to-cart or purchase pagesForward the attributionToken to the Beacon API on every event so more conversions are counted as deterministic.

​
Next steps