Shopify Manual Revenue Attribution Recipe

Step 1: Storefront Pixel Tracking

Add the standard SourceTrack pixel script to your storefront theme to log UTMs and referrers:

1. In your Shopify Admin, go to Online Store → Themes.
2. Click the action dropdown (the three dots) and select Edit Code.
3. Open the layout/theme.liquid file.
4. Paste the tracking script directly before the closing </head> tag. Replace YOUR_SITE_KEY:

<!-- Paste inside layout/theme.liquid before </head> -->
<script async src="https://api.srctk.com/tracker.min.js" data-site-key="YOUR_SITE_KEY"></script>

Step 2: Capture Visitor ID in Shopify Cart

To link checkout purchases with marketing sessions, you must store the anonymous visitor ID (st_aid) as a cart attribute. Add this Javascript snippet to your checkout or cart templates:

// Read st_aid from localStorage and forward as a cart attribute
const visitorId = localStorage.getItem('st_aid');
if (visitorId) {
  fetch(window.Shopify.routes.root + 'cart/update.js', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      attributes: {
        'st_aid': visitorId
      }
    })
  });
}

Step 3: Connect Order Webhooks

Configure a webhook inside Shopify to forward order details to your SourceTrack endpoint on purchase confirmation:

1. In your Shopify Admin, go to Settings → Notifications.
2. Scroll to the Webhooks section and click Create Webhook.
3. Configure the webhook details:
   • Event: orders/paid (recommended) or orders/create. With orders/create, SourceTrack only processes orders where financial_status === 'paid' — unpaid carts and pending orders are ignored.
   • Format: JSON
   • URL: https://api.srctk.com/api/webhooks/shopify/YOUR_SITE_KEY
   • API Version: Latest / stable
4. Save the webhook, then copy the Shopify signing secret (shared with all webhooks for the shop) and paste it intoIntegrations → Shopify webhook recipe. SourceTrack rejects any webhook whose HMAC-SHA256 signature does not match.

Attribution stitching: the order webhook reads the visitor id fromnote_attributes using the first key it finds among_st_aid, st_aid,anonymous_id, visitor_id,sourcetrack_user_id, orsite_user_id. Step 2 setsst_aid; using one of those other keys also works.

Dedupe: Shopify webhooks are idempotent by Shopify webhook id and order id, so a redelivered webhook will record as duplicate, not a second conversion.

Step 4: Sandboxed Checkout Funnel Pixel

Because Shopify hosts checkout inside an isolated sandbox, standard theme scripts cannot execute there. Add a Custom Pixel in Shopify Admin to capture checkout_started funnel events:

1. In your Shopify Admin, go to Settings → Customer events.
2. Click Add custom pixel, name it SourceTrack Checkout, and click Add pixel.
3. Paste the code snippet below into the code editor:

// In Shopify Admin > Settings > Customer events > Add custom pixel
analytics.subscribe('checkout_started', (event) => {
  const checkout = event.data?.checkout;
  fetch('https://api.srctk.com/api/track', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    keepalive: true,
    body: JSON.stringify({
      site_key: 'YOUR_SITE_KEY',
      event: 'checkout_started',
      properties: {
        shopify_source: 'web_pixels',
        currency: checkout?.currencyCode,
        checkout_total: checkout?.totalPrice?.amount ? Number(checkout.totalPrice.amount) : undefined,
        item_count: Array.isArray(checkout?.lineItems) ? checkout.lineItems.length : undefined
      }
    })
  });
});