Automatically Generated — These events are created by Upstack backend services for Shopify customers. You do not need to fire these events manually.
Overview
Upstack automatically generates AOV (Average Order Value) segmented purchase events based on your store’s order value distribution. These events help you optimize campaigns for high-value customers and understand the revenue impact of different customer segments.Event Types
How It Works
When a purchase occurs, Upstack calculates AOV thresholds based on your store’s historical order data:- Order received — Shopify sends a purchase webhook to Upstack
- Threshold calculation — Upstack computes percentile thresholds from your order history
- Classification — The order value is compared against these thresholds
- Event generation — The appropriate AOV event(s) are generated
- Forwarding — Events are sent to your configured destinations
Threshold Definitions
Thresholds are calculated dynamically based on your store’s recent order history. As your average order value changes, the classification adjusts automatically.
Properties
These events include all properties from the originalpurchase event:
Destination Mapping
AOV events are forwarded to destinations as:Use Cases
Optimize for High-Value Customers
Usehigh_aov_purchase or p90_aov_purchase events to train ad algorithms to find customers who spend more:
- Configure Meta CAPI to optimize for
high_aov_purchaseinstead of all purchases - Build lookalike audiences from high-AOV customers
- Set higher bids for campaigns driving premium purchases
Identify Discount-Driven Traffic
Uselow_aov_purchase events to understand which channels drive bargain shoppers:
- Compare high vs. low AOV by traffic source
- Identify campaigns that attract discount-seekers
- Adjust targeting to improve order values
Revenue-Weighted Attribution
Use percentile events for more accurate revenue attribution:p90_aov_purchase— Focus on your most valuable 10% of ordersp80_aov_purchase— Track premium customer acquisitionp70_aov_purchase— Identify above-average performers
Event Overlap
A single purchase may generate multiple AOV events. For example, a purchase in the 95th percentile generates:high_aov_purchase(above average)p70_aov_purchase(above 70th percentile)p80_aov_purchase(above 80th percentile)p90_aov_purchase(above 90th percentile)
Related Events
- purchase — The base purchase event
- nc_purchase — New customer purchases
- rc_purchase — Returning customer purchases
- all_purchase — All purchases