Events
The Events page is where you define custom events. You name the event, switch it on, and pick one condition that decides when it fires - a URL match, a click, a scroll, time on page, or another event firing.
Set this up with AI
Copy this prompt into ChatGPT, Claude or whichever AI you use. It carries this whole guide, the pages it depends on, and a link to every video, so it can walk you through it one step at a time.
Events
This page defines custom events. To control where each event fires, open the relevant ad integration card under Settings → Tracking.
Custom events
No custom events yet. Click “Create event” to add one.
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.
Once it fires, the event is sent to Facebook and TikTok under its own name and to GA4. Google Ads only receives the standard events. To stop sending your own events to Facebook or TikTok, use the Your own events switch on a pixel in the Facebook or TikTok card under Settings - Tracking. This page is only about defining the event itself. Looking for Facebook custom conversions? Those are set up on your pixel instead, under Custom conversion events.
Creating an event
Click Create event in the top right. The dialog asks for a few details:
Firing condition
Platform mappings (Facebook, Google Ads, GA4, TikTok) are now managed inside each ad integration card under Settings - Tracking. This page defines the event itself.
- 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, orregex) 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 (likeGet 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.
All parameters from the selected event will be passed to the custom event.
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. It goes to Facebook and GA4 from its first fire, and to each TikTok pixel whose Your own events switch is On. To stop sending it to Facebook or TikTok, switch off Your own events on the pixel in the Facebook or TikTok card. The built-in events that can power conversions are explained in the Facebook and Google Ads guides.
Frequently asked questions
What conditions can trigger a custom event?
Each event has exactly one firing condition: a URL match, a button click, scroll depth, time on page, or firing when another built-in event fires.
Does this page control where events are sent to Facebook, TikTok or Google Ads?
No. The Events page only defines the event. Facebook, TikTok and GA4 receive it automatically; Google Ads only receives standard events. You can stop sending your own events to Facebook or TikTok per pixel with the Your own events switch under Settings - Tracking - Facebook or TikTok.
Is this where I create Facebook custom conversions?
No. Facebook custom conversions are set up on your pixel, not here. Open Settings, Tracking, Ad integrations, pick the Facebook tab, expand your pixel row and click Create in Custom conversion events. TrueMetriks then creates the Custom Conversion in Facebook for you.
Can I rename a built-in event like Purchase?
Yes, indirectly. Use the 'Fires when another event fires' condition to create a custom-named event that fires alongside a built-in one and carries its parameters.