tonigtn

<p>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.</p>
<p>Once installed and configured with your Shop ID, the plugin:</p>
<ul>
<li>Loads a lightweight tracking script (wc.js) on your storefront that captures ad click identifiers (fbclid, ttclid, gclid, etc.) into first-party cookies.</li>
<li>Injects hidden tracking fields into the WooCommerce checkout form so the click data follows the customer into the order.</li>
<li>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.</li>
</ul>
<p><strong>Supported platforms (configured in your FirstTrack dashboard):</strong></p>
<ul>
<li>Meta Conversions API</li>
<li>TikTok Events API</li>
<li>Google Enhanced Conversions</li>
<li>Pinterest Conversions API</li>
<li>Snapchat Conversions API</li>
<li>X (Twitter) Conversions API</li>
</ul>
<p><strong>Features:</strong></p>
<ul>
<li>10-tier deterministic + probabilistic attribution with a confidence score per order</li>
<li>First-party tracking domain support (custom subdomain)</li>
<li>HPOS (WooCommerce High-Performance Order Storage) compatible</li>
<li>Cookie-consent aware (respects <code>_ft_consent</code> cookie and <code>window.__ft_consent</code>)</li>
<li>No bundled ad-platform SDKs in your storefront — all server-to-server</li>
</ul>
<h3>External services</h3>
<p>This plugin relies on the FirstTrack service at <strong>first-track.org</strong> to deliver server-side ad conversion events. A free account at first-track.org is required for the plugin to function.</p>
<p><strong>Service: FirstTrack (first-track.org)</strong></p>
<p>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.</p>
<p><strong>Script loaded on every storefront page:</strong></p>
<p>On every front-end page, this plugin enqueues a JavaScript file from FirstTrack. The default URL is:</p>
<ul>
<li><code>https://first-track.org/wc.js?shop=<your-shop-id></code></li>
</ul>
<p>If the site administrator has configured a custom tracking domain (via the WordPress option <code>firsttrack_tracking_domain</code>, typically a CNAME subdomain like <code>track.yourstore.com</code> that resolves to FirstTrack’s infrastructure), the script is loaded from that custom host instead:</p>
<ul>
<li><code>https://<your-custom-tracking-domain>/wc.js?shop=<your-shop-id></code></li>
</ul>
<p>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.</p>
<p>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.</p>
<p><strong>Data sent to first-track.org (or the configured custom tracking domain, which resolves to first-track.org):</strong></p>
<ul>
<li>When a visitor lands on your storefront from an ad: the click identifier in the URL (e.g. <code>fbclid</code>, <code>ttclid</code>, <code>gclid</code>, <code>epik</code>, <code>sccid</code>, <code>twclid</code>), 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.</li>
<li>When a purchase is placed: the order’s tracking field values (<code>_ft_*</code> 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.</li>
</ul>
<p><strong>Why:</strong> 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.</p>
<p><strong>Terms and privacy:</strong></p>
<ul>
<li>Terms of Service: <a href="https://first-track.org/terms" rel="nofollow ugc">https://first-track.org/terms</a></li>
<li>Privacy Policy: <a href="https://first-track.org/privacy" rel="nofollow ugc">https://first-track.org/privacy</a></li>
<li>Data Processing Addendum: <a href="https://first-track.org/dpa" rel="nofollow ugc">https://first-track.org/dpa</a></li>
</ul>


FirstTrack — Server-Side Ad Tracking

Server-side conversion tracking for WooCommerce. Sends checkout events to 6 ad platforms via official server APIs with 10-tier attribution.

khanhvo

dloxton

<p>This Fathom Analytics <em>partner plugin</em> makes it easy to enable WordPress forms and pages as <a href="https://usefathom.com" rel="nofollow ugc">Fathom Analytics</a> Events with <em>no code</em>.</p>
<p>👉 Go to the official <a href="https://wordpress.org/plugins/fathom-analytics/" rel="ugc">Fathom Analytics plugin</a></p>
<h4>What does this companion plugin do?</h4>
<p>Makes it easy to track user actions such as form submissions and landing page visits as events in your Fathom Analytics account.</p>
<p>Best of all <em>no technical knowledge is required</em> to implement events on your site.</p>
<h4>Key Features</h4>
<ul>
<li>No code event tracking for marketers and website owners</li>
<li>Common form plugins supported</li>
<li>Make any page or post an Event</li>
<li>Synchronized event names between website and analytics</li>
</ul>
<h4>Watch the setup walkthrough</h4>
<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/nyi7d1SMBeo?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<h4>This is not an official Fathom plugin</h4>
<p>This WordPress plugin “Fathom Conversions” is not part of, or associated with “Fathom Analytics” by Conva Ventures Inc.</p>
<h4>⚠️ Warning BETA API in use</h4>
<p>This plugin uses the Beta Fathom Analytics API, which is still in early access, and subject to changes in the future, this plugin could stop working without warning if updates occur.</p>
<h4>Privacy Notices</h4>
<p>This plugin:</p>
<ul>
<li>does not track any users</li>
<li>stores plugin settings and event mappings in the WordPress database</li>
<li>sends data to the Fathom Analytics servers – more information can be found on <a href="https://usefathom.com" rel="nofollow ugc">Fathom Analytics</a> website</li>
</ul>
<h4>Demo</h4>
<p>You can find more information about the plugin, and see a demo and installation instructions on the <a href="https://fathomconversions.com" rel="nofollow ugc">Fathom Conversions website</a></p>
<h4>Requirements</h4>
<p>For this to work you will need a paid <a href="https://usefathom.com/ref/LBSJIU" rel="nofollow ugc">Fathom Analytics account</a> (get $10 off your first month with this link)</p>
<p>And a supported WordPress plugin listed below installed and active.</p>
<h4>Currently supported plugins</h4>
<ul>
<li><a href="https://wordpress.org/plugins/contact-form-7/" rel="ugc">Contact Form 7</a></li>
<li><a href="https://wordpress.org/plugins/wpforms-lite/" rel="ugc">WPForms</a> & <a href="https://wpforms.com/" rel="nofollow ugc">WPForms Pro</a></li>
<li><a href="https://www.gravityforms.com/" rel="nofollow ugc">Gravity Forms</a></li>
<li><a href="https://wordpress.org/plugins/ninja-forms/" rel="ugc">Ninja Forms</a> & <a href="https://ninjaforms.com/" rel="nofollow ugc">Ninja Forms Pro</a></li>
<li><a href="https://wordpress.org/plugins/fluentform/" rel="ugc">Fluent Forms</a> & <a href="https://fluentforms.com/" rel="nofollow ugc">Fluent Forms Pro</a></li>
<li><a href="https://woocommerce.com/" rel="nofollow ugc">WooCommmerce</a></li>
</ul>
<h3>For Developers</h3>
<p>Fathom Analytics Conversions provides hooks and helper functions so that plugin and theme developers can fire Fathom conversion events from their own code.</p>
<h4>Quick Start</h4>
<p>The simplest way to fire a conversion from your plugin:</p>
<pre><code>// Fire a basic conversion event.
add_action( 'wp_footer', function() {
    do_action( 'fac_track_event', 'My Custom Conversion' );
});

// Fire a conversion with a monetary value (in cents, e.g. 1999 = $19.99).
add_action( 'wp_footer', function() {
    do_action( 'fac_track_event', 'Premium Signup', 4999 );
});
</code></pre>
<p>The event name you pass here will appear in your Fathom Analytics dashboard. If the event doesn’t exist yet, Fathom will create it automatically on the first fire.</p>
<h4>PHP Helper Function</h4>
<p>You can also call the helper function directly:</p>
<pre><code>/**
 * fac_track_conversion( string $event_name, int $value = 0 )
 *
 * Outputs a fathom.trackEvent() script tag on the frontend.
 * Must be called during or before wp_footer output.
 *
 * @param string $event_name  Event name (shown in Fathom dashboard).
 * @param int    $value       Optional. Value in cents. Default 0.
 */

add_action( 'wp_footer', function() {
    if ( function_exists( 'fac_track_conversion' ) ) {
        fac_track_conversion( 'Booking Confirmed', 15000 );
    }
});
</code></pre>
<p>Both methods automatically check that Fathom Analytics is active and respect excluded user roles — you don’t need to add those checks yourself.</p>
<h4>Available Filters</h4>
<p>You can customize event names for built-in integrations using these filters:</p>
<ul>
<li><code>fac_woocommerce_order_title</code> — Customize the WooCommerce order event name. Default: “WooCommerce Order”.</li>
<li><code>fac_login_event_title</code> — Customize the login event name. Default: “WP Login”.</li>
<li><code>fac_registration_event_title</code> — Customize the registration event name. Default: “WP Registration”.</li>
<li><code>fac_lost_password_event_title</code> — Customize the lost password event name. Default: “WP Lost Password”.</li>
</ul>
<p>Example:</p>
<pre><code>add_filter( 'fac_woocommerce_order_title', function( $title ) {
    return 'Shop Purchase';
});
</code></pre>
<h4>Adding a Custom Integration to the Settings Page</h4>
<p>Use these filters and actions to add your own integration checkbox to the plugin’s settings page:</p>
<pre><code>// 1. Add a default option.
add_filter( 'fac4wp_global_default_options', function( $defaults ) {
    $defaults['integrate-my-plugin'] = false;
    return $defaults;
});

// 2. Add a checkbox to the Integration section.
add_filter( 'fac4wp_integrate_field_texts', function( $fields ) {
    $fields['integrate-my-plugin'] = [
        'label'           => 'My Plugin',
        'description'     => 'Track conversions from My Plugin.',
        'phase'           => 'fac4wp-phase-stable',
        'plugin_to_check' => 'my-plugin/my-plugin.php',
    ];
    return $fields;
});

// 3. Fire the conversion when your plugin's action completes.
add_action( 'wp_footer', function() {
    $options = get_option( 'fac4wp-options', [] );
    if ( ! empty( $options['integrate-my-plugin'] ) && my_plugin_conversion_happened() ) {
        do_action( 'fac_track_event', 'My Plugin Conversion' );
    }
});
</code></pre>
<h4>JavaScript API</h4>
<p>If you need to fire a Fathom event directly from JavaScript (e.g., after an AJAX action), you can call the Fathom tracking function directly. The Fathom Analytics script exposes a global <code>fathom</code> object:</p>
<pre><code>// Basic event
fathom.trackEvent('My JS Event');

// Event with monetary value (in cents)
fathom.trackEvent('My JS Event', { _value: 1999 });
</code></pre>
<p>Note: The <code>fathom</code> object is only available on the frontend when the Fathom Analytics plugin is active and the tracking script has loaded.</p>
<h4>Utility Functions</h4>
<p>These functions are available for checking the plugin state:</p>
<ul>
<li><code>is_fac_fathom_analytic_active()</code> — Returns <code>true</code> if Fathom Analytics tracking is active.</li>
<li><code>fac_fathom_is_excluded_from_tracking()</code> — Returns <code>true</code> if the current user’s role is excluded.</li>
<li><code>FAC_Options::get( $key )</code> — Retrieve a specific plugin option value.</li>
</ul>


Fathom Analytics Conversions

Easily add conversions in WordPress plugins to Fathom Analytics

FirstTrack — Server-Side Ad Tracking vs Fathom Analytics Conversions