---
title: Analytics
description: Access aggregated data about your Mini.
api_name: shop-minis
source_url:
  html: 'https://shopify.dev/docs/api/shop-minis/analytics'
  md: 'https://shopify.dev/docs/api/shop-minis/analytics.md'
---

# Analytics

Access aggregated data about your Mini.

***

## Overview

The Shop Minis CLI provides access to analytics reports that help you understand how your Mini is performing. These reports provide valuable insights into user engagement, conversions, and other key metrics.

The CLI provides several commands to work with analytics reports:

* Use the [`reports list`](./commands/reports-list) command to view all available report types
* Use the [`reports dates`](./commands/reports-dates) command to see available dates for a specific report
* Use the [`reports get`](./commands/reports-get) command to download report data as CSV

[Command - List all available reports](./commands/reports-list)

[Command - View available dates for a report](./commands/reports-dates)

[Command - Get report data as CSV](./commands/reports-get)

***

## Report types

The following report types are available for analytics:

### SALES

Shows sales data for your Mini, including order count and revenue.

**Fields:**

* `day`: The date for which data was collected (in UTC)
* `shop_id`: Identifier for the shop
* `product_id`: Identifier for the product
* `num_orders`: Number of orders
* `total_gmv_usd`: Total gross merchandise value in USD

### USAGE\_​STATS

Shows how users interact with your Mini, over the course of a day.

**Fields:**

* `day`: The date for which data was collected (in UTC)
* `num_sessions`: Number of user sessions
* `num_users`: Number of unique users
* `num_mini_opens`: Number of times the Mini was opened

**Note:**

All reports are generated daily and the data is available within 24 hours of the date the data is from. Additional report types may be added over time.

***