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

Event NameWhen It FiresKey Properties
page_viewEvery page loadpageUrl, pageTitle, referrer
view_contentProduct page vieweditems, value, currency
view_categoryCollection or category page vieweditems, value, currency
view_item_listProduct list displayed (search results, recommendations)items, listId, listName
view_cartCart page vieweditems, value, currency
searchSite search performedsearchTerm, resultsCount, items

​
Cart Events

Event NameWhen It FiresKey Properties
add_to_cartItem added to cartitems, value, currency
product_removed_from_cartItem removed from cartitems, value, currency
add_to_wishlistItem added to wishlistitems, value, currency

​
Checkout Events

Event NameWhen It FiresKey Properties
initiate_checkoutCheckout flow starteditems, value, currency
add_shipping_infoShipping details entereditems, value, currency, shippingTier
select_shipping_methodShipping method selecteditems, value, currency, shippingTier
add_payment_infoPayment method entereditems, value, currency, paymentType

​
Order Events

Event NameWhen It FiresKey Properties
purchaseOrder completedorderId, items, value, currency, tax, shipping
refundOrder refunded (full or partial)orderId, items, value, currency

​
Conversion Events

Event NameWhen It FiresKey Properties
leadLead form submittedvalue, currency, leadType
subscribeEmail or SMS subscriptionvalue, currency
trial_startedFree trial initiatedvalue, currency, trialLength
contactContact form submittedvalue, currency
book_callCall or demo bookedvalue, currency
scheduleAppointment scheduledvalue, currency
submit_applicationApplication submittedvalue, currency

​
Account Events

Event NameWhen It FiresKey Properties
complete_registrationAccount created (post-verification)value, currency
sign_upSign-up form submittedvalue, currency
loginUser logged in—

​
Quiz Events

Event NameWhen It FiresKey Properties
quiz_completedQuiz or assessment finishedquiz_id, result_id, questions_answered
quiz_question_answeredIndividual quiz question answeredquiz_id, question_id, answer_id
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.