> ## Documentation Index
> Fetch the complete documentation index at: https://developers.gotolstoy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Store analytics

> The tool that reads a store's analytics report: its Tolstoy widgets and the events it sends with the Tolstoy SDK.

## get\_store\_analytics

The analytics report of one store, read from the same code as the merchant's Analytics page and its export. Every revenue, order, buyer, conversion, AOV or engaged-shopper number you give comes from this report, so the merchant sees the same number in the chat, on the page and in the export. A number you build yourself in SQL has another meaning and will not match. Amounts are in report.currency. This store's domains, headless shop, app traffic and widgets. A shopper who watched a video, finished a try-on or chatted. Autoplay counts only after the shopper interacts, and opens are counted separately. An order counts if the same shopper placed it in this store within the window after a widget open, both in the same period. For conversion, the window starts at engagement. Engaged shoppers who bought within the window after engaging, divided by all engaged shoppers. No daily conversion: engagement and order can fall on different days. Items added to cart from a widget within the window before the order. N/A: no widget add to cart was recorded. Other items a widget showed within the window before the order. Other items in the same order. Direct (In-video + Post-video) + Indirect. Average order value of Tolstoy shoppers compared with the store's other orders. A comparison, not lift. N/A means nothing was measured; 0 is a real zero. Impressions, Plays and Shoppers who wrote show N/A when none was recorded. The overview section holds overview, daily, widgetCatalog, liveWidgetTypes, widgetTypes and widgets; the details section holds topVideos, topProducts, events, tryOn and chat. A section that was not asked for is null. Rows do not add up: one shopper or order can count under several widgets. Widgets that ran on this store in the period or are live, whatever the filters. Live = published and active. Widget type tolstoy-sdk lists the store's own events sent with the Tolstoy SDK. They are not opens, engagement, try-ons, add to carts or revenue.

> [accordion] Input schema
>
> ```json theme={null}
> {
>   "type": "object",
>   "properties": {
>     "appUrl": {
>       "type": "string",
>       "minLength": 1,
>       "maxLength": 300,
>       "description": "The store's appUrl. Omit it for the account's largest live store; the report lists every store."
>     },
>     "dateFrom": {
>       "type": "string",
>       "format": "date",
>       "description": "First UTC day of the period, YYYY-MM-DD."
>     },
>     "dateTo": {
>       "type": "string",
>       "format": "date",
>       "description": "Last UTC day of the period, YYYY-MM-DD. At most 180 days after dateFrom."
>     },
>     "window": {
>       "type": "string",
>       "enum": [
>         "24h",
>         "3d",
>         "7d",
>         "30d"
>       ],
>       "default": "24h",
>       "description": "How long after a widget open an order still counts; conversion counts from engagement. 24h unless the merchant chose another window."
>     },
>     "widgetIds": {
>       "type": "array",
>       "items": {
>         "type": "string",
>         "minLength": 1,
>         "maxLength": 100
>       },
>       "minItems": 1,
>       "maxItems": 200,
>       "description": "Only these widgets. Omit for the whole store."
>     },
>     "channel": {
>       "type": "string",
>       "enum": [
>         "web",
>         "app"
>       ],
>       "description": "web or app (Tapcart). Omit for both."
>     },
>     "sections": {
>       "type": "array",
>       "items": {
>         "type": "string",
>         "enum": [
>           "overview",
>           "details"
>         ]
>       },
>       "minItems": 1,
>       "default": [
>         "overview"
>       ],
>       "description": "overview for the totals, widget types, widgets and days; details for top videos, top products, events, try-on and chat."
>     }
>   },
>   "required": [
>     "dateFrom",
>     "dateTo"
>   ],
>   "additionalProperties": false,
>   "$schema": "http://json-schema.org/draft-07/schema#"
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.