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.

Before connecting a destination like Meta CAPI, take a minute to verify that your events are arriving correctly. This saves you from debugging destination issues that are actually source issues.

​
What You’ll Accomplish

Confirm that storefront actions generate events in the Upstack dashboard with the expected event types, URLs, and customer data.

​
Prerequisites

Prerequisites:
  • An active Shopify store
  • The Upstack Data app installed from the Shopify App Store
  • Your Pixel ID (found in the Upstack dashboard under Settings → Pixel)
You should have already completed Step 1: Install the Upstack Pixel.

​
Verification Steps

1

Open the Live Event Stream

In the Upstack dashboard, navigate to Events → Live Event Stream. This view shows events arriving from your store in real time, with the most recent events at the top.Leave this tab open — you’ll use it to confirm events as you trigger them.
2

Trigger a test pageview

Open your Shopify storefront in a new browser tab (or incognito window for a clean session). Visit your store’s homepage.Switch back to the Live Event Stream. Within a few seconds, you should see a PageView event appear with the URL of your homepage.
3

Trigger additional event types

Continue browsing your store to generate a range of events:
ActionExpected Event
View a product pageViewContent
Add a product to cartAddToCart
Begin checkoutInitiateCheckout
Verify each event appears in the stream with the correct event type and a populated URL.
4

Inspect an event payload

Click on any event in the Live Event Stream to expand its details. Confirm the payload includes:
  • Pixel ID — matches the Pixel ID shown in Settings → Pixel
  • Event type — correct for the action you took
  • Page URL — matches the page you visited
  • Timestamp — recent and in the correct timezone
  • User data — if you’re logged in as a customer, look for email or customer ID fields

​
You’ll Know It’s Working When…

You should see at least three different event types (PageView, ViewContent, AddToCart) in the Live Event Stream, each with a valid payload containing your Pixel ID, a page URL, and a recent timestamp. If events appear within seconds of your storefront actions, your pipeline is healthy.
Missing events? If you see PageView events but not AddToCart or ViewContent, your Shopify theme may be missing standard event hooks. Check Shopify Admin → Online Store → Themes → Customize → App Embeds and ensure Upstack Data is enabled. See Troubleshooting: Events Not in Dashboard for more.

​
Next Step

Step 3: Connect a Destination

Now that events are flowing into Upstack, connect Meta as your first destination and start sending high-quality server-side conversions to your ad account.

Use Pixel Helper

Learn how to use the Upstack Pixel Helper browser extension to inspect events firing on your storefront.

Install Pixel Helper

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

Events not in dashboard

Troubleshoot missing events in your Upstack dashboard — covers pixel installation, browser blockers, and theme conflicts.