upsell_purchase Event - Upstack Data

Automatically Generated — This event is created by Upstack backend services for Shopify customers. You do not need to fire this event manually.

For the rules Upstack uses to detect an upsell and why it isn’t sent as a second Purchase, see How post-purchase upsells are tracked.

Overview

The upsell_purchase event is generated when a customer accepts a post-purchase offer that adds items to an order Upstack has already sent as a Purchase. It carries only the added amount, so the order isn’t counted twice.

How It Works

Purchase sent. At checkout, Upstack sends purchase with the order total at that moment.
Order update received. The accepted offer is added to the same Shopify order, and Shopify sends Upstack an order update.
Upsell check. Upstack treats the update as an upsell only when the order has the tag AfterSell Upsell, was created in the last 2 hours, has a payment status of paid or pending, and has a new total higher than the Purchase value already sent.
Event generation. Upstack generates one upsell_purchase for the order and sends it to your configured destinations.

Orders without the AfterSell Upsell tag never generate this event. Upstack sends at most one upsell_purchase per order.

Properties

This event copies the original purchase event, with two changes:

Property	Type	Description
orderId	string	Shopify order ID
value	number	New order total minus the original Purchase value
currency	string	ISO 4217 currency code (e.g., `USD`)
items	array	Only the line items that weren’t in the original Purchase
email	string	Customer email (hashed for destinations)
phone	string	Customer phone (hashed for destinations)

Destination Mapping

Destination	Event name	Sent by default
Meta	`upsellPurchase` (custom event)	Yes
TikTok	`UpsellPurchase`	Yes
GA4	`upsell_purchase`	Yes, if you have an existing GA4 destination
Microsoft Ads	`upsell_purchase` (custom event)	Yes
Google Ads	The conversion action you map it to	No. Map it to a conversion action
Reddit, NewsBreak	Built-in mapping	No. Turn it on with a destination event mapping
Klaviyo, Pinterest	Your choice	No. Add a destination event mapping
Snapchat, LinkedIn, AppLovin	Not sent	No

Meta needs each custom event approved before you can optimize on it. See How to approve Meta custom events.

Metrics Available

In the Upstack dashboard, you can view:

Metric	Description
Upsell Purchases	Total number of upsell purchase events
Cost per Upsell Purchase	Average ad spend per upsell conversion
Upsell Purchase Value	Total revenue from upsell purchases

purchase — The base purchase event
rc_purchase — Returning customer purchases
all_purchase — All purchases
AOV Events — Purchase segmentation by order value

​Overview

​How It Works

​Properties

​Destination Mapping

​Metrics Available

​Related Events

Overview

How It Works

Properties

Destination Mapping

Metrics Available

Related Events