Skip to main content
Every interaction a customer has with your website generates an event. Upstack Data captures these events server-side, enriches them with identity and product data, and forwards them to your configured destinations.
Upstack tracks 25 standard events. Shopify stores see events tracked automatically via the theme app extension. Custom implementations (headless, GTM, non-Shopify platforms) can fire the same events using the JavaScript SDK.

​
How Events Are Captured

The Upstack Pixel is a lightweight JavaScript snippet that runs on your website. When a visitor performs an action — viewing a page, adding a product to cart, completing a purchase — the pixel fires an event to the Upstack edge API.
Shopify stores: The pixel is injected automatically via the theme app extension. Custom implementations: Add the pixel snippet to your site’s <head> — see Pixel Setup.
From there, events flow through a four-stage pipeline:
  1. Capture — Upstack Pixel detects the interaction and sends a structured event payload to the Cloudflare edge API.
  2. Resolve — Upstack ID attaches identity data (email, phone, cookie, device) to the event, linking anonymous sessions to known customers.
  3. Enrich — Product catalog data, UTM parameters, and click IDs are merged into the event.
  4. Activate — The enriched event is forwarded to each configured destination (Meta CAPI, TikTok, Klaviyo, GA4, etc.) in the format each platform expects.

​
Standard Event Taxonomy

Standard events have well-defined names, properties, and semantics that all destinations understand. Using standard events ensures compatibility across your entire marketing stack.

​
Page & Browse Events

​
Cart Events

​
Checkout Events

​
Order Events

​
Conversion Events

​
Account Events

​
Quiz Events

Quiz events are custom events — fire them manually using the JavaScript SDK. See quiz_completed and quiz_question_answered for implementation details.
All standard events include automatic context fields — pageUrl, userAgent, ipAddress, eventTime, and identity signals — regardless of the event type. See Properties for the full reference.

​
How Destinations Receive Events

Each destination maps standard events to its own naming convention. For example, an Upstack purchase event becomes:
  • A Meta CAPI Purchase event with hashed em, ph, and fbclid match keys
  • A TikTok Events API CompletePayment event with ttclid attached
  • A Klaviyo Placed Order event with full product details
  • A GA4 purchase event with transaction_id and line items
You configure which events each destination receives in the Upstack dashboard. Upstack handles the schema transformation automatically.

​
What’s Next

Standard Events Reference

Full specification for every standard event — required properties, optional fields, and example payloads.

SaaS & B2B Events

Events for subscription businesses — trials, billing, expansion, and engagement.

Custom Events

Define your own events to capture interactions beyond the standard taxonomy.

Properties & Context

Complete reference for all user data, custom data, and context fields attached to events.

Identity & Stitching

How Upstack ID enriches events with resolved identity data.