CustomersUpdated 2026-06-01
Customer analytics
Growth charts, segment distribution, and the VIP threshold calculation.
Customer analytics surface how your audience grows and which segments drive revenue.
Segments
Every customer is automatically assigned a segment based on their order history. Segments are computed from paid orders only (Succeeded and not Cancelled or Refunded):
| Field | Type | Description |
|---|---|---|
| New | segment | Customers with one or fewer paid orders. |
| Returning | segment | Customers with more than one paid order who don't meet the VIP threshold. |
| VIP | segment | Customers whose total spend is in the top 20% (p80) OR who have five or more paid orders. |
VIP threshold
The VIP spend threshold is auto-computed as the 80th percentile of customer spend. It recalculates as your customer base grows, so the VIP segment always represents your top spenders.
Growth chart
The Customer Growth chart is a stacked area chart showing new vs returning customers per month over the last six months. The segment distribution donut shows the current split across New, Returning, and VIP.
Customer analytics endpoints
GET
/customer/statsKPI cards: total, new this month, active rate, avg LTV.
SessionGET
/customer/analytics6-month growth chart + segment distribution with auto VIP threshold.
Session