> For the complete documentation index, see [llms.txt](https://docs.samita.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samita.io/analytics/overview.md).

# Analytics overview

Track add-to-cart events, orders, and revenue attributed to your badges, filtered by badge and date range.

The **Analytics** page shows how your badges affect shopper behaviour — how often products carrying a badge were added to cart, how many orders included them, and how much revenue they brought in.

{% hint style="info" %}
Analytics requires the **DIAMOND** plan, listed there as **Analytics & Reporting**. See [Pricing plans](/settings/pricing-plans.md).
{% endhint %}

## Open the Analytics page

In your Shopify admin, open the **Sami Product Labels** app, then click **Analytics** in the app sidebar. Key figures also appear at the top of the app **Dashboard**.

## What you can track

Three metrics, each shown both as a summary card and as its own chart:

| Metric                | What it counts                                                                  |
| --------------------- | ------------------------------------------------------------------------------- |
| **Total Add to Cart** | Times a customer added a product to their cart while it was displaying a badge. |
| **Total Orders**      | Completed orders that included products with an active badge.                   |
| **Total Revenue**     | Revenue from those orders, in your store's currency.                            |

## Filter the data

Two controls sit directly above the summary cards.

### Badge filter

The first control scopes the page to one badge instead of your whole catalogue. It reads **All badges & labels** by default, which is what you want for a store-wide view.

### Date range

The second control is the date range, set to **Today** by default. Click it to pick a preset:

| Preset            | Period                       |
| ----------------- | ---------------------------- |
| **Today**         | The current day so far.      |
| **Yesterday**     | The previous full day.       |
| **Last 7 days**   | The past week.               |
| **Last 30 days**  | The past month.              |
| **Last month**    | The previous calendar month. |
| **Last 90 days**  | The past quarter.            |
| **Last 365 days** | The past year.               |

For anything else, use the calendar beside the presets to set a start and end date, then click **Apply**. **Cancel** closes the picker without changing the range.

## Reading the charts

Each metric gets its own line chart below the summary cards, with the period total repeated in the card heading.

Every chart plots **two lines**: a solid line for the period you selected, and a dotted line for the equivalent period before it. The legend below the chart labels both. That comparison is what tells you whether a badge is gaining or losing traction — a solid line consistently above the dotted one means this period is outperforming the last.

The x-axis follows the range you picked: hours of the day for **Today** or **Yesterday**, and dates for the longer presets.

{% hint style="info" %}
Data collection starts when you activate your first badge. A brand-new store shows zeros across the board until badges go live and shoppers interact with them.
{% endhint %}

## Next steps

* [Pricing plans](/settings/pricing-plans.md) — compare plans and upgrade to unlock analytics.
* [Badges & Labels overview](/badges-and-labels/overview.md) — create and manage the badges these metrics measure.

{% hint style="success" %}
**Need support?**

If you run into any difficulty while following these steps, contact us at <support@samita.io>.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.samita.io/analytics/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.