product_ recommendation_ conversions
The product_recommendation_conversions schema captures the funnel from a shopper seeing a product recommendation through clicking, adding to cart, and checking out. It has one row per product, so recommendation performance is comparable product by product.
Anchor to Use casesUse cases
- Recommendation funnel: Show
sessions_with_product_recommendations,product_recommendation_sessions_with_clicks, andproduct_recommendation_sessions_with_cart_additionsto trace drop-off between seeing a recommendation and adding to cart. - Conversion by product: Group
product_recommendation_conversion_ratebyproduct_idto rank products by conversion from recommendations. - Rate comparison: Compare
product_recommendation_click_ratewithproduct_recommendation_added_to_cart_rateto see whether clicks on recommendations turn into cart additions.
ShopifyQL
Examples
Description
Rank the top 50 products by `product_recommendation_conversion_rate` this quarter, with click and add-to-cart rates. This example uses [`HAVING`](/docs/api/shopifyql/latest/syntax/having) `sessions_with_product_recommendations > 100` to drop low-traffic products from the ranking.
ShopifyQL
FROM product_recommendation_conversions SHOW sessions_with_product_recommendations, product_recommendation_sessions_with_clicks, product_recommendation_click_rate, product_recommendation_conversion_rate, product_recommendation_added_to_cart_rate GROUP BY product_id HAVING sessions_with_product_recommendations > 100 DURING this_quarter ORDER BY product_recommendation_conversion_rate DESC LIMIT 50 VISUALIZE product_recommendation_conversion_rate TYPE horizontal_barDescription
Track the recommendation funnel week by week this quarter, from sessions through `product_recommendation_conversion_rate`. This example pairs [`PERCENT_CHANGE`](/docs/api/shopifyql/latest/syntax/with#percent-change-columns) with [`COMPARE TO previous_period`](/docs/api/shopifyql/latest/syntax/compare-to) to add a column measuring each week against the quarter before.
ShopifyQL
FROM product_recommendation_conversions SHOW sessions_with_product_recommendations, product_recommendation_click_rate, product_recommendation_added_to_cart_rate, product_recommendation_conversion_rate TIMESERIES week WITH TOTALS, PERCENT_CHANGE DURING this_quarter COMPARE TO previous_period ORDER BY week ASCDescription
Track weekly product-recommendation sessions that added to cart and those that completed checkout across this quarter. This example uses [`WITH TOTALS`](/docs/api/shopifyql/latest/syntax/with#total-columns) to add a quarter-to-date total beside the weekly rows.
ShopifyQL
FROM product_recommendation_conversions SHOW product_recommendation_sessions_with_cart_additions, product_recommendation_sessions_that_completed_checkout TIMESERIES week WITH TOTALS DURING this_quarter ORDER BY week ASC VISUALIZE product_recommendation_sessions_that_completed_checkout TYPE lineDescription
Track weekly `sessions_with_product_recommendations` by `product_id` across last month. This example uses [`GROUP_TOTALS`](/docs/api/shopifyql/latest/syntax/with#group-total-columns) to add a per-week total across products beside the per-product bands, with `LIMIT 50` capping the returned rows.
ShopifyQL
FROM product_recommendation_conversions SHOW sessions_with_product_recommendations GROUP BY product_id WITH TOTALS, GROUP_TOTALS TIMESERIES week DURING last_month ORDER BY week ASC LIMIT 50 VISUALIZE sessions_with_product_recommendations TYPE stacked_bar
Anchor to MetricsMetrics
Counts and calculations that let you track key business indicators. Metrics show up as the columns when queried.
Metrics you can use when querying .
- Anchor to product_recommendation_added_to_cart_rateproduct_
recommendation_ added_ to_ cart_ rateproduct_ recommendation_ added_ to_ cart_ rate PERCENTPERCENT A session contributes at most one count to the rate, even when multiple recommended items are added to the cart.
- Anchor to product_recommendation_click_rateproduct_
recommendation_ click_ rateproduct_ recommendation_ click_ rate PERCENTPERCENT A session contributes at most one count to the rate, even when multiple recommendations are clicked.
- Anchor to product_recommendation_conversion_rateproduct_
recommendation_ conversion_ rateproduct_ recommendation_ conversion_ rate PERCENTPERCENT A session contributes at most one count to the rate, even when multiple recommended items are purchased.
- Anchor to product_recommendation_sessions_that_completed_checkoutproduct_
recommendation_ sessions_ that_ completed_ checkoutproduct_ recommendation_ sessions_ that_ completed_ checkout INTEGERINTEGER Number of online store sessions in which a customer clicked on a product recommendation and purchased that recommended item
- Anchor to product_recommendation_sessions_with_cart_additionsproduct_
recommendation_ sessions_ with_ cart_ additionsproduct_ recommendation_ sessions_ with_ cart_ additions INTEGERINTEGER Number of online store sessions in which a customer clicked on a product recommendation and added that recommended item to their cart
- Anchor to product_recommendation_sessions_with_clicksproduct_
recommendation_ sessions_ with_ clicksproduct_ recommendation_ sessions_ with_ clicks INTEGERINTEGER Number of online store sessions in which a customer clicked on a product recommendation
- Anchor to sessions_with_product_recommendationssessions_
with_ product_ recommendationssessions_ with_ product_ recommendations INTEGERINTEGER Number of online store sessions in which a customer was shown a product recommendation
PERCENT
A percentage value represented as a decimal, where 0.25 represents 25%.
INTEGER
Whole number without decimal places, used for counts and quantities
Anchor to DimensionsDimensions
Attributes of your data that let you look more granularly at aspects of the data. Group and filter by dimensions to shape the rows your query returns.
Dimensions you can use when querying .
- Anchor to daydaydayDAY_TIMESTAMPDAY_TIMESTAMP
Use this field to view product recommendation conversions by day.
- Anchor to day_of_weekday_
of_ weekday_ of_ week DAY_OF_WEEKDAY_OF_WEEK Use this field to view product recommendation conversions by day of the week, with values Monday through Sunday.
- Anchor to hourhourhourHOUR_TIMESTAMPHOUR_TIMESTAMP
Use this field to view product recommendation conversions by hour.
- Anchor to hour_of_dayhour_
of_ dayhour_ of_ day HOUR_OF_DAYHOUR_OF_DAY Use this field to view product recommendation conversions by hour of the day, with values 0 through 23.
- Anchor to monthmonthmonthMONTH_TIMESTAMPMONTH_TIMESTAMP
Use this field to view product recommendation conversions by month.
- Anchor to month_of_yearmonth_
of_ yearmonth_ of_ year MONTH_OF_YEARMONTH_OF_YEAR Use this field to view product recommendation conversions by month of the year, with values 1 through 12.
- Anchor to product_idproduct_
idproduct_ id IDENTITYIDENTITY - Anchor to quarterquarterquarterQUARTER_TIMESTAMPQUARTER_TIMESTAMP
Use this field to view product recommendation conversions by quarter.
- Anchor to shop_idshop_
idshop_ id IDENTITYIDENTITY - Anchor to weekweekweekWEEK_TIMESTAMPWEEK_TIMESTAMP
Use this field to view product recommendation conversions by week.
- Anchor to week_of_yearweek_
of_ yearweek_ of_ year WEEK_OF_YEARWEEK_OF_YEAR Use this field to view product recommendation conversions by week of the year, with values 1 through 53.
- Anchor to yearyearyearYEAR_TIMESTAMPYEAR_TIMESTAMP
Use this field to view product recommendation conversions by year.
- Anchor to product_statusproduct_
statusproduct_ status STRINGSTRING The product's current publishing state, with values Active, Archived, Draft, Suspended, and Unlisted.
- Anchor to product_titleproduct_
titleproduct_ title STRINGSTRING Display name of the product that your customers see
- Anchor to product_typeproduct_
typeproduct_ type STRINGSTRING Type (category) that you've assigned to the product
- Anchor to product_vendorproduct_
vendorproduct_ vendor STRINGSTRING Vendor of the product
- Anchor to shop_nameshop_
nameshop_ name STRINGSTRING Name of your store
- Anchor to product_collectionproduct_
collectionproduct_ collection STRINGSTRING Collection associated with the product
- Anchor to product_collectionsproduct_
collectionsproduct_ collections ARRAY<STRING>ARRAY<STRING> Set of collections associated with the product
- Anchor to app_product_creationapp_
product_ creationapp_ product_ creation STRINGSTRING The app that created the product, shown as an app name.
- Anchor to product_tagproduct_
tagproduct_ tag STRINGSTRING Tag associated with the product
- ARRAY<STRING>ARRAY<STRING>
Set of tags associated with the product
DAY_TIMESTAMP
Date with the time of day removed
DAY_OF_WEEK
Day of the week, used to group or filter data by weekday
HOUR_TIMESTAMP
Date and time with minutes and seconds removed
HOUR_OF_DAY
Hour of the day, shown as a whole number from 0 to 23
MONTH_TIMESTAMP
Date for the start of a month
MONTH_OF_YEAR
Month number within a year
IDENTITY
Unique identifier for a Shopify resource such as a customer or order
QUARTER_TIMESTAMP
Date for the start of a fiscal quarter
WEEK_TIMESTAMP
Date for the start of a week
WEEK_OF_YEAR
Week number within a year
YEAR_TIMESTAMP
Date for the start of a year
STRING
Text made of letters, numbers, or symbols
ARRAY
A list of values. The element type appears inside angle brackets, such as ARRAY<STRING>.
low_engagement_product_recommendations: Recommendation products performing below the store average, to pair with these converters.