TrueMetriks documentation: Main
https://docs.truemetriks.com/dashboard/main/

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: Main.
The Main dashboard is your at-a-glance overview: traffic and revenue stat cards, a trend chart, and breakdown panels for referrers, pages, tech, and geography.

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: Main
https://docs.truemetriks.com/dashboard/main/
===============================================================================

## The overview cards

The row of cards at the top is your headline summary for the selected period. Each card shows the metric, its percent change versus the previous period of equal length (green means it moved the good way, red means worse), and a small sparkline of the trend.


The traffic cards:

- **Unique Users** - how many distinct people visited.
- **Sessions** - how many visits (a session ends after 30 minutes of inactivity).
- **Pageviews** - total pages loaded across all visits.
- **Pages per Session** - average number of pages viewed per visit.
- **Bounce Rate** - share of visits that left after a single page.
- **Session Duration** - average length of a visit.

The commerce cards:

- **Purchases** - number of completed purchase events.
- **Revenue** - total sales value in the period.
- **AOV** - average order value (revenue divided by purchases).
- **Conversion Rate** - share of sessions that ended in a purchase.
- **New Buyers** - buyers making their first-ever purchase.
- **Returning Buyers** - buyers who had purchased before.

## The trend chart


The chart plots one metric over time. The solid line is the selected period and the grey line is the previous period of equal length, so you can see whether you are up or down. Use the **Day** control to change the grain (hour, day, week, month), and hover any point to read the exact value.

## Referrers and Pages

These two panels sit side by side and answer "where did traffic come from" and "what did it land on."


**Referrers** ranks the sites that sent you traffic. The **Channels** tab groups those sources (Paid Social, Organic Search, Direct, and so on), and the **UTM** tab breaks traffic down by your [campaign tags](https://docs.truemetriks.com/dashboard/utm-builder/).


**Pages** ranks your most-visited URLs. The **Titles** tab lists the same visits by page title instead of path, and **Entries** and **Exits** show which pages visits start and end on.

## Browsers and Countries


**Browsers** shows what your visitors browse with. The **Devices**, **Operating Systems**, and **Screen Dimensions** tabs answer the same "what are they using" question for hardware and software.


**Countries** shows where your visitors are. The **Regions**, **Cities**, **Languages**, **Map**, and **Timezones** tabs zoom in on the same geography from different angles.

## Events and Weekly Trends


**Events** counts how often each tracked action fired - Lead, Purchase, View Product, and any other [event you send](https://docs.truemetriks.com/dashboard/events/). The **Outbound Links** tab counts clicks that left your site.


**Weekly Trends** is a heatmap of activity by hour and day of week - darker cells are busier times. Switch the metric in the selector to find when your audience is most active.

===============================================================================
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.

  Main
    The guide ................................... https://docs.truemetriks.com/dashboard/main/
    The overview cards .......................... https://docs.truemetriks.com/dashboard/main/#the-overview-cards
    The trend chart ............................. https://docs.truemetriks.com/dashboard/main/#the-trend-chart
    Referrers and Pages ......................... https://docs.truemetriks.com/dashboard/main/#referrers-and-pages
    Browsers and Countries ...................... https://docs.truemetriks.com/dashboard/main/#browsers-and-countries
    Events and Weekly Trends .................... https://docs.truemetriks.com/dashboard/main/#events-and-weekly-trends