The Tatheon pixel is what lets a session be matched to the order it produced. Without it Tatheon still reports revenue accurately, because that comes from Shopify, but it cannot tell you which visit earned that revenue. This guide is for whoever can edit the Shopify theme, usually a store owner or a developer. It covers what the pixel is, how to install it, and how to confirm it is working before you rely on attribution.
What this pixel is, and is not
This is a lightweight first party storefront script. It is not a Shopify Customer Events pixel, and it does not go in the Customer Events section of your Shopify admin.
The distinction matters. Customer Events pixels run in a sandbox that limits what they can read and when they run. The Tatheon pixel runs in your theme as first party code on your own domain, which is what lets a session identifier survive from the first landing page through the cart and into the completed order. That continuity is the whole point. Attribution breaks at the checkout boundary for most tools, and this is how Tatheon avoids it.
Being first party also means it is not blocked the way third party tracking increasingly is. It sets no third party cookies and it does not follow visitors across other sites.
Before you start
You need permission to edit the theme code in Shopify, under Online Store, then Themes, then Edit code. If your theme is managed by an agency, this is a small change for them and worth sending as a single instruction rather than a conversation.
Take a theme backup first. Duplicating the live theme takes a few seconds and means any mistake is a one click revert rather than an incident.
Install it
Open the source wizard and choose Shopify Pixel. The wizard gives you the snippet with your account details already filled in, so copy it from there rather than reconstructing it by hand.
In Shopify, open your live theme’s code editor and find theme.liquid. Paste
the snippet immediately before the closing </head> tag. It belongs in the
head rather than at the end of the body, because it needs to run before the
page content so that a visitor who lands and leaves quickly is still recorded.
Save. That is the whole installation. There is no separate checkout step, because the pixel reads the order through your existing Shopify connection rather than firing a second time at purchase.
Confirm it is working
Do not assume. Open your storefront in a private browsing window, visit two or three pages, and then check the pixel diagnostics in the wizard. A working install shows sessions arriving within a minute or two.
The stronger test is an order. Place a real order, or use a test order if you have Shopify’s test gateway enabled, then look at whether the order carries a session identifier once it lands. An order with a session attached means the identifier survived the checkout, which is the thing that was hard.
Give it a day before judging attribution coverage. Coverage climbs as returning visitors are seen again, so the figure on day one understates where it settles.
Common problems
A pixel installed in the wrong theme is the most common failure. Shopify stores often carry several themes and only one is live, so confirm you edited the one currently published.
Sessions arriving but no orders matching usually means the snippet is present on the storefront but the store is using a checkout that bypasses the theme. Check that the Shopify connection itself is healthy before investigating the pixel, because order matching depends on both.
If sessions stop after a theme update, the snippet was overwritten. Theme
updates replace theme.liquid, so reinstall the snippet and consider keeping
it in a separate included file that survives updates.
Next
With the pixel in place, the attribution and marketing mix sections become meaningful, because Tatheon can now compare what each platform claims against what the sessions actually did. Connect your advertising platforms next if you have not already.