Skip to main content
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:
  1. Order received — Shopify sends a purchase webhook to Upstack
  2. Threshold calculation — Upstack computes percentile thresholds from your order history
  3. Classification — The order value is compared against these thresholds
  4. Event generation — The appropriate AOV event(s) are generated
  5. 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 original purchase event:

Destination Mapping

AOV events are forwarded to destinations as:

Use Cases

Optimize for High-Value Customers

Use high_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_purchase instead of all purchases
  • Build lookalike audiences from high-AOV customers
  • Set higher bids for campaigns driving premium purchases

Identify Discount-Driven Traffic

Use low_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 orders
  • p80_aov_purchase — Track premium customer acquisition
  • p70_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)
Choose the threshold that best matches your optimization goals.