Title: FirstTrack — Server-Side Ad Tracking
Author: tonigtn
Published: Junie 3, 2026
Last modified: Junie 3, 2026
---
Soek deur uitbreidings
# FirstTrack — Server-Side Ad Tracking
Deur [tonigtn](https://profiles.wordpress.org/tonigtn/)
[Laai Af](https://downloads.wordpress.org/plugin/firsttrack.1.0.0.zip)
* [Besonderhede](https://af.wordpress.org/plugins/firsttrack/#description)
* [Aanbevelings](https://af.wordpress.org/plugins/firsttrack/#reviews)
* [Installation](https://af.wordpress.org/plugins/firsttrack/#installation)
* [Ontwikkeling](https://af.wordpress.org/plugins/firsttrack/#developers)
[Hulp](https://wordpress.org/support/plugin/firsttrack/)
## Beskrywing
FirstTrack is a bridge plugin that connects your WooCommerce store to the FirstTrack
server-side tracking service at first-track.org. A free account at first-track.org
is required.
Once installed and configured with your Shop ID, the plugin:
* Loads a lightweight tracking script (wc.js) on your storefront that captures
ad click identifiers (fbclid, ttclid, gclid, etc.) into first-party cookies.
* Injects hidden tracking fields into the WooCommerce checkout form so the click
data follows the customer into the order.
* Saves the captured data into HPOS-safe order meta and (as a backup) into the
order’s customer note. The FirstTrack backend then forwards purchase events to
the configured ad platforms over their official server APIs.
**Supported platforms (configured in your FirstTrack dashboard):**
* Meta Conversions API
* TikTok Events API
* Google Enhanced Conversions
* Pinterest Conversions API
* Snapchat Conversions API
* X (Twitter) Conversions API
**Features:**
* 10-tier deterministic + probabilistic attribution with a confidence score per
order
* First-party tracking domain support (custom subdomain)
* HPOS (WooCommerce High-Performance Order Storage) compatible
* Cookie-consent aware (respects `_ft_consent` cookie and `window.__ft_consent`)
* No bundled ad-platform SDKs in your storefront — all server-to-server
### External services
This plugin relies on the FirstTrack service at **first-track.org** to deliver server-
side ad conversion events. A free account at first-track.org is required for the
plugin to function.
**Service: FirstTrack (first-track.org)**
What it is: a server-side ad conversion tracking service that forwards purchase
events from your WooCommerce store to ad platforms (Meta, TikTok, Google, Pinterest,
Snapchat, X / Twitter) using each platform’s official server-to-server Conversions
API. The plugin is the bridge layer that runs on your store; the FirstTrack service
runs at first-track.org and does the platform forwarding.
**Script loaded on every storefront page:**
On every front-end page, this plugin enqueues a JavaScript file from FirstTrack.
The default URL is:
* `https://first-track.org/wc.js?shop=`
If the site administrator has configured a custom tracking domain (via the WordPress
option `firsttrack_tracking_domain`, typically a CNAME subdomain like `track.yourstore.
com` that resolves to FirstTrack’s infrastructure), the script is loaded from that
custom host instead:
* `https:///wc.js?shop=`
In both cases the destination server is FirstTrack’s infrastructure — the custom
domain is a CNAME alias only. No data ever goes to a third party other than FirstTrack
and (server-to-server, via the FirstTrack backend) the ad platforms that you have
configured in your FirstTrack dashboard.
The script captures ad click identifiers into first-party cookies on the visitor’s
browser and, on the WooCommerce checkout page, injects them as hidden form fields
so the click data follows the order.
**Data sent to first-track.org (or the configured custom tracking domain, which
resolves to first-track.org):**
* When a visitor lands on your storefront from an ad: the click identifier in the
URL (e.g. `fbclid`, `ttclid`, `gclid`, `epik`, `sccid`, `twclid`), the referring
URL, the visitor’s user agent, and a randomly generated visitor UUID. These are
stored as first-party cookies on the visitor’s browser and posted to the FirstTrack
click endpoint at the configured tracking domain.
* When a purchase is placed: the order’s tracking field values (`_ft_*` meta) plus
hashed customer email/phone and the order total, currency, line item IDs, billing
city/state/country/postcode. Personally-identifying fields are SHA-256 hashed
before transmission per the requirements of the ad platforms’ server APIs.
**Why:** FirstTrack uses the click and purchase data to send conversion events to
the ad platforms you have configured in your FirstTrack dashboard (Meta Conversions
API, TikTok Events API, Google Enhanced Conversions, Pinterest Conversions API,
Snapchat Conversions API, X Conversions API). This is required to attribute purchases
back to ad campaigns when browser-based pixels are blocked.
**Terms and privacy:**
* Terms of Service: [https://first-track.org/terms](https://first-track.org/terms)
* Privacy Policy: [https://first-track.org/privacy](https://first-track.org/privacy)
* Data Processing Addendum: [https://first-track.org/dpa](https://first-track.org/dpa)
## Screenshots
* [[
* Unified dashboard — revenue, orders, attribution, and delivery health for every
connected store in one view.
* [[
* Reports — weekly and monthly KPI reports with one-click PDF export and scheduled
email delivery.
* [[
* Ten-tier attribution engine — orders matched through multiple signals, tier by
tier, with a confidence score.
## Installation
1. Sign up for a free account at [first-track.org](https://first-track.org/signup)
and copy your Shop ID from the dashboard.
2. Upload the `firsttrack` folder to `/wp-content/plugins/` (or install through the
WordPress plugin directory).
3. Activate the plugin in **Plugins**.
4. Go to **FirstTrack** in the admin menu and paste your Shop ID. Save.
5. Open your storefront — tracking begins immediately. Place a test order to confirm
events appear in your FirstTrack dashboard.
## Kwel-vrae
### Do I need a FirstTrack account?
Yes. The plugin is a bridge between your WooCommerce store and the FirstTrack service(
first-track.org). The plugin alone does not send events to ad platforms; FirstTrack
does that on the server side using credentials you configure in the FirstTrack dashboard.
### What data does the plugin send to first-track.org?
See the **External services** section below for the full data list, transmission
timing, and links to the terms of service, privacy policy, and DPA.
### Is HPOS supported?
Yes. The plugin writes order meta through WooCommerce’s `WC_Order` API, which is
HPOS-safe.
### Does it work with the WooCommerce Blocks checkout?
This release targets the classic shortcode checkout (`[woocommerce_checkout]`).
Block-based checkout compatibility is on the roadmap.
### How do I uninstall cleanly?
Deleting the plugin from **Plugins** runs `uninstall.php`, which removes the two
options the plugin stores (`firsttrack_shop_id`, `firsttrack_tracking_domain`).
Order meta captured on past orders is preserved.
## Aanbevelings
There are no reviews for this plugin.
## Contributors & Developers
“FirstTrack — Server-Side Ad Tracking” is oopbron sagteware. Die volgende mense
het bygedra tot die ontwikkeling van hierdie uitbreiding:
Contributors
* [ tonigtn ](https://profiles.wordpress.org/tonigtn/)
[Translate “FirstTrack — Server-Side Ad Tracking” into your language.](https://translate.wordpress.org/projects/wp-plugins/firsttrack)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/firsttrack/), check
out the [SVN repository](https://plugins.svn.wordpress.org/firsttrack/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/firsttrack/) by
[RSS](https://plugins.trac.wordpress.org/log/firsttrack/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.0.0
* Initial public release.
* WooCommerce classic checkout tracking (Shop ID + custom tracking domain).
* HPOS-safe order meta via `WC_Order::update_meta_data()`.
* Customer-note `ft:{JSON}` backup path for backend fallback.
* Explicit verification of the WooCommerce checkout nonce.
* Uninstall handler removes plugin options.
* Localized — text domain `firsttrack`.
## Meta
* Version **1.0.0**
* Last updated **3 dae gelede**
* Active installations **Minder as 10**
* WordPress version ** 5.8 or higher **
* Tested up to **7.0**
* PHP version ** 7.4 or higher **
* Language
* [English (US)](https://wordpress.org/plugins/firsttrack/)
* Tags
* [analytics](https://af.wordpress.org/plugins/tags/analytics/)[attribution](https://af.wordpress.org/plugins/tags/attribution/)
[conversions](https://af.wordpress.org/plugins/tags/conversions/)[tracking](https://af.wordpress.org/plugins/tags/tracking/)
[woocommerce](https://af.wordpress.org/plugins/tags/woocommerce/)
* [Gevorderde Aansig](https://af.wordpress.org/plugins/firsttrack/advanced/)
## Punte-toekennings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/firsttrack/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/firsttrack/reviews/)
## Contributors
* [ tonigtn ](https://profiles.wordpress.org/tonigtn/)
## Hulp
Got something to say? Need help?
[Gaan na die hulp-forum](https://wordpress.org/support/plugin/firsttrack/)