TrueMetriks documentation: Events https://docs.truemetriks.com/dashboard/events/ 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: Events. Define custom events in TrueMetriks and pick exactly what makes each one fire: a URL match, a click, scroll depth, time on page, or another event firing. 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: Events https://docs.truemetriks.com/dashboard/events/ =============================================================================== ## What this page is for TrueMetriks already tracks the built-in events (PageView, Lead, Purchase, and so on). The Events page is for everything else you want to measure: a newsletter signup, a "Get started" click, someone reaching the bottom of a sales page. You define the event once here, and the tracker on your site starts firing it whenever its condition is met. Where each event is sent (Facebook, Google Ads, [GA4](https://docs.truemetriks.com/ad-integrations/ga4/), [TikTok](https://docs.truemetriks.com/ad-integrations/tiktok/)) is handled separately, inside each ad integration card under Settings - Tracking. This page is only about defining the event itself. ## Creating an event Click **Create event** in the top right. The dialog asks for a few details: - **Event name** - the technical name for the event, like `MyCustomEvent`. This is the name your integrations use, so keep it short and consistent. - **Display name (optional)** - a friendly label shown in the dashboard, like "Newsletter Signup". Purely cosmetic. - **Description (optional)** - a note to yourself about what this event represents. - **Active** - the on/off switch. Leave it on and the tracker fires the event; switch it off to pause it without deleting it. ## Choosing how the event fires Every event has exactly one **firing condition**. The **Condition type** dropdown decides what triggers it, and the fields below it change to match your choice. - **URL match** - fires when the visitor lands on a matching page. You pick a **URL operator** (`contains`, `equals`, `starts with`, or `regex`) and a **URL value** like `/thank-you`. For example, "contains `/thank-you`" fires on any page whose address includes `/thank-you`, which is the usual way to catch a confirmation page. - **Button click** - fires when a visitor clicks an element. You target it either by **CSS selector** (like `#cta-button`) or by **Visible text** (like `Get Started`). - **Scroll depth** - fires once the visitor scrolls a set percentage down the page (for example 50%). Good for measuring real engagement on long pages. - **Time on page** - fires after the visitor has stayed a set number of seconds (for example 30). Another simple engagement signal. - **Fires when another event fires** - fires whenever a built-in event fires. This is how you give an existing action a second, custom name. ### Fires when another event fires When you pick this option, you choose a **Source event** - one of the built-in events. Your custom event then fires every time that source event does, and it carries all of the source event's parameters along with it. This is handy when an advertiser needs a differently named event for a platform's rules. For example, point a custom event at the built-in **Purchase** so the same sale also fires under your own name, without changing anything in your checkout. ## After you save Hit **Save** and the event joins your Custom events list, ready to fire. To decide where it gets sent, open the relevant ad integration card under Settings - Tracking and map it there. The built-in events that can power conversions are explained in the [Facebook](https://docs.truemetriks.com/docs/ad-integrations/facebook/) and [Google Ads](https://docs.truemetriks.com/docs/ad-integrations/google-ads/) guides. =============================================================================== 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. Events The guide ................................... https://docs.truemetriks.com/dashboard/events/ What this page is for ....................... https://docs.truemetriks.com/dashboard/events/#what-this-page-is-for Creating an event ........................... https://docs.truemetriks.com/dashboard/events/#creating-an-event Choosing how the event fires ................ https://docs.truemetriks.com/dashboard/events/#choosing-how-the-event-fires Fires when another event fires .............. https://docs.truemetriks.com/dashboard/events/#fires-when-another-event-fires After you save .............................. https://docs.truemetriks.com/dashboard/events/#after-you-save