Skip to main content
  • Label: Blocks
  • Description: Analytics for recommendation block requests and conversions.
  • Default group key: block_id
Use the blocks dataset to measure how your recommendation blocks perform, including how often they are requested, how many clicks and views they generate, and the sales they drive.

​
Metrics

  • requests (requests)
    • Number of block recommendation requests.
    • Example: COUNT_DISTINCT(requests)
  • total_sales (USD)
    • Sales after discounts and before taxes/returns attributed to block recommendations.
    • Example: SUM(total_sales)
  • quantity_purchased (items)
    • Number of items purchased from block recommendation traffic.
    • Example: SUM(quantity_purchased)
  • click_sessions (sessions)
    • Sessions where a product from block recommendations was clicked.
    • Example: COUNT_DISTINCT(click_sessions)
  • view_sessions (sessions)
    • Sessions where a product was viewed from block recommendations.
    • Example: COUNT_DISTINCT(view_sessions)
  • cart_sessions (sessions)
    • Sessions where a product from block recommendations was added to cart.
    • Example: COUNT_DISTINCT(cart_sessions)
  • quantity_added_to_cart (items)
    • Items added to cart from block recommendations.
    • Example: SUM(quantity_added_to_cart)

​
Dimensions

  • block_id: The block identifier.
  • block_title: Title of the block at request time.
  • anchor_type: Anchor type of the block (product, collection, cart, none).
  • strategy_type: Strategy type used (interaction, similar_products, manual).
  • strategy_key: Strategy key (e.g., recipe name for interaction strategy).
  • num_results: Number of results returned.
  • shopping_channel: The shopping channel (e.g., online_store).
  • attribution_token: Token used to attribute downstream events/purchases back to this block request.
  • device_type: Device category.
  • geo_country: Two-letter country code.
  • geo_state: Up to three-letter province code.
  • geo_city: City name as captured.
  • marketing_source: UTM source.
  • marketing_medium: UTM medium.
  • marketing_campaign: UTM campaign.

​
Examples

Block requests by block (last 7 days) 
FROM blocks
SHOW COUNT_DISTINCT(requests)
GROUP BY block_id
SINCE -7d
Revenue attributed to blocks by strategy (this month) 
FROM blocks
SHOW SUM(total_sales)
GROUP BY strategy_type
SINCE this_month
Click-through and sales for a specific anchor type 
FROM blocks
SHOW COUNT_DISTINCT(click_sessions), SUM(total_sales)
GROUP BY block_id
WHERE anchor_type = 'product'
SINCE -30d
Block performance by country (past 30 days) 
FROM blocks
SHOW COUNT_DISTINCT(requests), SUM(total_sales)
GROUP BY geo_country
SINCE past_30_days

​
Next steps