TrueMetriks documentation: Products https://docs.truemetriks.com/dashboard/products/ Generated from the TrueMetriks documentation. Paste the whole of this file into ChatGPT, Claude, Gemini, Cursor or any other AI. I use TrueMetriks, a server-side tracking and conversion attribution platform. It tracks my website visitors, ties every sale back to the ad that produced it, and sends those conversions back to my ad platforms. Help me with this specific task: Products. The Products page ranks every product by revenue, units, views, and conversion, then expands each one into the sources, campaigns, and ads that drove its sales. HOW TO GUIDE ME - This file has three parts: THE GUIDE is today's task, BACKGROUND is a prerequisite to confirm with me before you start THE GUIDE, not optional reading, and LINK MAP is the only place a real link comes from. - Ask me ONE thing at a time and wait for my answer before moving on. - At the start of every step, ask me: "do you want the written steps, or the video?" If I pick the video, give me the exact link from the LINK MAP at the bottom and wait until I tell you I have watched it. If I pick the written steps, give them to me from this file. - Only ever give me links that appear in the LINK MAP below. Never invent a URL, never guess an anchor, and if I ask for something that has no link here, say so and point me at https://docs.truemetriks.com/ instead. - Never ask me for my password, my API key, my MCP key, or any card details. You are reading me the steps; I am the one clicking in my own account. - Confirm each step worked before starting the next one. - Keep it short. I am doing this while looking at my screen, not reading an essay. - Everything you need is in this file. You do not need to browse the web. =============================================================================== THE GUIDE: Products https://docs.truemetriks.com/dashboard/products/ =============================================================================== **Video guide** VIDEO: A walkthrough of the Products page and the per-product source drill-down -> https://docs.truemetriks.com/dashboard/products/ ## What the Products page is Products turns your Purchase and product-view [events](https://docs.truemetriks.com/dashboard/events/) into a single ranked table: one row per product, sorted by units sold, with the totals for the whole period pinned across the top. It answers the questions you actually care about - which products bring in the money, which get looked at but not bought, and which convert best - without exporting anything to a spreadsheet. A product appears here as soon as it shows up in your event data. Identity uses the item's `id`, then `sku`, then its name, taken from the products carried on the event, so identify and name your products consistently and they stay merged across views and purchases. ## Attribution and Audience Two dropdowns above the totals rescope the entire page at once - the totals, the table, and every source drill-down under it. - **Attribution** decides which touch gets the credit for a sale. **First-touch** credits the source that first brought the buyer in, **Last-touch** credits the source of the visit where they bought, and **Any-touch** credits every source the buyer passed through. Switching this changes which campaigns and ads a product's sales are assigned to. - **Audience** filters by buyer type: **New + Returning** (everyone), **New** (first-time buyers only), or **Returning** (people who had bought before). Set these once and read the whole page through that lens. ## The four totals The cards across the top are the period totals, scoped to your date range and any active filter. - **Total revenue** - the sum of the `value` on every Purchase event that carries a product, in the selected period. - **Total units sold** - how many quantities of your products were sold in the period, added up across every product. A 3-unit order counts as 3, not 1. - **Total product views** - the number of product-view events (`ViewContent`) for any product. - **Total site visits** - the distinct people who visited your site in the period. This is the denominator for the "Conv. (site to buy)" column. Purchases that arrive with no product information at all are excluded from the table and reported separately below these totals, so the page's total can legitimately sit below your Overview revenue. ## The table columns Each row is one product. Every column is sortable, so click a header to rank by it. - **Views** - how many times this product was viewed (a `ViewContent` event carrying this product). - **Units sold** - how many quantities of this product were sold. A 3-unit order counts as 3, not 1. - **Revenue** - total revenue from this product in the period: this product's share of the order value on each Purchase event that carried it. An order with three products splits its `value` across those three rows, so no product is credited with money that belongs to another. - **Contribution %** - this product's share of total product revenue. The whole column adds up to 100%, so you can see at a glance which few products carry the store. - **Conv. (view to buy)** - of the people who viewed this product, the share who went on to buy it. This is measured per person across all their devices, so someone who views on mobile and buys on desktop still counts as one converted viewer. A dash means the product had no views to convert. - **Conv. (site to buy)** - of everyone who visited your site in the period, the share who bought this product. The numbers are small because the denominator is your whole audience, not just the people who saw the product. It tells you how much of your total traffic a single product manages to convert. The **Total** row at the bottom sums the period: total revenue, total units, 100% contribution, and the blended conversion rates across all products. ## Drill into the sources behind a product Every product row has an arrow on its left. Click it and the row opens into a **source drill-down**: a tree that breaks that single product's sales down by where they came from, so you can see not just that a product sells, but which traffic actually drives it. The tree has just two columns - **Sales** (how many people bought through that node) and **Revenue** (how much it brought in) - and you expand it one level at a time: - **Source** - the top level, like `facebook`, `google`, or `(Direct)` for visitors who arrived with no tags and no referrer (typed the URL, a bookmark, or a link that stripped its referrer). - **Medium** - `paid` versus organic traffic under that source. - **Campaign** - your `CAMPAIGN`-tagged campaigns under that medium. - **Ad set** - the `AD SET` (Facebook) or `AD GROUP` (Google and TikTok) inside a campaign. - **Ad** - the individual `AD` that closed the sale. Open only the branches you care about. The numbers always roll up, so a campaign's sales equal the sum of its ad sets, and a source's sales equal the sum of its campaigns plus any direct or untagged sales. Because the drill-down obeys the Attribution and Audience dropdowns, switching to **Last-touch** or to **New** buyers re-credits and re-counts the whole tree. This is what turns Products from a leaderboard into an action list: when one product carries the store, the drill-down tells you the exact campaign, ad set, and ad to scale. ## Reading it The two conversion columns answer different questions, and the gap between them is the point. - A **high view-to-buy** with a **low site-to-buy** means the product closes well once people find it, but not many visitors reach it. The fix is traffic and merchandising - get more eyes on the page. - A **low view-to-buy** means people look and walk away. The fix is the offer or the page itself - price, copy, proof. - **Contribution %** tells you where to spend that effort. Improving the conversion of a product that is 12% of revenue moves the business; perfecting one that is 0.3% does not. To dig into the orders behind these numbers, see [Revenue](https://docs.truemetriks.com/docs/dashboard/revenue/). To follow how visitors reach a product before buying, see [Journeys](https://docs.truemetriks.com/docs/dashboard/journeys/). =============================================================================== LINK MAP Use these exact URLs. Anything ending in a # anchor opens on that section or that video. Nothing else is a valid link. Never invent a URL and never guess an anchor. Products The guide ................................... https://docs.truemetriks.com/dashboard/products/ What the Products page is ................... https://docs.truemetriks.com/dashboard/products/#what-the-products-page-is Attribution and Audience .................... https://docs.truemetriks.com/dashboard/products/#attribution-and-audience The four totals ............................. https://docs.truemetriks.com/dashboard/products/#the-four-totals The table columns ........................... https://docs.truemetriks.com/dashboard/products/#the-table-columns Drill into the sources behind a product ..... https://docs.truemetriks.com/dashboard/products/#drill-into-the-sources-behind-a-product Reading it .................................. https://docs.truemetriks.com/dashboard/products/#reading-it VIDEO, A walkthrough of the Products page and the per-product source drill-down https://docs.truemetriks.com/dashboard/products/