Hydrogen Analytics & Tracking — Agent Skill

Build a complete tracking pipeline on Shopify Hydrogen: client dataLayer → GTM → browser pixels, AND server /api/track → GA4 MP / Meta CAPI / Google Ads, with shared event_id for cross-side deduplication. Covers consent mode v2, CSP strict-dynamic, Oxygen full-page cache compatibility, and the surprising gotchas that bite every implementation.

This skill encodes hard-won lessons from production tracking work on Hydrogen storefronts. The reference files contain detailed implementations; this top page is the map.

When to use this skill

You need this if you're:

• Implementing GA4 / Meta / Google Ads / TikTok tracking on Hydrogen and the default Hydrogen Analytics components aren't enough.
• Adding server-side tracking (Measurement Protocol, Conversions API) for resilience against ad-blockers and ITP.
• Debugging "event X is in GTM Preview but not in GA4 / Meta".
• Wiring up conversion deduplication between browser pixel and server CAPI.
• Setting up tracking on a Hydrogen storefront with Weaverse as the CMS layer.
• Investigating why Oxygen full-page cache is being disabled despite a correct Oxygen-Cache-Control header.