Full-funnel attribution for Hydrogen storefronts

TrackBee preserves ad platform identifiers across your headless Shopify storefront, so Meta, Google, TikTok and Pinterest know which ads drive sales.

Start Free Trial Book a Demo

Built for Shopify Hydrogen compatible Developer-friendly

The problem

Headless storefronts break ad attribution

Hydrogen gives you full creative control, but Shopify's native tracking doesn't follow. Click IDs from Meta, Google, and TikTok get lost the moment a visitor lands on your custom storefront, and never reach checkout.

Click IDs (fbclid, gclid, ttclid) and UTM parameters are lost in the headless setup
Parameters don't persist across pages — each navigation resets the session context
No native tracking support — Hydrogen requires custom implementation for every ad platform

Parameter capture

TrackBee's integration script captures fbclid, gclid, ttclid and UTM parameters from the landing URL the moment a visitor arrives on your Hydrogen storefront.

Session persistence

Captured identifiers are stored and persisted across the entire browsing session, no matter how many pages the visitor navigates through in your custom storefront.

Automatic link decoration

Every link on your storefront — including dynamically added ones — is automatically decorated with the stored parameters, ensuring they reach Shopify checkout intact.

Click ID persistence

Lost on first navigation

Persisted full session

Ad attribution

Broken, sales unattributed

Full-funnel, all platforms

UTM parameters

Stripped by React router

Captured and forwarded

Link decoration

Manual, easy to miss

Automatic, all links

Developer effort

Custom code per platform

One script, all platforms

Hydrogen is a headless framework. Your storefront runs as a separate React app, not inside Shopify's standard theme engine. Shopify's built-in tracking scripts only fire within the native checkout and theme infrastructure — your custom Hydrogen pages need their own integration.

TrackBee provides a lightweight integration script that you add to your Hydrogen project. It requires small changes to two files: app/root.tsx and app/entry.server.tsx. You can use Hydrogen's Script component or direct injection. The script automatically captures and persists tracking parameters.

Yes. TrackBee's integration is fully compatible with Shopify Oxygen, the default hosting platform for Hydrogen storefronts. The script runs client-side and works regardless of your hosting environment — Oxygen, Vercel, Netlify or any other provider.

TrackBee captures and persists identifiers for all major ad platforms: Meta (fbclid), Google Ads (gclid), TikTok (ttclid), Pinterest (epik) and all UTM parameters. One integration covers every platform — no need to build separate solutions for each.

The full step-by-step integration guide is available in our help center at help.trackbee.ai. It covers both implementation options (Script component and direct injection), with code examples for app/root.tsx and app/entry.server.tsx.