TrueMetriks documentation: Users https://docs.truemetriks.com/dashboard/users/ 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: Users. Users is the people-level view in TrueMetriks: one row per person with lifetime sessions, events, purchases, and spend, plus a full per-person profile. 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: Users https://docs.truemetriks.com/dashboard/users/ =============================================================================== Every person who has been on your site shows up here once, whether or not you have identified them. Anonymous visitors get a stable name and ID that persists across all of their visits; once your site identifies them with a user ID, their real identifier takes over. The numbers on each row are lifetime totals, not just today. ## Reading the table Each row is one person; the columns are their lifetime profile at a glance. - **User** - the avatar and name. Anonymous people keep a stable generated name (like "Black Puma"); identified people show the ID you sent. - **Country, Channel, Browser, OS, Device** - where they are and how they browse, taken from their most recent visit. Traffic from an in-app browser (Instagram, for example) shows that app. - **Pageviews, Events, Sessions** - lifetime counts across every visit. - **Purchases** and **Total Spent** - how many purchase events they have fired and the summed value, so your buyers rise to the top. - **Last Seen** and **First Seen** - recency and how long they have been a known visitor. Every metric column is sortable: click a header to rank by it. Sort by Total Spent to find your highest-value customers, or by Last Seen to see who came back today. ## Tabs, search, and filters - **Users / Traits / Imported customers** - the Users tab is this list. Traits shows the custom attributes you have attached to people; Imported customers shows records you have brought in from outside the tracker. - **Search by username** narrows the list to a single person by name or ID. - **Identified only** hides anonymous visitors so you see just the people you have a user ID for. - **Buyers only** keeps only people with at least one purchase. ## Opening a profile Click any row to open that person's profile. It is everything TrueMetriks knows about them in one place: their lifetime stats, where and how they browse, when they were active, the pages they return to, and every visit they have made. The profile is built from these blocks: - **Lifetime stats** - total sessions, pageviews, and events, their average session duration, and the first and last time you saw them. - **Location and Device** - country, region, and language, plus the device, browser, OS (with versions), and screen size from their latest visit. A dash means that detail was not available. - **Activity Calendar** - a day-by-day heatmap of when this person was active, so you can see whether they are a one-time visitor or a regular. - **Top Pages** - the pages they have spent the most sessions on, ranked. - **Visit history** - every session this person has had, newest first, in the same card format as the [Sessions](https://docs.truemetriks.com/dashboard/sessions/) feed. ## Visit history and the timeline Each visit in the history is the same card you see on the Sessions page, and it expands the same way. Click one to open its full event timeline. The Timeline lists every event in that visit in order, with the time spent on each page, and the type pills up top filter it. Open Session Info on any visit for the complete device, location, and source breakdown for that session. For the full mechanics, see [Sessions](https://docs.truemetriks.com/dashboard/sessions/). **Video guide** VIDEO: How user journeys, visit history, and the timeline work in TrueMetriks -> https://docs.truemetriks.com/dashboard/users/#visit-history-and-the-timeline ## How a person becomes identified Until you tell TrueMetriks who someone is, they are tracked as a stable anonymous person so none of their history is lost. When your site identifies a visitor with a user ID (an email, a customer ID, whatever you use), that visitor's past and future visits collapse onto the one identified profile. =============================================================================== 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. Users The guide ................................... https://docs.truemetriks.com/dashboard/users/ Reading the table ........................... https://docs.truemetriks.com/dashboard/users/#reading-the-table Tabs, search, and filters ................... https://docs.truemetriks.com/dashboard/users/#tabs-search-and-filters Opening a profile ........................... https://docs.truemetriks.com/dashboard/users/#opening-a-profile Visit history and the timeline .............. https://docs.truemetriks.com/dashboard/users/#visit-history-and-the-timeline How a person becomes identified ............. https://docs.truemetriks.com/dashboard/users/#how-a-person-becomes-identified VIDEO, How user journeys, visit history, and the timeline work in TrueMetriks https://docs.truemetriks.com/dashboard/users/#visit-history-and-the-timeline