Skip to content
trakbolt

Event aliases and rules

Both live on a pixel's Events tab and apply to that pixel only.

Event aliases

Each of your events is listed with the platform event it is sent as. Pick another of the platform's events, or type a name of your own where the platform takes one. Switch a row off to stop sending that event to this pixel. Some platforms also need an id per event.

PlatformNames of your ownAlso needs, per event
Google AdsIts own events onlyIn a rule, a conversion action: An “Import from clicks” conversion action of the same Google Ads account: its id (digits, in its details URL) or resource name customers/<account>/conversionActions/<id>.
Metaletters, digits, spaces, _ and -, 40 at most—
PinterestIts own events only—
Redditletters, digits, spaces, _ . and -, 64 at most—
SnapchatIts own events only—
TikTokletters, digits and _, 50 at most—
Microsoft Advertisingletters, digits, spaces, _ . and -, 60 at most—
Google Analytics 4starts with a letter; letters, digits and _, 40 at most—
LinkedInIts own events onlyConversion rule id: Campaign Manager → Conversions → the rule → its id (digits).
XIts own events onlyX event id: Events manager → the event → its id (tw-…).
QuoraIts own events only—
OpenAI Adsletters, digits, _ and -, 64 at most; sent in lower case—
Google Enhanced ConversionsIts own events only—

How a rule reads

PartWhat you pick
WhenOne of your events (a row of the Events tab).
MatchesGroups of conditions. Every condition in a group must match; the rule fires when any group matches. Up to 10 groups of 10 conditions. No conditions: every such event.
Then
  • Also send: The event goes out as usual, and this event is sent too.
  • Send instead: This event is sent in place of the usual one for this pixel.
AsOne of the platform's events, or a name of your own where the platform takes one, with its per-event id where needed. On Google Ads: a conversion action (purchases only), picked from the ones the pixel already sends to or entered as its id or resource name.

Examples:

  • When Purchase matches (page path starts with “/gift-cards”) or (currency equals “EUR”), also send GiftCardPurchase.
  • When Lead matches query parameter plan equals “annual”, send SubmitApplication instead.

Up to 20 rules per pixel, numbered and applied in that order. The first matching Send instead rule wins: move a rule up or down (the arrow buttons beside it, which also work from the keyboard) to change which one. An event that matches several rules sends each name once (a name with its own id, such as a conversion action, counts as its own). Rules apply to events from now on, not to past ones. Order rules, match keys, product details and once per visit apply to rule events as to any other.

Google Ads counts each conversion action on its own. Funnel steps (intake, sign-up, checkout started) are sent from the Events tab as “conversion”, each with its own conversion action. A rule on a Google Ads pixel is for the purchase and sends it to a conversion action: pick one the pixel already sends to (its own, from the Settings tab, or one another rule uses), or enter its id (digits) or resource name customers/<account>/conversionActions/<id>. The action must be in the same Google Ads account, an “Import from clicks” action like the pixel's own. Also send to the pixel's own action is refused (it already gets every purchase); Send instead to another action moves matching purchases there.

Conditions

FieldCompare withWhat it is
Page URLequals, does not equal, contains, starts with, ends withThe page the event was sent from, as host and path (no https://, www., query or #). Browser events only.
Page pathequals, does not equal, contains, starts with, ends withThe path of the page the event was sent from. Browser events only.
Query parameterequals, does not equal, contains, starts with, ends withA query parameter of the page the event was sent from (utm_campaign, plan…). Browser events only.
Referrerequals, does not equal, contains, starts with, ends withThe page before it (document.referrer), as host and path. Browser events only.
Event valueequals, does not equal, is greater than, is less thanThe event's value, or its order's, in the event's currency (149 = 149.00).
Currencyequals, does not equal, contains, starts with, ends withThe event's or order's currency code.
Customer's order countequals, does not equal, is greater than, is less thanThe customer's orders up to and including this one (test orders never count). 1 = first order.
New customeris yes, is noThe order is the customer's first, as the source said or Trakbolt counted.
Order statusequals, does not equal, contains, starts with, ends withThe status the source sent with the event, else the order's.
Product idequals, does not equal, contains, starts with, ends withAny item of the order, or of a view / cart / checkout event that lists items: product id, variant id or SKU. Not offered on healthcare workspaces.
Event propertyequals, does not equal, contains, starts with, ends withAn extra field your source keeps on the event (properties.<name>). Case-sensitive name.
  • Text ignores case. Addresses compare as host and path: no https://, www., query, # or trailing slash.
  • Numbers: 149.00 equals 149.
  • A list (the order's product ids) matches when any item does; does not equal matches when none does.
  • A missing value never matches, not even does not equal.
  • Page conditions (page URL, page path, query parameter, referrer) match browser events only. Server events have no page, so these conditions never match them.
  • Values are up to 500 characters. A value that looks like an email address is refused: no contact data in rules.

Purchase names

A platform's purchase event can only come from a purchase. A rule on any other event that sends one of these names is refused when you save it, and skipped if it was stored before:

PlatformPurchase names
Google Adspurchase
Metapurchase, order_complete
Pinterestcheckout, purchase
Redditpurchase
Snapchatpurchase
TikTokcompletepayment, purchase
Microsoft Advertisingpurchase, order_complete
Google Analytics 4purchase
LinkedInpurchase
Xpurchase
Quorapurchase
OpenAI Adsorder_created, purchase
Google Enhanced Conversionspurchase

Healthcare workspaces

  • Conditions can compare page addresses and query values, but those values are never sent: the page still goes out as its domain only.
  • The product id condition is not offered.
  • Event names must be neutral: a standard platform name that can be restricted for health businesses is refused, for aliases and rules alike.

Built-in rules

These are set elsewhere and listed with your rules, read-only, with an Edit link to their own controls: new customers only, the event sent for returning customers, high-value customers (an extra event when lifetime spend reaches a threshold) and later stages (an event when an order's status changes).