> ## Documentation Index > Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt > Use this file to discover all available pages before exploring further. # AOV by State, Bonanza > AOV by State for Bonanza stores. Tracked live in Vortex IQ Nerve Centre. How to read it, why it matters, and how to act on it. **Card class:** [Non-Hero](/nerve-centre/overview#card-classes-explained) • **Category:** [Marketplace](/nerve-centre/connectors#connectors-by-type) ## At a glance > **AOV by State** breaks your Bonanza average order value down by US state, shown as a bar chart. Because Bonanza is a US marketplace, this geography lens shows where your higher-value baskets come from and where buyers spend less per order. It sits in the geography layer and pairs with the sales and orders-by-state cards below so marketing can read demand and basket size together. | | | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **What it counts** | Average order value for Bonanza orders, grouped by the buyer's US state. | | **Sample type** | Backend API data from Bonanza, refreshed on the standard data refresh. | | **Why it matters** | Knowing which states drive higher baskets helps marketing target promotions, shipping offers, and inventory by region rather than treating all US buyers the same. | | **Reading the value** | Compare state bars against each other and against your overall AOV. Tall bars mark high-value regions; short bars flag where basket-building or shipping incentives could lift spend. | | **Currency** | currency | | **Time window** | `30D` | | **Alert trigger** | `-` | | **Sentiment key** | `bon_aov_by_state` | | **Roles** | owner, marketing | ## Calculation For each US state, Vortex IQ takes the Bonanza orders attributed to buyers in that state over the time window and divides total order value by the number of orders to give a per-state average. The result renders as a bar chart so high and low AOV regions stand out at a glance. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading. ## Worked example *A representative reading of **AOV by State** for a typical merchant on Bonanza.* On 14 Mar 26 a booth sees its overall AOV sit near $48, but the by-state chart shows California buyers averaging about $61 while Texas buyers sit closer to $39. The merchant reads this as room to lift Texas baskets, so marketing tests a free-shipping-over-$50 banner aimed at lower-AOV states. Over the next window the Texas bar climbs toward \$46 without denting California. Vortex Mind traces which listings drive the high-value California baskets, and Ask Viq lets marketing ask in plain English which states sit below the overall average. ## Sibling cards merchants should reference together | Card | Why merchants reach for it | | ---------------------------------------------------------------------------------------- | --------------------------------------- | | [`bon_aov`](/nerve-centre/kpi-cards/bonanza/average-order-value) | Sales sibling: Average Order Value. | | [`bon_orders_by_state`](/nerve-centre/kpi-cards/bonanza/orders-by-state) | Geography sibling: Orders by State. | | [`bon_total_revenue`](/nerve-centre/kpi-cards/bonanza/total-revenue) | Sales sibling: Total Revenue. | | [`bon_top_listings_by_revenue`](/nerve-centre/kpi-cards/bonanza/top-listings-by-revenue) | Sales sibling: Top Listings by Revenue. | | [`bon_order_count`](/nerve-centre/kpi-cards/bonanza/total-transactions) | Sales sibling: Orders. | ## Reconciling against Bonanza **Where to look in Bonanza's own dashboard:** Check your Bonanza selling area under orders, where each sale shows the buyer's shipping state, to spot-check the per-state grouping against your own records. **Why the Vortex IQ value may legitimately differ:** | Reason | Direction | What to do | | -------------------------------------------------------------------------------------------------------------------- | --------- | ------------------------ | | **Period boundary.** Vortex IQ uses a 30-day rolling window by default; Bonanza dashboards may use calendar periods. | Variable | Match the period range. | | **Time zone.** Bonanza uses account time zone; Vortex IQ aligns to merchant reporting time zone. | Marginal | Confirm time zone match. | | **Filter scope.** Profile-level filters (booth, channel, test orders) may narrow the Vortex IQ view. | Variable | Match filter settings. | **Cross-connector reconciliation:** complement with sibling cards in the same category for the full diagnostic picture. For divergence investigations, use Vortex Mind. ## Known limitations / merchant FAQs **Q: How often does AOV by State update?** The card refreshes on the standard data refresh (typically every 30-60 minutes for live integrations) across the 30-day window. Force a manual refresh from the dashboard for the latest per-state averages. **Q: Why does my Bonanza dashboard show a different number?** The most common reasons are period-boundary differences (Vortex IQ uses a 30-day rolling window vs Bonanza's calendar periods), time-zone alignment, and filter scope. State assignment also depends on the shipping address on each order, so a handful of edge cases can shift a small state's average. **Q: Why do small states swing so much between refreshes?** States with few orders have a thin sample, so a single high or low basket moves the average sharply. Read low-volume state bars as directional and lean on the higher-volume states for stable trends. **Q: Can I customise the alert threshold?** Yes, sensitivity thresholds are configurable per profile in the Sensitivity tab. Adjust to match your business baseline rather than relying on the generic default. *** ### Tracked live in Vortex IQ Nerve Centre *AOV by State* is one of hundreds of KPI pulses Vortex IQ tracks across Bonanza and 70+ other ecommerce connectors. Nerve Centre runs the detection layer; Vortex Mind investigates the cause when something moves; Ask Viq lets you interrogate any number in plain English. [Start for free](https://app.vortexiq.ai/login) or [book a demo](https://www.vortexiq.ai/contact-us) to see this metric running on your own data.