Skip to content
trakbolt

Destinations

A destination sends your conversions to an ad platform from the server. Each platform can have several connections (pixels, data streams, ad accounts). Each one starts off and in test mode: events go to the platform's test tool, or are only checked, and nothing counts until you go live and switch sending on.

Step-by-step setup for each platform is on Platform setup. Event names and your own rules are on Event aliases and rules. Sales made in store or by phone are on Offline sales.

Platforms

PlatformSends toOne connection is aYou needOldest event accepted
Google AdsGoogle Ads (Data Manager)conversion accountGoogle sign-in · Google Ads account id (10 digits) · Conversion action id90 days
MetaMeta Conversions APIpixelPixel / dataset id · Conversions API access token7 days
PinterestPinterest Conversions APIad accountAd account id · Conversions access token7 days
RedditReddit Conversions APIpixelPixel id · Conversions API access token7 days
SnapchatSnapchat Conversions APIpixelPixel id · Conversions API token7 days
TikTokTikTok Events APIpixelPixel code · Events API access token7 days
Microsoft AdvertisingMicrosoft Advertising (UET Conversions API)UET tagUET tag id · Conversions API token90 days
Google Analytics 4Google Analytics 4data streamMeasurement ID (G-…) · Measurement Protocol API secret3 days
LinkedInLinkedIn Conversions APIad accountConversions API access token90 days
XX Conversions APIpixelPixel id · Pixel access token7 days
QuoraQuora Conversion APIad accountAd account id · Ad account currency · Conversion API token7 days
OpenAI AdsOpenAI Ads Conversions APIpixelPixel id · Conversions API key7 days
Google Enhanced ConversionsGoogle Enhanced Conversions (web)tag conversionGoogle sign-in · Google Ads account id (10 digits) · Conversion action to improve (id)1 day

Several pixels per platform

  • Settings → Destinations lists every platform. Open one to see its pixels in a table: name, the platform's id, status, a Sending switch, events accepted in the last 7 days and when the platform last accepted one.
  • Every pixel of a platform gets the same events. Each has its own ids, token, test mode and settings. New ones are named after the platform, for example "Meta pixel 1", "Meta pixel 2" or "GA4 data stream 1". You can rename them.
  • Add pixel (Add data stream, Add ad account… after the platform's own word) opens the connect page: where to find the values, step by step; a name; the ids and token; then Save and continue, which tests the connection. The new pixel starts off and in test mode.
  • Sending: switch it off to stop sending to one pixel. The other pixels of the platform keep sending.
  • Send a secure link: a one-time link for whoever holds the account. It fills in a pixel you pick, or adds a new one, without a Trakbolt login. Not for Google Ads or Google Enhanced Conversions, which need a Google sign-in.
  • Disconnect (Settings tab): stops sending and removes the pixel from the lists. Its delivery history stays in the delivery log. Events still waiting to be sent are skipped.

A pixel's status is one of: Not set up, Sending off, Failing, Needs a test, Test mode, Live. On the list of platforms, a platform shows its most urgent pixel.

The pixel tabs

TabWhat it has
OverviewThe last 7 days: events that apply to the pixel, how many were sent and how many the platform accepted; the match keys sent on purchases; the connection. Diagnostics groups the errors and warnings of the last 7 days by reason, with how often and what to fix; expected skips (free orders, no click from this platform…) come last. Platform quality score: the platform's own score, fetched with the saved token and kept 6 hours, for Meta (Event match quality) and Pinterest (Event quality score). Other platforms have no public API for it.
EventsEach of your events and the platform event it is sent as (its alias), with the per-event id where the platform needs one. Switch an event off to stop sending it. Below: built-in rules and your own event rules.
Test & activitySend a test event (with a Test ID for that one send if you like), Go live or Back to test, and the latest sends with the platform's answer.
SettingsThe ids and token, who is sent and the value sent, order rules, match keys, opted-out shoppers, product details, offline sales, name, secure link and disconnect.

Test mode works differently per platform; some platforms have none. See the test mode line of each platform on Platform setup.

Who is sent

By default an ad platform only receives the sales its own clicks led to (its click id or campaign in the buyer's journey). Google Analytics 4 is a reporting destination and receives every sale.

Retargeting

Each pixel has a Retargeting switch (Settings tab). On, every lead and buyer is sent to that platform with hashed email and phone, so you can build audiences there, for example people who signed up and did not buy, and leave buyers out. People who refused consent, test people and bots are never sent. The platform's own reports may count more conversions while it is on; Trakbolt's reports do not change. On a healthcare workspace an admin confirms the approval when switching it on, and only neutral event names are sent (step_1, step_2…). Audience lists can also be synced to Meta, Google Ads, Snapchat, Pinterest and Reddit (Audiences).

What is sent

  • The event name you mapped, the event time, the order id, value and currency.
  • Match keys: hashed email and phone (SHA-256, normalised; each platform in the format it expects), the platform's own click id, and the browser's user agent where the platform uses it.
  • On healthcare workspaces: neutral event names and the site's address without its path. Never a product, condition or plain-text contact detail.

Order rules

Settings tab → Orders. Each pixel has its own. A skipped order shows its reason in the delivery log.

SettingChoicesDefault
Order value
  • Total: The order total, shipping and tax included.
  • Without shipping and tax: The total minus shipping and tax, for orders whose source sends them (server events: shipping, tax). Orders without them are sent at their total.
Total
Skip free ordersOrders worth 0 are not sent.On
Minimum order valueOrders below it are not sent. It is in the store's currency and only compared with orders paid in that currency.None
Currency sent
  • Shopper's currency: Each order is sent in the currency it was paid in.
  • Store's currency: Only orders paid in the store's currency are sent; others are skipped. Trakbolt has no exchange rates, so nothing is converted.
Shopper's currency
Lead events
  • No value: Lead events are sent without a value (as before).
  • Your lead value: Each Lead event carries your lead value from Settings → General, in the workspace currency.
No value
Sign-up events
  • No value: Sign-ups are sent without a value (as before).
  • A fixed amount: Each sign-up carries the amount you set.
  • Your average order: Each sign-up carries the average net order value of the last 90 days (orders in the workspace currency).
No value

Lead events is shown only while the workspace has a value of a lead (Settings → General; lead and hybrid workspaces, never healthcare), on Meta (custom_data.value + currency), Pinterest (custom_data.value + currency), Snapchat (custom_data.value + currency), TikTok (properties.value + currency). Other platforms take the value set on their own conversion action.

Match keys

Settings tab → Customer data. Switch a key off to send less. Settings can only take keys away; health-data rules always apply on top. A key the platform does not take is shown but has no effect.

KeyWhat is sent
EmailHashed (SHA-256) before it leaves Trakbolt.
PhoneHashed (SHA-256) before it leaves Trakbolt.
Customer IDYour customer or patient id, hashed with this workspace's own salt (external id).
NameFirst and last name, hashed (SHA-256). Only when the client's data sharing allows names and contact details are kept.
AddressCity, state, zip and country, hashed (SHA-256). Only when the client's data sharing allows addresses and contact details are kept.
IP and browserThe browser's user agent and IP address from its latest visit (W138: the IP is kept encrypted, only for the lookback window, and never for visitors who refused consent).

Send people a platform can only partly match (off by default): with no email, phone or click id, the event is still sent where the platform accepts fewer keys (Pinterest: the IP address and browser together). It works only when your Trakbolt support has allowed it for your account.

Opted-out shoppers

A shopper whose latest visit refused consent. Each pixel chooses (default: Send with limited use):

  • Send with limited use: Sent with the platform's limited-use flag; not sent where the platform has none.
  • Don't send: Shoppers whose latest visit refused consent are never sent to this pixel.
PlatformMatch keys it takesOpted-out shoppers with limited use
Google AdsEmail, PhoneSent, consent block set to DENIED
MetaEmail, Phone, Customer ID, Name, Address, IP and browserSent, Limited Data Use (data_processing_options LDU)
PinterestEmail, Phone, Customer ID, Name, Address, IP and browserNot sent: the platform has no limited-use flag
RedditEmail, Phone, Customer ID, IP and browserNot sent: the platform has no limited-use flag
SnapchatEmail, Phone, Customer ID, Name, Address, IP and browserNot sent: the platform has no limited-use flag
TikTokEmail, Phone, Customer ID, IP and browserNot sent: the platform has no limited-use flag
Microsoft AdvertisingEmail, Phone, Customer IDNot sent: the platform has no limited-use flag
Google Analytics 4None (click and visit ids only)Sent, consent set to DENIED
LinkedInEmail, Customer IDNot sent: the platform has no limited-use flag
XEmail, Phone, IP and browserNot sent: the platform has no limited-use flag
QuoraEmail, IP and browserNot sent: the platform has no limited-use flag
OpenAI AdsEmail, Phone, Customer ID, IP and browserSent, opt_out set to true
Google Enhanced ConversionsEmail, PhoneNot sent: the platform has no limited-use flag

Product details

Settings tab → Products: what an event carries about its items. Sent on purchases (the order's items) and on product views, add to cart, checkout started and any other event your server sends with items (server events API: items, up to 50 per event). The site script sends no items. Default: None, with Product ID as the id.

Product detailsWhat is sent
FullProduct ids with name, category, price and quantity, where the platform takes them.
IDs onlyProduct ids with their quantities and the number of items.
NoneNo product data: value, currency and order id only.
Product id sentWhich id
Product IDYour product id (items[].id). Sent as a product group where the platform asks.
Variant IDYour variant id (items[].variant_id). Items without one are left out.
SKUYour SKU (items[].sku). Items without one are left out.

Use the id your platform's catalog is keyed on. Items come from your order's items (server events items, CSV imports, offline sales). Healthcare workspaces: always None, and the setting is locked. a product name or id can reveal a condition, so no product data is sent from this workspace.

PlatformProduct fields sentFull adds
Google Adscart data items (merchant product id, quantity)unit price
Metacontent_ids, contents (id, quantity), num_items, content_typeitem price
Pinterestcontent_ids, contents (id, quantity), num_itemsitem price, name, category
Redditproducts (id, quantity), item countname, category, item price
Snapchatcontent_ids, contents (id, quantity), num_itemsitem price
TikTokcontents (content id, quantity), content_type, num_itemsname, category, price
Microsoft AdvertisingNo product data from Trakbolt—
Google Analytics 4No product data from Trakbolt—
LinkedInNo product data from Trakbolt—
Xcontents (content_id, num_items, content_group_id), number_itemscontent_name, content_type (category), content_price
QuoraNo product data from Trakbolt—
OpenAI Adsdata.contents (id, quantity, group_id)name, amount (unit price, minor units), currency
Google Enhanced ConversionsNo product data from Trakbolt—

Once-per-visit events

On a platform's page, under its pixels: Send bulk events once per visit. It applies to every pixel of that platform. Only the first of each listed event in a visit is sent; later ones in the same visit are logged as skipped ("already sent once this visit"). It is off by default; the suggested events are item_list_viewed and product_viewed. Events of shoppers with no known visit are always sent.

Event names

Each standard event is sent under the platform's own name. Healthcare workspaces use the neutral set. Change them on a pixel's Events tab (see Event aliases and rules).

PlatformStandardHealthcare
Google Ads
  • checkout_completed → purchase
  • checkout_completed → purchase
Meta
  • product_viewed → ViewContent
  • search_performed → Search
  • generate_lead → Lead
  • stage_qualified → QualifiedLead
  • user_signed_up → CompleteRegistration
  • product_added_to_cart → AddToCart
  • product_added_to_wishlist → AddToWishlist
  • checkout_started → InitiateCheckout
  • payment_info_submitted → AddPaymentInfo
  • schedule → Schedule
  • checkout_completed → Purchase
  • generate_lead → step_1
  • user_signed_up → step_2
  • checkout_started → step_3
  • payment_info_submitted → step_4
  • schedule → step_5
  • checkout_completed → order_complete
  • stage_qualified → step_q
Pinterest
  • product_viewed → page_visit
  • item_list_viewed → view_category
  • search_performed → search
  • generate_lead → lead
  • user_signed_up → signup
  • product_added_to_cart → add_to_cart
  • checkout_started → custom
  • checkout_completed → checkout
  • generate_lead → lead
  • user_signed_up → signup
  • checkout_started → custom
  • checkout_completed → checkout
Reddit
  • product_viewed → VIEW_CONTENT
  • search_performed → SEARCH
  • generate_lead → LEAD
  • user_signed_up → SIGN_UP
  • product_added_to_cart → ADD_TO_CART
  • product_added_to_wishlist → ADD_TO_WISHLIST
  • checkout_started → CheckoutStarted
  • checkout_completed → PURCHASE
  • generate_lead → LEAD
  • user_signed_up → SIGN_UP
  • checkout_started → step_3
  • checkout_completed → PURCHASE
Snapchat
  • product_viewed → VIEW_CONTENT
  • search_performed → SEARCH
  • user_signed_up → SIGN_UP
  • generate_lead → SIGN_UP
  • product_added_to_cart → ADD_CART
  • product_added_to_wishlist → ADD_TO_WISHLIST
  • checkout_started → START_CHECKOUT
  • payment_info_submitted → ADD_BILLING
  • checkout_completed → PURCHASE
  • generate_lead → SIGN_UP
  • user_signed_up → CUSTOM_EVENT_1
  • checkout_started → START_CHECKOUT
  • payment_info_submitted → CUSTOM_EVENT_2
  • checkout_completed → PURCHASE
TikTok
  • product_viewed → ViewContent
  • search_performed → Search
  • generate_lead → SubmitForm
  • user_signed_up → CompleteRegistration
  • product_added_to_cart → AddToCart
  • product_added_to_wishlist → AddToWishlist
  • checkout_started → InitiateCheckout
  • payment_info_submitted → AddPaymentInfo
  • checkout_completed → CompletePayment
  • generate_lead → SubmitForm
  • user_signed_up → CompleteRegistration
  • checkout_started → InitiateCheckout
  • payment_info_submitted → AddPaymentInfo
  • checkout_completed → CompletePayment
Microsoft Advertising
  • generate_lead → lead
  • user_signed_up → sign_up
  • product_added_to_cart → add_to_cart
  • checkout_started → begin_checkout
  • schedule → book_appointment
  • checkout_completed → purchase
  • generate_lead → step_1
  • user_signed_up → step_2
  • checkout_started → step_3
  • payment_info_submitted → step_4
  • schedule → step_5
  • checkout_completed → order_complete
Google Analytics 4
  • product_viewed → view_item
  • item_list_viewed → view_item_list
  • search_performed → search
  • generate_lead → generate_lead
  • user_signed_up → sign_up
  • product_added_to_cart → add_to_cart
  • product_added_to_wishlist → add_to_wishlist
  • checkout_started → begin_checkout
  • checkout_shipping_info_submitted → add_shipping_info
  • payment_info_submitted → add_payment_info
  • checkout_completed → purchase
  • generate_lead → generate_lead
  • user_signed_up → sign_up
  • checkout_started → begin_checkout
  • payment_info_submitted → add_payment_info
  • checkout_completed → purchase
LinkedIn
  • generate_lead → LEAD
  • stage_qualified → QUALIFIED_LEAD
  • user_signed_up → SIGN_UP
  • product_added_to_cart → ADD_TO_CART
  • checkout_started → START_CHECKOUT
  • schedule → BOOK_APPOINTMENT
  • checkout_completed → PURCHASE
  • generate_lead → LEAD
  • user_signed_up → SIGN_UP
  • checkout_started → START_CHECKOUT
  • checkout_completed → PURCHASE
X
  • product_viewed → ContentView
  • search_performed → Search
  • generate_lead → SignUp
  • user_signed_up → SignUp
  • product_added_to_cart → AddToCart
  • product_added_to_wishlist → AddToWishlist
  • checkout_started → CheckoutInitiated
  • payment_info_submitted → AddedPaymentInfo
  • checkout_completed → Purchase
  • generate_lead → SignUp
  • user_signed_up → SignUp
  • checkout_started → CheckoutInitiated
  • payment_info_submitted → AddedPaymentInfo
  • checkout_completed → Purchase
Quora
  • search_performed → Search
  • generate_lead → GenerateLead
  • user_signed_up → CompleteRegistration
  • product_added_to_cart → AddToCart
  • product_added_to_wishlist → AddToWishlist
  • checkout_started → InitiateCheckout
  • payment_info_submitted → AddPaymentInfo
  • checkout_completed → Purchase
  • generate_lead → GenerateLead
  • user_signed_up → CompleteRegistration
  • checkout_started → InitiateCheckout
  • payment_info_submitted → AddPaymentInfo
  • checkout_completed → Purchase
OpenAI Ads
  • product_viewed → contents_viewed
  • generate_lead → lead_created
  • user_signed_up → registration_completed
  • product_added_to_cart → items_added
  • checkout_started → checkout_started
  • schedule → appointment_scheduled
  • checkout_completed → order_created
  • generate_lead → lead_created
  • user_signed_up → registration_completed
  • checkout_started → checkout_started
  • checkout_completed → order_created
Google Enhanced Conversions
  • checkout_completed → purchase
  • checkout_completed → purchase