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.

​
How to Troubleshoot Your Upstack Data Pixels

Sometimes your Upstack Data pixel might not be firing correctly, sending inaccurate event counts, or tracking the wrong values. This guide walks you through our diagnostic process so you can identify and fix the most common pixel issues.

​
Quick Diagnosis Checklist

Before diving into detailed troubleshooting, check these key areas:
  • Pixel Helper status — Are events firing in real-time?
  • Meta Events Manager — Do event counts match what you see in Upstack?
  • Script attributes — Is the pixel using async (correct) or defer (wrong)?
  • Third-party tracking — Are other tools creating duplicate events?
  • Domain configuration — Is your pixel correctly set up for subdomains or aliases?

​
Step 1: Use Pixel Helper to View Real-Time Events

What is Pixel Helper? This is Meta’s official browser extension that shows all Meta pixels firing on your site in real-time.
To get started:
  1. Install the Pixel Helper browser extension from Meta
  2. Navigate to your Shopify store or landing page
  3. Open Pixel Helper (click the icon in your browser toolbar)
  4. Perform an action (page view, add to cart, purchase) on your site
  5. Check if the event appears in Pixel Helper with the correct event name, value, and Click ID
What to look for:
  • Events appearing twice = potential duplicate tracking
  • Events appearing once = normal
  • Events not appearing = script loading issue
  • Events with value: $0 = bundle or discount configuration issue
  • Events with missing Click ID = domain or redirect issue

​
Step 2: Compare Pixel Helper to Meta Events Manager

The official source of truth for pixel data is Meta’s Events Manager. To verify in Events Manager:
  1. Go to your Meta Business Suite
  2. Navigate to Events Manager
  3. Select your pixel
  4. Click the Test Events tab
  5. Keep this tab open in one window
  6. In another window, visit your Shopify store while logged into Meta Business Suite
  7. Perform test actions (page view, add to cart, etc.)
  8. Watch Events Manager for incoming events in real-time
What to compare:
  • Event counts: Pixel Helper and Events Manager should show similar counts (within 5-10%)
  • Event timing: Do events appear within seconds of the user action?
  • Event values: Do they match what Pixel Helper shows?
If they don’t match: Your pixel is likely firing, but something is preventing Meta from receiving the full data. This often indicates a consent/privacy setting issue or a redirect problem.

​
Step 3: Check Your Script Tag Configuration

The way your pixel script loads affects which events are captured. There’s a critical difference between async and defer. To find your pixel script:
  1. On your Shopify store, right-click anywhere → Inspect (or press F12)
  2. Go to the Head section (press Ctrl+F / Cmd+F and search for “fbq”)
  3. Find your Meta pixel script tag
✓ CORRECT: <script async src="https://connect.facebook.net/..."></script>
✗ WRONG: <script defer src="https://connect.facebook.net/..."></script>
Why this matters: If your pixel uses defer instead of async, it won’t load until after the page is fully rendered. If users bounce within the first 2-3 seconds, the pixel never fires, causing major under-counting. How to fix: Contact Upstack support with a screenshot of your script tag. We can update your pixel configuration to use async loading.

​
Step 4: Check for Competing Tracking Tools

If you’re seeing double the events (e.g., Upstack shows 10,000 page views but Facebook shows 20,000), you likely have duplicate pixel tracking. Common culprits:
  • Google Tag Manager (GTM) firing the same pixel
  • Stape (a data layer tool) sending duplicate events
  • Triple Whale Sonar tracking the same conversions
  • Multiple Upstack Data pixels installed
  • Replo or custom page tracking firing the same events
To fix: Disable the duplicate tracking source. Usually, you’ll want to keep Upstack Data as your primary tracking method and remove others.

​
Step 5: Audit Third-Party App Configurations

If you’re using apps like Replo (custom pages), Kaching (one-click upsells), or other checkout builders, they may be sending their own conversion data that conflicts with Upstack. Apps to check:
  • Replo — Verify the pixel script is set to async loading, not defer
  • Kaching — Check if it’s tracking Add to Cart or Purchase separately
  • Bundle/discount apps — These often send inflated values because they show the full price before discount

​
Step 6: Fix Bundle and Discount Tracking Issues

The problem: When products are bundled with a discount, your store shows the full price first, then applies the discount at checkout. Your pixel may capture the full (inflated) price, causing Meta to optimize for the wrong bid. Example: A 150bundleshowsas150 bundle shows as 150 in inventory, but costs 80atcheckout.Yourpixelfireswithvalue:80 at checkout. Your pixel fires with value: 150, Facebook optimizes for high AOV, bid errors occur. How to fix:
  1. Find your bundle or discount app settings
  2. Configure it to send zero-dollar values for discounted bundle items
  3. Or, ensure your pixel only fires with post-discount prices

​
Step 7: Check for Redirect Loops and Domain Issues

If your Click ID is being lost, or if events aren’t firing on subdomains, you likely have a domain configuration issue. Common problems:
  • Subdomains — If you have www.example.com and example.com, the pixel may not recognize both
  • Alias domains — Secondary domains may need server-side pixel setup
  • Redirects — A redirect loop can break Click ID preservation
How to fix:
  1. Consolidate to one primary domain if possible
  2. For subdomains, ensure the pixel is hard-coded on all domains
  3. For redirects, remove redirect loops in your domain configuration
  4. Contact Upstack support — we can configure server-side pixel tracking if needed

​
When to Escalate to Upstack Support

If you’ve worked through the above steps and still have issues, gather this information and contact us:
  1. Screenshot of Pixel Helper showing the event (or lack thereof)
  2. Screenshot of your script tag (from browser Inspector)
  3. List of third-party apps you have installed
  4. Comparison of Upstack vs. Facebook event counts for the last 24-48 hours
  5. Your Shopify store domain(s)
  6. Exact event counts — What do you expect vs. what are you seeing?
Need help? Contact us at Upstack Data Support

Install on Shopify

Install the Upstack Data tracking pixel on your Shopify store and start capturing events.

Verify events

Confirm that your Shopify store is sending tracking events to the Upstack pipeline.

Install Pixel Helper

Install the Upstack Pixel Helper browser extension to debug pixel events in real time.

​
Summary: The Diagnostic Path

  1. Open Pixel Helper — Events firing? → Go to Step 2
  2. No events? → Check script tag (Step 3), verify app installation, ensure consent is enabled
  3. Double events? → Check for competing trackers (Step 4) or third-party apps (Step 5)
  4. Wrong values? → Check bundle/discount config (Step 6)
  5. Missing Click ID? → Check domain setup (Step 7)
  6. Still stuck? → Escalate with screenshots and details