Automatically Generated — This event is created by Upstack backend services for Shopify customers. You do not need to fire this event manually.
Overview
Theupsell_purchase event is generated when Upstack detects a purchase that resulted from an upsell opportunity. This event helps you measure the effectiveness of upsell campaigns, post-purchase offers, and cross-sell strategies.
How It Works
Upstack analyzes purchase patterns to identify upsell conversions:- Order received — Shopify sends a purchase webhook to Upstack
- Upsell detection — Upstack checks for upsell indicators (multiple items, upgraded variants, post-purchase additions)
- Event generation — If upsell criteria are met, an
upsell_purchaseevent is generated - Forwarding — The event is sent to your configured destinations
Upsell Classification
A purchase is classified as an upsell when:- The order contains items added through post-purchase offers
- The customer upgraded to a higher-tier product variant
- The order includes cross-sell items from upsell campaigns
- The purchase occurred during a returning customer’s session with additional items beyond their typical basket
Properties
This event includes all properties from the originalpurchase event:
Destination Mapping
This event is forwarded to destinations as:Use Cases
- Measure upsell effectiveness — Track how often upsell offers convert and their revenue impact
- Optimize upsell timing — Identify which campaigns or touchpoints drive the most upsell conversions
- Calculate upsell ROI — Compare ad spend to upsell revenue for campaign optimization
- A/B test offers — Measure which upsell offers perform best by tracking conversion rates
Metrics Available
In the Upstack dashboard, you can view:Related Events
- purchase — The base purchase event
- rc_purchase — Returning customer purchases
- all_purchase — All purchases
- AOV Events — Purchase segmentation by order value