> ## Documentation Index > Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Implementing Upstack Data on Landing Pages, Subdomains, and Third-Party Sites > Install the Upstack Data Pixel on landing pages, subdomains, headless storefronts, and third-party platforms — track events and attribute conversions beyond your Shopify store. When your marketing funnel extends beyond your Shopify storefront — landing pages, subdomains, headless commerce frontends, WordPress sites, or third-party quiz/survey platforms — you need to install the Upstack Pixel manually to capture events and maintain attribution continuity. This guide covers two implementation methods: * **Direct installation** — Add the pixel script directly to your page's HTML * **Google Tag Manager (GTM)** — Deploy via your GTM container for centralized tag management For the full event payload reference — including all required and optional properties — see [Standard Events Reference](/pixel/standard-events) and [Properties & Context](/pixel/properties). *** ## When You Need This Guide Install the Upstack Pixel manually when you have: * **Landing pages** — Unbounce, Instapage, Webflow, Carrd, or custom HTML pages * **Subdomains** — `shop.yourdomain.com` or `promo.yourdomain.com` running outside Shopify * **Headless storefronts** — Custom React, Next.js, or Vue frontends using Shopify's Storefront API * **WordPress / WooCommerce** — Sites that redirect to Shopify checkout * **Quiz or survey tools** — Octane AI, Typeform, or Jotform funnels * **Third-party checkout platforms** — Checkout Champ, ClickFunnels, or custom checkout flows *** ## Prerequisites * An [Upstack Data](https://app.upstackdata.com) account with the Upstack Data app installed on your Shopify store * Your Upstack Pixel ID (UUID format: `XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`, e.g., `58284d43-85f6-41fb-b2e0-f32f8ecb4e9b`). See [How to find my Upstack Data Pixel ID](/resources/how-to-find-my-upstack-data-pixel-id) * Edit access to the site or landing page (admin access in your page builder, CMS, or GTM container) *** ## Step 1: Find Your Upstack Pixel ID Your **Upstack Pixel ID** is a unique identifier linked to your Shopify store. This ID connects browser events from external sites to your Upstack account. For step-by-step instructions, see: [How to find my Upstack Data Pixel ID?](/resources/how-to-find-my-upstack-data-pixel-id) *** ## Step 2: Choose Your Implementation Method Add the pixel script directly to your page's `` section. This is the simplest approach for landing pages and sites without a tag manager. ### Base Pixel Snippet (Required on Every Page) ```html theme={null} ``` **Replace `YOUR_PIXEL_ID`** with the Pixel ID you obtained in Step 1 (UUID format: `XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`). Deploy the pixel via GTM for centralized tag management and conditional triggering. 1. Sign in to [Google Tag Manager](https://tagmanager.google.com) and open your container 2. Navigate to **Tags → New** 3. Select **Custom HTML** as the tag type 4. Paste the pixel snippet into the HTML editor 5. Set the trigger to **All Pages** (or specific page conditions) ### GTM Custom HTML Tag ```html theme={null} ``` For e-commerce events, you can use GTM Data Layer variables to dynamically populate event properties. See Step 3 for event snippets. *** ## Step 3: Track Events Beyond page views, you'll want to track key conversion events. Each event follows the same pattern: ```javascript theme={null} window._upstack('track', 'event_name', { /* event properties */ }); ``` For the complete list of standard events and their required properties, see the [Standard Events Reference](/pixel/standard-events). ### Event Snippets Reference Fires when a visitor views a product or content page. ```html theme={null} ``` **Required properties:** `value`, `currency`, `items` See [ViewContent in Standard Events](/pixel/standard-events) for the full specification. Fires when a visitor adds an item to their cart. ```html theme={null} ``` **Required properties:** `value`, `currency`, `items` See [AddToCart in Standard Events](/pixel/standard-events) for the full specification. Fires when a visitor starts the checkout flow. ```html theme={null} ``` **Required properties:** `value`, `currency`, `items` **Recommended:** Include identity fields (`email`, `phone`, `firstName`, `lastName`) to improve destination match quality. See [InitiateCheckout in Standard Events](/pixel/standard-events) for the full specification. Fires when an order is completed. This is the most important conversion event. ```html theme={null} ``` **Required properties:** `transactionId` or `orderId`, `value`, `currency`, `items` **Recommended:** Include all identity fields for maximum match quality at destinations. See [Purchase in Standard Events](/pixel/standard-events) for the full specification. Fires when a visitor submits a lead form, quiz, or survey. ```html theme={null} ``` **Required properties:** At least one identity field (`email` or `phone`) See [Lead in Standard Events](/pixel/standard-events) for the full specification. Fires when a visitor subscribes to email or SMS marketing. ```html theme={null} ``` See [Subscribe in Standard Events](/pixel/standard-events) for the full specification. *** ## Step 4: Preserve UTM Parameters Across Pages If your landing page links to your Shopify store or checkout, preserve UTM parameters and click IDs to maintain attribution continuity. Add this script to automatically append the current page's query string to all outbound links: ```html theme={null} ``` This ensures `fbclid`, `gclid`, `ttclid`, and UTM parameters flow through to Shopify checkout. *** ## Step 5: Verify Your Installation 1. **Visit your site** and trigger each event you configured (page view, lead capture, purchase, etc.) 2. **Use the Pixel Helper** — Install the [Upstack Data Pixel Helper](/guides/shopify/how-to-install-upstack-data-pixel-helper) browser extension to confirm events fire with the expected parameters 3. **Check Event Health** — In the [Upstack dashboard](https://app.upstackdata.com) under **Event Health**, confirm events arrive with your Pixel ID and correct properties If using GTM, use **Preview / Debug** mode to verify tags fire on the correct triggers before publishing. *** ## Platform-Specific Guides Quick setup for Unbounce, Instapage, Webflow, and custom landing pages. Full integration guide for Checkout Champ implementations. *** ## Reference Documentation Overview of the Upstack event model and how events flow through the pipeline. Complete specification for every standard event — required properties, optional fields, and example payloads. Full reference for user data, custom data, and context fields attached to events. Define your own events for interactions beyond the standard taxonomy. *** **Health and Wellness stores:** If you're in the health/wellness category and need to use custom event names for platform compliance, see [Health and Wellness Custom Event Mappings →](/guides/facebook-ads/health-and-wellness-custom-event-mappings)