What you’ll verify
- Page View events are firing and matching your actual site traffic
- Add to Cart events are firing once per user action (no duplicates)
- Purchase events are firing with correct values (post-discount)
- Click ID is preserved for accurate campaign attribution
- No duplicate tracking from competing tools
- Real-time event flow from your store to Meta’s system
Tool 1: Pixel Helper (real-time event checking)
Pixel Helper is Meta’s official browser extension that shows all Meta pixel events firing on your site in real time.Install Pixel Helper
- Open your browser and visit Meta Pixel Helper.
- Click Add to Chrome (or your browser).
- Confirm the installation.
- You’ll see a new icon in your browser toolbar — click it to open Pixel Helper.
Use Pixel Helper to check events
- Open Pixel Helper (click the icon in your toolbar).
- Navigate to your Shopify store (e.g., mystore.com).
- Watch for events in real time as you act:
- Page loads → PageView event should appear
- Click a product → ViewContent event should appear
- Add to cart → AddToCart event should appear
- Complete purchase → Purchase event should appear
What good Pixel Helper output looks like
Each event in Pixel Helper shows:- Event name (PageView, ViewContent, AddToCart, Purchase)
- Event time (when it fired)
- Event value (the monetary value if applicable)
- Click ID (Meta’s attribution ID)
- User ID (if available)
- Additional properties (product name, quantity, etc.)
Red flags in Pixel Helper
- Duplicate events appearing — the same event fires twice at the exact same time; you have duplicate tracking. See Step 4.
- Missing events — you perform an action and no event appears; your pixel isn’t firing. See troubleshooting: pixel not firing.
- Value: $0 — your bundle/discount logic may be configured incorrectly. See Step 5.
- No Click ID — you may have a domain configuration issue. See Step 7.
Tool 2: Meta Events Manager (official source of truth)
While Pixel Helper shows you what’s firing on your site, Meta Events Manager is where the data is actually recorded.Access Meta Events Manager
- Go to Meta Business Suite.
- In the left sidebar, go to Events Manager.
- Select your Pixel (usually named “Upstack Data” or your store name).
- Click on the Test Events tab.
Set up real-time event testing
The Test Events feature lets you see events arriving at Meta in real time (with a 5–15 second delay). The test event code tells Meta to log these events separately, so they don’t affect your ad optimization or reporting.- Keep Events Manager open in one browser tab.
- Open another tab and log into your Meta Business Suite (so Meta recognizes you).
- In a third tab, visit your Shopify store.
- Perform actions on your store (page view, add to cart, purchase).
- Watch Events Manager — events should arrive within 5–15 seconds.
What good Events Manager data looks like
Status = Complete means Meta successfully received and processed the event.
Compare Pixel Helper to Events Manager
If counts differ significantly (e.g., Pixel Helper shows 10 events but Events Manager shows 5), something is blocking data flow to Meta. See Step 8.
Step-by-step verification process
Step 1: Confirm basic event firing
Objective: Make sure your pixel is firing at all.- Open Pixel Helper and visit your Shopify home page.
- Wait 2–3 seconds for the page to fully load.
- Check Pixel Helper — you should see a PageView event.
- If you see it: ✓ Good! Your pixel is firing. Continue to Step 2.
- If you don’t: see troubleshooting: pixel not firing.
Step 2: Test Page View accuracy
Page views should match your actual site traffic within 5–10%.- In Pixel Helper, note the total PageView count.
- Visit multiple pages on your store (home, product, collection, about).
- Each page load should fire a PageView event.
- Count total PageViews and note the number.
defer instead of async, or your consent settings are blocking events. See troubleshooting: low page views.
Step 3: Test Add to Cart events
Add to Cart events should fire once per user action (no duplicates).- Open Pixel Helper and clear previous events (refresh the page).
- Add a product to your cart.
- Look for an AddToCart event.
- Expected result: exactly 1 AddToCart event fires (not 2 or more), showing the product price (post-discount), currency, content IDs, and quantity.
Step 4: Check for competing tracking
If Pixel Helper shows duplicate events (the exact same event firing twice), you likely have two tracking tools active. Common culprits:- Google Tag Manager (GTM) also firing the Meta pixel
- Stape data layer sending duplicate events
- Triple Whale Sonar tracking the same conversions
- Multiple Upstack pixels installed by accident
- Third-party apps (Replo, Kaching) with their own tracking
- Check GTM: open your Shopify container in Google Tag Manager, search for “Meta” or “Facebook”, and disable any conflicting pixel tags.
- Check Stape: verify it’s not configured to send the same events.
- Check Triple Whale: in Triple Whale settings, check if Sonar is enabled and sending pixel events.
- Check for multiple Upstack pixels: in Shopify admin, go to Settings → Customer events and verify only one Upstack Data pixel is installed.
Step 5: Check bundle and discount values
Your pixel should fire with the final, post-discount price — not the original price. Example scenario: a product listed at 75 (not $150). To test this:- Find a discounted product or bundle on your store and note the original and discounted prices.
- Open Pixel Helper and add the item to cart.
- Check the AddToCart event value:
- ✓ Correct: shows $75 (post-discount)
- ✗ Wrong: shows $150 (pre-discount)
- Complete a purchase with the discount and check the Purchase event the same way.
Step 6: Verify Purchase events and conversion values
This is the most critical event — it directly impacts your ROAS and ad optimization.- Add a product to cart (note the final price you’ll pay) and complete checkout.
- In Pixel Helper, look for a Purchase event and verify:
- Event name: Purchase
- Value: exact amount you paid (e.g., $89.99)
- Currency: correct currency (USD, CAD, etc.)
- Content IDs: product IDs from your order
- Quantity: number of items purchased
Step 7: Check domain configuration and Click ID preservation
Click ID is Meta’s way of attributing purchases back to ad clicks. If Click ID is missing, your ROAS reporting will be inaccurate. To check Click ID in events:- Open Pixel Helper and click on any event (PageView, AddToCart, or Purchase).
- Look for a field labeled Click ID or fbclid.
- If present: ✓ Good, Click ID is being preserved.
- If missing: ✗ You have a domain or redirect issue.
To fix domain issues:
- Go to Shopify Settings → Domains and note your primary domain.
- Verify your store URL matches the domain in your browser.
- If you have multiple domains (e.g.,
mystore.comANDwww.mystore.com), consolidate to one or configure server-side tracking. - If you use custom pages (Replo), ensure the
fbclidparameter is preserved in redirects.
- Visit your store with a Meta ad parameter: add
?fbclid=ABC123to your URL. - Proceed through checkout (allowing redirects to happen).
- In Pixel Helper, check the Purchase event for Click ID.
- If present: ✓ Good, redirects preserve Click ID.
- If missing: ✗ You need to configure server-side tracking — contact Upstack support.
Step 8: Compare event counts (Pixel Helper vs. Events Manager)
Event counts should be approximately the same across both tools.- Note Pixel Helper totals for the last 24 hours (PageView, AddToCart, Purchase counts).
- In Meta Events Manager, select your pixel and go to Diagnostics or Event Source Quality.
- Look at the event counts for the same 24-hour period and compare:
If counts differ significantly:
- More in Pixel Helper than Events Manager: events fire on your site but don’t reach Meta (consent/privacy issue).
- More in Events Manager than Pixel Helper: another source may be sending data (check for duplicate tracking).
- Fewer Purchase events: some checkout sessions may be incomplete or blocked.
Troubleshooting common issues
Troubleshooting: pixel not firing
Problem: Pixel Helper is open but no events appear. Check in order:- Is Pixel Helper showing the correct store? Make sure you’re visiting your actual Shopify store and check the URL in your address bar.
- Is your Theme App Extension enabled? Go to Shopify admin → Settings → Customer events and confirm Upstack Data is listed and active. If not, follow the complete Shopify setup guide to enable it.
- Is your theme compatible? Some older custom themes don’t support Theme App Extensions — try installing a Custom Pixel instead (see the setup guide).
- Is JavaScript enabled in your browser? Privacy extensions (Privacy Badger, uBlock, etc.) block scripts — disable them temporarily or test in a private/incognito window.
- Did you just install the app? It can take 5–15 minutes for the pixel to fully activate — wait a few minutes and refresh.
Troubleshooting: low page view counts
Problem: Page views fire but are significantly lower than expected. Likely cause: your pixel script is set todefer instead of async. If users bounce within 2–3 seconds (before the page fully loads), the pixel never fires — this causes massive under-counting.
To check: inspect your store page, search for fbq, and verify the script tag uses async:
async loading.
Troubleshooting: duplicate events firing
Problem: Pixel Helper shows the same event twice (e.g., two AddToCart events at 2:46:12 PM). Likely cause: competing pixel tracking from GTM, Stape, Triple Whale, or multiple Upstack pixels. To fix:- In Google Tag Manager, open your Shopify container, search for “Meta”, “Facebook”, or “Pixel”, and disable or remove any conflicting tags.
- If you use Stape or Triple Whale, verify they’re not configured to send the same events.
- In Shopify admin → Settings → Customer events, confirm only ONE Upstack Data pixel is installed — remove any duplicate.
- Verify the fix: refresh your store in Pixel Helper, perform actions, and confirm only ONE event per action.
Troubleshooting: incorrect conversion values
Problem: the Purchase event shows the wrong value (e.g., 75 after discount). Likely cause: your bundle or discount app is not configured correctly.- Identify your bundle/discount app (Kaching, Bold, Recharge, etc.) and open its settings in Shopify admin.
- Find the Tracking or Pixel configuration section and look for options to:
- Send zero-dollar values for bundled items
- Wait until the discount is applied before firing events
- Use post-checkout prices only
- Alternatively, configure the app to send the post-discount price to the pixel.
- Test: make a discounted test purchase and verify the Purchase event shows the correct value in Pixel Helper.
Troubleshooting: missing Click ID
Problem: events fire, but Click ID is missing. Likely cause: domain configuration issue or redirect loop.- Go to Shopify admin → Settings → Domains and note your primary domain; verify your store URL matches it.
- Consolidate multiple domains — if you have
mystore.comandwww.mystore.com, set up a redirect to use only one. - For custom pages (Replo): verify the
fbclidparameter is passed in redirects and check Replo’s Redirect Configuration. - Test: visit your store with
?fbclid=ABC123, proceed to checkout, and check Pixel Helper for Click ID in the Purchase event.
When to contact Upstack support
Reach out if:- Pixel Helper shows no events firing (after checking all steps above)
- Events fire but don’t reach Meta Events Manager
- Your script tag shows
deferinstead ofasync - You have bundle/discount value issues and need configuration help
- You need server-side pixel setup for domain/redirect issues
- Custom page tracking (Replo, etc.) isn’t working
- You’re seeing duplicate events and can’t find the source
- Screenshot of Pixel Helper (showing events or lack thereof)
- Screenshot of your script tag (from browser Inspector, showing
asyncordefer) - Screenshot of Shopify theme settings (showing Theme App Extension status)
- List of third-party apps installed (GTM, Stape, etc.)
- Expected vs. actual event counts (last 24–48 hours)
- Your Shopify store domain
- Any error messages you’ve seen
Still stuck? Contact support@upstackdata.com with your Pixel ID and a description of the issue. We typically respond within a few hours.
Quick verification checklist
- Pixel Helper installed and active
- PageView events firing (1 per page load)
- AddToCart events firing (1 per add action, no duplicates)
- Purchase events firing with correct value (post-discount)
- Click ID present in all events
- No duplicate events from competing tools
- Event counts match between Pixel Helper and Events Manager (within 5–10%)
- Meta Events Manager shows events arriving in real time
- Conversion values are accurate in Meta
- Custom pages have pixel hard-coded (if applicable)
Related guides
Troubleshoot pixel issues
The diagnostic companion to this guide.
Complete Shopify setup guide
Install and configure Upstack Data end to end.
Verify events (Upstack pipeline)
Confirm events are arriving in the Upstack dashboard.