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 Recommendation Blocks list shows a 7-day inline performance summary. To see a deeper breakdown — including longer timeframes, position-by-position results, and the products driving conversion — open the Performance sheet.

​
Prerequisites

  • Your storefront must forward click, add-to-cart, and purchase events to the Beacon API with the block’s attributionToken from the Blocks API. Without these events, the performance sheet shows empty results.

​
Steps

  1. Go to Recommendation Blocks.
  2. Find the block you want to inspect.
  3. Click the inline performance summary on that row (the chart icon and metrics block) 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 — Per-slot performance, so you can tell whether the first products in the carousel are doing the work or whether engagement spreads evenly across positions.
  • Top products — The products with the most impressions, clicks, and revenue while the block was active. Each row shows the product title alongside its individual performance metrics.
Results are cached briefly per block and timeframe and refreshed in the background. Newly available data streams in automatically without requiring a reload.

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

The KPI cards report blended counts: a sum of events tied directly to the block’s attributionToken plus modeled events from the same browsing session that happened within ten minutes of the block being shown. Modeled events that occurred more than two minutes after the impression are weighted at half a count to reflect the lower confidence that the block drove them. This means your block’s totals stay accurate even when the attributionToken doesn’t survive the full path to checkout — for example, when a shopper opens a product on a page that doesn’t forward the token. See Metrics: Blended attribution for a full breakdown of the attribution categories. The KPI cards in the Performance sheet also surface a deterministic-versus-modeled breakdown so you can see how much of each total is signed by the token directly.

​
Troubleshooting

SymptomLikely causeWhat to do
All metrics show —No tracked events received yetConfirm your storefront is forwarding the block’s attributionToken to the Beacon API.
Sections show “Unavailable”Analytics warehouse not provisioned for the storeContact support to enable performance analytics on the store.
Numbers seem low compared to GALayers counts only events forwarded to the Beacon API and deduplicates per sessionVerify your storefront sends one event per shopper interaction with the correct attributionToken.
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