> ## 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. # Orders by State, Bonanza > Orders 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 > Orders by State breaks your Bonanza order count down by US state and renders it on a choropleth map. It shows where buyer demand is concentrating across the country, so you can see at a glance which states drive volume from your booth. A clear geographic read helps with shipping-zone planning and regional marketing. Use it alongside AOV by State to separate where orders come from versus where the high-value baskets sit. | | | | --------------------- | ----------------------------------------------------------------------------------------------------------------------- | | **What it counts** | The number of Bonanza orders placed by buyers in each US state over the window. | | **Sample type** | Backend API data from Bonanza, refreshed on the standard data refresh. | | **Why it matters** | Demand concentration by state guides shipping-zone planning, regional ad spend, and inventory positioning. | | **Reading the value** | Darker states carry more orders. Compare the spread, not just the single busiest state, to understand regional balance. | | **Currency** | number | | **Time window** | `30D` | | **Alert trigger** | `-` | | **Sentiment key** | `bon_orders_by_state` | | **Roles** | owner, marketing | ## Calculation Each Bonanza order in the window is attributed to the buyer's shipping state, then summed per state. The result is a per-state count rendered as a choropleth, with intensity scaled to the order volume in each state. See At a glance for the window and the worked example below for a representative reading. ## Worked example *A representative reading of **Orders by State** for a typical merchant on Bonanza.* On 14 Mar 26 a booth selling vintage homeware sees 420 orders across the trailing 30 days, with California at 78, Texas at 54, and New York at 41, while the remaining volume scatters thinly across 30 other states. The map shows demand heavily weighted to the coasts and the southern corridor, which suggests the seller should review carrier zones and consider a regional promotion in the underweight Midwest. The action here is to align shipping rates and ad targeting with where buyers actually are. Vortex Mind can trace whether a state's spike is driven by a single listing or a broad lift, and Ask Viq lets you ask in plain English which states grew fastest this month. ## Sibling cards merchants should reference together | Card | Why merchants reach for it | | ----------------------------------------------------------------------- | ------------------------------------- | | [`bon_aov_by_state`](/nerve-centre/kpi-cards/bonanza/aov-by-state) | Geography sibling: AOV by State. | | [`bon_order_count`](/nerve-centre/kpi-cards/bonanza/total-transactions) | Fulfilment sibling: Orders. | | [`bon_orders_per_day`](/nerve-centre/kpi-cards/bonanza/orders-day) | Fulfilment sibling: Orders / Day. | | [`bon_aov`](/nerve-centre/kpi-cards/bonanza/average-order-value) | Revenue sibling: Average Order Value. | | [`bon_total_revenue`](/nerve-centre/kpi-cards/bonanza/total-revenue) | Revenue sibling: Total Revenue. | ## Reconciling against Bonanza **Where to look in Bonanza's own dashboard:** In Bonanza, open your booth dashboard and the selling area to review order records and buyer shipping addresses, which underpin the state-level attribution shown here. **Why the Vortex IQ value may legitimately differ:** | Reason | Direction | What to do | | --------------------------------------------------------------------------------------------------------------------- | --------- | ------------------------ | | **Period boundary.** Vortex IQ uses a trailing 30-day 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 Orders by State update?** It follows the trailing 30-day window and refreshes on the standard data refresh, typically every 30 to 60 minutes. You can also trigger a manual refresh to pull the latest order records. **Q: Why does my Bonanza dashboard show a different number?** Most differences come from period boundaries, time zone alignment, or profile-level filters such as booth or test-order exclusions. Match the window and filters and the totals should line up. **Q: How are orders with no state or international buyers handled?** Orders without a recognised US state, including international buyers, are not attributed to a state and so do not appear on the US choropleth, which can make the map total slightly lower than your overall order count. **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 *Orders 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.