Skip to main content

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.


Quick Summary

  • Copy your Pixel ID from the Upstack dashboard.
  • Insert the Pixel ID into the script below.
  • Place the script inside the <head> section of your webpage.
  • Publish or update your landing page.
  • Verify your installation.

Prerequisites

  • An Upstack Data 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.
  • Edit access to the landing page or subdomain (admin access in the page builder, CMS, or static host).
  • Ability to add code to the <head> section (Custom Code / Header Code area in your tool).

Configuration Steps

Step 1: Find and copy your Upstack Pixel ID

Your Upstack Pixel ID is a unique identifier linked to your Shopify store. This ID is used to track browser events and associate them with your account. For step-by-step instructions on locating your Upstack Pixel ID, see: How to find my Upstack Data Pixel ID?

Step 2: Insert your Pixel ID into the script

  • Open the Upstack Pixel script provided below.
  • Replace the placeholder Pixel ID with your own ID.

Upstack Pixel Snippet

<!-- Start UpstackData Pixel --><script src='https://prod2-cdn.upstackified.com/scripts/px/ups.min.js' async='true'></script><script>  window._adqLoaded =0;  window._upsqueue = window._upsqueue || [];  window._upstack = window._upstack || function () {    window._upsqueue.push(arguments);  }  window._upstack('init', 'XXXX-XXXX-XXXXX-XXXX'); // replace with pixelID  window._upstack('page');</script><!-- End UpstackData Pixel --><!-- Start script to add current query string to all links --><script>  // Function to add current page's query string to all linksfunction addCurrentQueryStringToLinks() {    // Get the current page's query string    var currentQueryString = window.location.search.slice(1);    // If there's no query string, exit the function    if (!currentQueryString) return;    // Get all 'a' elements in the document    var links = document.getElementsByTagName('a');    // Loop through each link    for (var i = 0; i < links.length; i++) {        var link = links[i];        var href = link.href;        // Skip links that are just anchors        if (href.startsWith('#')) continue;        // Check if the link already has query parameters        if (href.indexOf('?') !== -1) {            // If it does, append the current query string with an '&'            href += '&' + currentQueryString;        } else {            // If it doesn't, append the current query string with a '?'            href += '?' + currentQueryString;        }        // Set the modified href back to the link        link.href = href;    }}// Call this function when the page loadswindow.addEventListener('load', addCurrentQueryStringToLinks);</script><!-- End script to add current query string to all links -->
Important:
  • Replace XXXX-XXXX-XXXXX-XXXX with the Pixel ID you obtained in Step 1 (UUID format: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX).
  • Enter the Pixel ID exactly as provided — extra whitespace or quotation mismatches will break tracking.

Step 3: Add the script to your landing page

  • Open the landing page editor or HTML settings of your third-party tool.
  • Locate the Custom Code or Header Code section.
  • Paste the complete script into the <head> section of the page.

Step 4: Publish or update your landing page

  • Save and republish the page so the script goes live.

Step 5: Verify the installation

  • Visit your landing page in a browser.
  • Use the Upstack Data Pixel Helper to confirm the pixel is firing correctly with your Pixel ID.
  • In the Upstack dashboard under Event Health, confirm PageView events from the new landing page arrive within a few minutes.

Need help?If you encounter any issues during setup, contact our support team and we’ll help diagnose the problem.