Checkout / payments

Server-Side Tracking for SamCart

Stop losing conversions to iOS ITP, short-lived cookies, and ad-blockers. TrakSolv hosts a first-party server-side GTM container for your SamCart store and forwards clean, deduplicated conversions to GA4, Meta CAPI, Google Ads and more. Live in minutes, flat monthly pricing.

No credit card to startFlat monthly pricingNative SamCart dataLayerGA4 · Meta CAPI · Google Ads
Why it matters for SamCart

The pixel alone is leaking your data.

Browser-side tracking on SamCart loses a growing share of conversions. Here's what moving to a server-side setup fixes.

Recover conversions lost to ITP & ad-blockers

On SamCart, browser-side pixels are throttled by Safari/Firefox ITP, capped 7-day cookies, and blocked outright by ad-blockers and consent walls. Server-side tracking moves the measurement off the browser, so checkout completions that the pixel silently drops are recovered and reported.

First-party data, served from your own domain

TrakSolv hosts your Google Tag Manager server container on a subdomain of your SamCart site. Requests come from a first-party context — they survive 3rd-party cookie deprecation, last far longer than client-side cookies, and look like your own traffic, not a tracker.

Clean, deduplicated conversions to every ad platform

The SamCart dataLayer fires every GA4 enhanced-ecommerce event with a stable event_id, so your server-side container can forward checkout completions to GA4, Meta CAPI, Google Ads Enhanced Conversions, TikTok and more — deduplicated against the browser pixel, with higher match quality.

Step by step

How to set up server-side tracking on SamCart

Paste the TrakSolv loader and the SamCart dataLayer snippet into your store's custom-code area, save, and you're done. Every step below has the exact snippet with a copy button.

Install guide

How to install on SamCart

This is your install. Every step below has its exact snippet with a Copy button — go step by step. The Loader card above and DataLayer card below are reference copies of the same snippets.

  1. 1

    Open Advanced for the Product you want tracked

    Navigate

    SamCart → Products → your Product → Advanced tab

    SamCart tracking is per-product. Repeat for each product you sell. Site-wide pixel install lives in Marketplace → Pixels.

  2. 2

    Loader — head half

    Loader • Head

    Tracking & Pixels tab → Head Tracking Code → paste the Loader Head snippet

  3. 3

    Loader — body half + DataLayer

    Loader • Body

    Tracking & Pixels tab → Body Tracking Code → paste the Loader Body snippet FIRST

  4. 4

    DataLayer snippet (Fire After Order field)

    DataLayer

    Advanced tab → 'Fire Pixels/Scripts After An Order is Completed' field → paste the DataLayer snippet

    The DataLayer auto-reads window.order_summary (SamCart's typed order object) and falls back to ##order_id## / ##product_name## shortcodes if needed.

    HTML
    <!-- Traksolv · SamCart DataLayer — Product → Advanced → Fire Pixels/Scripts After Order -->
    <script>
    (function (w) {
      w.dataLayer = w.dataLayer || [];
      var DEBUG = false;
      try {
        var q = new URLSearchParams(location.search);
        if (q.get('tcDebug') === '1') { DEBUG = true; try { localStorage.setItem('tcDebug', '1'); } catch (e) {} }
        else if (q.get('tcDebug') === '0') { DEBUG = false; try { localStorage.removeItem('tcDebug'); } catch (e) {} }
        else { try { if (localStorage.getItem('tcDebug') === '1') DEBUG = true; } catch (e) {} }
      } catch (e) {}
      w.tcDebug = DEBUG;
      if (DEBUG && w.console && w.console.log) {
        try { w.console.log('%c[Traksolv]%c dataLayer debug ON — every push will log here. Disable with ?tcDebug=0', 'color:#22c55e;font-weight:600;background:#0a1f0c;padding:2px 6px;border-radius:3px', ''); } catch (e) {}
      }
      function log() {
        if (!DEBUG || !w.console || !w.console.log) return;
        try { w.console.log.apply(w.console, ['[Traksolv]'].concat([].slice.call(arguments))); } catch (e) {}
      }
      function push(eventName, eventId, params) {
        try {
          if (params && params.ecommerce !== undefined) w.dataLayer.push({ ecommerce: null });
          var ev = { event: eventName, event_id: eventName + '.' + eventId };
          if (params) for (var k in params) if (Object.prototype.hasOwnProperty.call(params, k)) ev[k] = params[k];
          w.dataLayer.push(ev);
          log('push ' + eventName, ev);
        } catch (e) {}
      }
      function once(key) {
        try { if (sessionStorage.getItem(key)) return false; sessionStorage.setItem(key, '1'); return true; }
        catch (e) { return true; }
      }
    
      w.tcFirePurchase = function (o) {
        try {
          if (!o || !o.orderId) return;
          if (!once('tc_purchase_' + o.orderId)) return;
          push('purchase', String(o.orderId), {
            ecommerce: {
              transaction_id: String(o.orderId),
              value:    Number(o.value) || 0,
              currency: o.currency || 'USD',
              items:    Array.isArray(o.items) ? o.items : []
            }
          });
        } catch (e) {}
      };
    
      // Prefer the typed JS object. Fall back to SamCart shortcodes if the
      // merchant pasted them in the snippet (the variable strings below
      // are substituted by SamCart at render time on the order page).
      function firePurchaseFromSamCart() {
        try {
          // (1) Typed JS object — most reliable, has products array.
          var os = w.order_summary;
          if (os && (os.id || os.invoice_id || os.order_id)) {
            var oid = os.id || os.invoice_id || os.order_id;
            if (!once('tc_purchase_' + oid)) return;
            var items = (os.products || os.items || []).map(function (p, i) {
              return {
                item_id:       String(p.id || p.product_id || p.name || ('item.' + i)),
                item_name:     p.name || p.product_name || '',
                item_category: p.type || 'product',
                price:         (Number(p.price) || Number(p.unit_price) || 0) / (p.price > 1000 ? 100 : 1),
                quantity:      Number(p.quantity) || 1,
                index:         i
              };
            });
            var total = Number(os.total) || Number(os.total_paid) || items.reduce(function (s, x) { return s + (x.price || 0) * (x.quantity || 1); }, 0);
            if (total > 1000 && os.total && String(os.total).indexOf('.') === -1) total = total / 100;
            push('purchase', String(oid), {
              ecommerce: {
                transaction_id: String(oid),
                affiliation:    'SamCart',
                value:          total,
                tax:            Number(os.tax)      || undefined,
                shipping:       Number(os.shipping) || undefined,
                discount:       Number(os.discount) || undefined,
                currency:       os.currency || 'USD',
                items:          items.length ? items : undefined
              },
              user_id:    (os.customer && (os.customer.id || os.customer_id)) || undefined,
              user_email: (os.customer && os.customer.email) || os.customer_email || undefined
            });
            return;
          }
    
          // (2) Shortcode fallback — SamCart substitutes these on the
          //     thank-you page render. If the script is loaded elsewhere
          //     (e.g. external custom thank-you), they stay as literal
          //     strings and we skip silently.
          var shortcode = {
            orderId:     "##order_id##",
            productName: "##product_name##",
            productPrice:"##product_price##",
            customerEmail:"##customer_email##",
            total:       "##order_total##"
          };
          if (shortcode.orderId && shortcode.orderId.indexOf('##') === -1) {
            if (!once('tc_purchase_' + shortcode.orderId)) return;
            var price = parseFloat(String(shortcode.productPrice || shortcode.total || '0').replace(/[^\d.\-]/g, '')) || 0;
            var tt    = parseFloat(String(shortcode.total || shortcode.productPrice || '0').replace(/[^\d.\-]/g, '')) || price;
            push('purchase', String(shortcode.orderId), {
              ecommerce: {
                transaction_id: String(shortcode.orderId),
                affiliation:    'SamCart',
                value:          tt,
                currency:       'USD',
                items: [{
                  item_id:       shortcode.productName || String(shortcode.orderId),
                  item_name:     shortcode.productName || 'SamCart product',
                  item_category: 'samcart',
                  price:         price,
                  quantity:      1
                }]
              },
              user_email: shortcode.customerEmail || undefined
            });
          }
        } catch (e) {}
      }
    
      w.tcPageType = function () {
        var p = (location.pathname || '').toLowerCase();
        if (/(thank|success|complete|confirm|receipt|order)/.test(p)) return 'thank-you';
        return 'other';
      };
    
      // Brief poll — SamCart sometimes injects order_summary after our snippet runs.
      var attempts = 0;
      function tryFire() {
        firePurchaseFromSamCart();
        var os = w.order_summary;
        if (os && (os.id || os.invoice_id || os.order_id)) return;
        if (++attempts > 30) return; // ~3s
        setTimeout(tryFire, 100);
      }
      if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', tryFire);
      else tryFire();
    })(window);
    </script>
    <!-- End Traksolv SamCart DataLayer -->
    
    <!-- Traksolv · DataLayer enrichment — customer lifecycle + remarketing + attribution -->
    <script>
    (function (w, d) {
      function readLT() {
        try {
          var raw = localStorage.getItem('tc_lifetime');
          var p = raw ? JSON.parse(raw) : null;
          return {
            orderCount:    (p && p.orderCount)    || 0,
            lifetimeValue: (p && p.lifetimeValue) || 0,
            firstOrderTs:  (p && p.firstOrderTs)  || null,
            lastOrderTs:   (p && p.lastOrderTs)   || null,
            lastOrderId:   (p && p.lastOrderId)   || null
          };
        } catch (e) {
          return { orderCount: 0, lifetimeValue: 0, firstOrderTs: null, lastOrderTs: null, lastOrderId: null };
        }
      }
      function writeLT(lt) {
        try { localStorage.setItem('tc_lifetime', JSON.stringify(lt)); } catch (e) {}
      }
      function tier(v) {
        if (v >= 1000) return 'vip';
        if (v >= 250)  return 'mid';
        if (v > 0)     return 'low';
        return 'guest';
      }
      function readCookie(n) {
        try {
          var m = d.cookie.match(new RegExp('(^|; )' + n + '=([^;]+)'));
          return m ? decodeURIComponent(m[2]) : null;
        } catch (e) { return null; }
      }
      function readAttr() {
        try { var r = readCookie('_tc_attr'); return r ? JSON.parse(r) : null; } catch (e) { return null; }
      }
    
      w.tcReadLifetime    = readLT;
      w.tcCustomerTier    = function (v) { return tier(v != null ? v : readLT().lifetimeValue); };
      w.tcReadAttribution = readAttr;
    
      // ── Wrap tcFirePurchase to add customer-lifecycle + attribution ──
      // before the underlying snippet pushes the purchase event. Idempotent
      // per orderId, so customer refreshing the thank-you page doesn't
      // inflate their lifetime counters.
      var orig = w.tcFirePurchase;
      if (typeof orig === 'function') {
        w.tcFirePurchase = function (o) {
          try {
            if (!o || !o.orderId) return orig.apply(this, arguments);
            var lt = readLT();
            var firstFire = lt.lastOrderId !== String(o.orderId);
            var orderCount    = firstFire ? lt.orderCount + 1 : lt.orderCount;
            var lifetimeValue = firstFire ? lt.lifetimeValue + (o.value || 0) : lt.lifetimeValue;
            var firstOrderTs  = lt.firstOrderTs || Date.now();
            var newCustomer   = orderCount === 1;
            var daysSinceFirst = Math.floor((Date.now() - firstOrderTs) / 86400000);
    
            if (firstFire) {
              writeLT({
                orderCount:    orderCount,
                lifetimeValue: lifetimeValue,
                firstOrderTs:  firstOrderTs,
                lastOrderTs:   Date.now(),
                lastOrderId:   String(o.orderId)
              });
            }
    
            var attr = readAttr();
            // Build the enriched order. Preserve every original field; add
            // customer + attribution on top.
            var enriched = {};
            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) enriched[k] = o[k];
            enriched.new_customer            = newCustomer;
            enriched.customer_type           = newCustomer ? 'new' : 'returning';
            enriched.customer_status         = 'customer';
            enriched.customer_lifetime_value = Math.round(lifetimeValue * 100) / 100;
            enriched.customer_order_count    = orderCount;
            enriched.customer_aov            = orderCount > 0 ? Math.round((lifetimeValue / orderCount) * 100) / 100 : 0;
            enriched.purchase_number         = orderCount;
            enriched.days_since_first_order  = daysSinceFirst;
            enriched.value_tier              = tier(lifetimeValue);
            if (attr) enriched.attribution = {
              landing:   attr.u   || null,
              referrer:  attr.r   || null,
              utm:       attr.utm || null,
              click_ids: attr.cid || null
            };
            return orig.call(this, enriched);
          } catch (e) {
            try { return orig.apply(this, arguments); } catch (e2) {}
          }
        };
      }
    
      // ── tc_visitor_context — emits visitor lifecycle + remarketing on
      //    every page-view. GTM / GA4 audience triggers + Google Ads
      //    dynamic remarketing tag read these.
      function visitorContext() {
        try {
          var lt = readLT();
          var attr = readAttr();
          var pageType = (typeof w.tcPageType === 'function') ? (w.tcPageType() || 'other') : 'other';
          w.dataLayer = w.dataLayer || [];
          w.dataLayer.push({
            event:                   'tc_visitor_context',
            event_id:                'tc_visitor_context.' + Date.now() + '.' + Math.random().toString(36).slice(2, 6),
            customer_status:         lt.orderCount > 0 ? 'returning_customer' : 'guest',
            customer_type:           lt.orderCount > 0 ? 'returning' : 'guest',
            value_tier:              tier(lt.lifetimeValue),
            customer_lifetime_value: Math.round(lt.lifetimeValue * 100) / 100,
            customer_order_count:    lt.orderCount,
            days_since_first_order:  lt.firstOrderTs ? Math.floor((Date.now() - lt.firstOrderTs) / 86400000) : null,
            ecomm_pagetype:          pageType,
            attribution: attr ? {
              landing:   attr.u   || null,
              referrer:  attr.r   || null,
              utm:       attr.utm || null,
              click_ids: attr.cid || null
            } : null
          });
        } catch (e) {}
      }
      if (d.readyState === 'loading') d.addEventListener('DOMContentLoaded', visitorContext);
      else visitorContext();
    })(window, document);
    </script>
    <!-- End Traksolv enrichment -->
  5. 5

    Toggle 'Fire Pixels Before Redirect' ON (CRITICAL)

    Save

    Tracking & Pixels tab → 'Fire Pixels Before Redirect' toggle → ON

    If you redirect to a custom thank-you URL after order completion, this toggle is REQUIRED. Without it the snippet may not finish firing before the redirect happens and the purchase event will be lost.

  6. 6

    Save and test

    Save

    Save → place a $0 test order to verify the purchase event fires

    ?tcDebug=1 in the URL on the thank-you page will log order_summary alongside the purchase push.

The loader Head + Body snippets are generated for your container inside the TrakSolv dashboard. Create a free account to grab them, or see the full how-it-works walkthrough.

FAQ

Server-side tracking for SamCart, answered

Does server-side tracking work with SamCart?

Yes. TrakSolv works with SamCart via a lightweight loader snippet plus a SamCart-specific dataLayer that fires every GA4 enhanced-ecommerce event. You paste it once in SamCart's custom-code area and conversions start flowing through your own server-side GTM container.

How do I install TrakSolv on SamCart?

Add the TrakSolv loader (head + body) and the SamCart dataLayer snippet to your store's custom-code settings, then save. The full step-by-step is on this page. Most SamCart merchants are live in a few minutes — no developer required.

What can I track server-side on SamCart?

Page views, product views, checkout completions, begin-checkout and more — every standard GA4 enhanced-ecommerce event, forwarded server-side to GA4, Meta CAPI, Google Ads and other destinations with deduplication.

How much does server-side tracking for SamCart cost?

TrakSolv uses flat monthly pricing — one event sent to many destinations still counts as one event, and paid plans never auto-pause at quota. You can start free and go live in minutes.

Recover your SamCart conversions — start free.

Spin up a first-party server-side GTM container for SamCart and watch your match quality climb. No credit card, live in minutes.

WhatsApp
Server-Side Tracking for SamCart — TrakSolv | Traksolv