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

# Shopping

> Track how your brands, products and retailers appear in AI shopping results

Some AI answers come with a product block attached — a carousel of items with prices, ratings and
retailers. The **Shopping** page (**Intelligence → Shopping**) reports how your brands and products
show up inside those blocks.

<Info>
  Shopping data only exists for responses whose model returned a product block, so coverage varies
  a lot by model. Use the **AI Models** filter to see which of yours actually produce it.
</Info>

<Tip>
  Dedicated shopping assistants — **Amazon Rufus** and **Alexa** — are available as add-ons and
  produce far richer shopping data than a general chat model. [Talk to our sales
  team](mailto:support@mentionlab.io?subject=Enabling%20Rufus%20and%20Alexa) to enable them.
</Tip>

## Headline numbers

| Card                     | What it counts                                               |
| ------------------------ | ------------------------------------------------------------ |
| **Shopping Coverage**    | Percentage of all AI responses that carried shopping results |
| **Identified Brands**    | Distinct brands detected across those results                |
| **Identified Products**  | Distinct products detected                                   |
| **Identified Retailers** | Distinct retailers (merchants) detected                      |

<Note>
  Shopping Coverage divides by **all** responses in the period, not just the shopping ones. Setting
  the **Shopping** filter to "Shopping" pins it at 100%.
</Note>

## Brand Visibility Over Time

A stacked-area chart of how often your tracked brands appear in shopping results, one series per
entity. **Daily** / **Weekly** / **Monthly** buckets.

## Top Products

A scrollable carousel of the most-mentioned products, each showing its image, brand, visibility
percentage, mention count, average price and average rating.

## Top 50 Brands and Retailer Distribution

Side by side:

* **Top 50 Brands** — the most visible brands in shopping results, with **Visibility** ("% of
  shopping responses that include this entity") and **SoV** ("this entity's portion of all shopping
  mentions"). Your own brand's row is highlighted.
* **Retailer Distribution** — a donut of the top 10 merchants by market share. Anything under 1%
  folds into an **Other** slice.

## The detail tables

Three tabs at the bottom of the page.

### All Products

Every product resolved to a specific catalog entry.

| Column            | Meaning                                                    |
| ----------------- | ---------------------------------------------------------- |
| **Product**       | Product name, with its brand beneath                       |
| **Visibility**    | Percentage of shopping responses that include this product |
| **Avg Price**     | Average price across all occurrences                       |
| **Avg Rating**    | Average star rating across all occurrences                 |
| **Top Merchants** | Up to three retailers carrying it                          |

Filter by **Brands** and by **Entity Type** (Primary, Owned, Competitor).

<Warning>
  A counter beside the toolbar reads "*n* Unknown · *m* Not matched". Those are shopping appearances
  that could not be resolved to a product, so they are **not** in this table. **Unknown** = a brand
  was identified but no product; **Not matched** = no brand at all. Map them from
  **Project settings → Shopping Settings → Shopping Products**.
</Warning>

### All Brands

One row per brand: product count, visibility, average price and rating, and top merchants. Your own
brand carries a **You** badge.

### All Merchants

One row per retailer:

| Column                | Meaning                                                            |
| --------------------- | ------------------------------------------------------------------ |
| **Citation Rate**     | How often this merchant appears across all AI responses            |
| **Citation Share**    | This merchant's portion of all merchant citations                  |
| **Entity Cit. Share** | This merchant's share of all brand-matched merchant rows           |
| **True Reach**        | Percentage of this merchant's product rows that mention your brand |

Click a row for the merchant sheet: every product that merchant is cited for, with price, rating,
its share of that merchant's products, and a link to the offer where one was captured.

## Mapping unresolved products

Two pages under **Project settings → Shopping Settings**:

* **Products** — the project's canonical product catalog. Select two or more products of the same
  brand and use **Actions → Merge** to combine duplicates.
* **Shopping Products** — the raw per-appearance rows. Filter by **Mapping status** to
  **Unknown** or **Not matched**, then assign the right **Entity** and **Product**, individually or
  in bulk.

Mapping these rows is what moves them out of the "not listed here" counter and into your analytics.

## Exporting

**Project settings → Export data → Shopping & Merchants** produces three CSVs: merchant-level
metrics, products per merchant with offer URLs, and one row per product with the external product
IDs mapped to it.