> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Shopping Insights > Show how a website's products appear in AI shopping results (ChatGPT/AI Mode carousels), including visibility, position, pricing, and competitor comparisons. `app.athenahq.ai/shopping` ## Purpose Track how products surface inside AI shopping answers. Understand your brand's visibility, position, pricing, and how your products compare to competitors in shopping carousels (like those seen in ChatGPT or AI Mode). By monitoring buying-intent prompts, this dashboard reveals which specific items AI recommends, which retailers are stocking them, and who dominates the top ranking positions. ## What's on the page * **Filter row**: A contextual filter bar offering filters for "Models", "Date Range", "Competitors", "Prompt Tags", and "Brand Identifiers". It also includes a "Views" menu to save or load specific filter combinations. * **Shopping hero (AI shopping visibility)**: The headline metric showing your appearance rate percentage (how often your products appear in shopping answers) alongside a trend sparkline. To the right, a "You vs the field" section compares your "Avg position" (with a "Lower is better" hint) and "Avg price" against your competitors. * **Stat rail**: * **Shopping answers**: Total number of AI shopping answers. * **Your appearances**: Total count of times your products were featured. * **Competitor appearances**: Total count of times competitor products were featured. * **Tracked offers**: Total number of seller offers monitored, along with an overall average price. * **On the shelf**: A scrollable horizontal carousel of the top-performing products, ranked by how frequently they appear. You can use the segmented toggle to switch between "Yours" and "Competitors". Individual product cards display a product image, appearance count ("X× seen"), star rating, product title, merchant/retailer name, and the product's "avg #X" position. * **Rank distribution**: A stacked bar chart ladder showing who occupies each position in the shopping results. The length of the bars reflects how many products land at each rank, split by yours (indigo) versus competitors (orange). * **Appearances over time**: A daily line chart graphing the total number of product appearances over the selected date range, plotting your products (indigo) against your competitors (orange). * **Competitor leaderboard**: A table ranking competing brands based on how many of their products surface in your category. * **Top retailers**: A table displaying the stores and merchants where these products are stocked inside AI answers. A toggle lets you flip between retailers carrying your products versus those carrying competitors' products. ### Tables **Competitor leaderboard** * **#**: Rank position in the leaderboard. * **Competitor**: The competitor's brand name (or "Unknown"). * **Products**: The total number of products the competitor placed in shopping results, paired with a proportional bar. * **Avg pos**: The average rank position of the competitor's products in the shopping carousels. * **Answers**: The number of shopping answers that featured this competitor. **Top retailers** * **Retailer**: The merchant or retailer's name. * **Listings**: A visual bar and count representing the number of product listings. Hovering over this column reveals a tooltip breaking down the exact counts for "Yours" vs "Competitors". * **Avg pos**: The average position of the selected side's (yours or competitors') products at this specific retailer. * **Answers**: The number of shopping answers in which this retailer appeared. ## What you can do here * **Filter data**: Adjust the filter bar to narrow metrics by specific AI models, dates, competitors, prompt tags, or brand identifiers. * **View raw shopping answers**: Click the "View shopping answers" link in the hero section, or click the "Shopping answers" stat tile. This drills down to the Responses page, automatically applying a filter to show only the AI answers that included shopping products. * **Toggle side-by-side views**: In the "On the shelf" and "Top retailers" sections, use the "Yours" and "Competitors" segmented buttons to swap whose data is being displayed. * **Visit live product pages**: Click on any product card in the "On the shelf" section to open that exact product's URL on the retailer's external website in a new browser tab. * **View exact trend counts**: Hover over the "Appearances over time" line chart to see a tooltip with the exact daily appearance numbers for both your brand and competitors. * **View retailer breakdown**: Hover over the "Listings" column in the "Top retailers" table to see a tooltip detailing the exact split of listings between you and your competitors for that store. ## Data shown This page displays data extracted specifically from AI shopping carousels and product lists returned by AI assistants when they answer your tracked prompts. It compares the presence, pricing, and ranking of your own brand's products against the competitor brands you monitor. If a product does not have a saved image, the system attempts to fetch the image on-demand from the retailer's product page. ## Common workflows 1. **Assess overall shopping visibility** * Review the "AI shopping visibility" percentage in the hero. * Compare your "Avg position" and "Avg price" against the field to quickly judge competitiveness. * Scan the "Appearances over time" line chart to spot any dips or spikes in how often your products are recommended. 2. **Identify top-performing products** * Scroll down to the "On the shelf" carousel. * Make sure the toggle is set to "Yours". * Review the top product cards to see which items AI recommends most frequently, noting their average rank and merchant. * Toggle to "Competitors" to see which exact competitor products are dominating the space. 3. **Find out who is stocking the products** * Scroll down to the "Top retailers" table. * Ensure the toggle is set to "Yours" to see which stores are surfacing your products in AI answers. * Hover over the "Listings" column to view the breakdown of how many of your products versus competitor products that retailer is showing. 4. **Drill into the raw AI answers** * Click the "View shopping answers" link inside the hero (or click the "Shopping answers" stat tile). * You will land on the Responses page, pre-filtered to only show prompts that resulted in product carousels. * Read the exact AI responses to understand the context of why those products were recommended. ## Empty, loading, and error states * **Empty state (Never captured data)**: If your monitored prompts have never triggered a shopping response, the page hides the dashboard and displays a "No shopping data yet" empty screen featuring a placeholder illustration. A "Manage prompts" button is provided so you can track more buying-intent prompts to start capturing shopping results. * **Empty state (No data in range)**: If your website does have historical shopping data, but your current filters or date range exclude all of it, a "No AI shopping data yet" card appears inline. It explains that data will show up once AI returns shopping results for your monitored parameters. * **Loading state**: While data is being retrieved, a skeleton placeholder layout appears mimicking the hero, stat tiles, product shelf, and charts. * **Error state**: If the data request fails entirely, a "Couldn't load shopping data" card appears with a warning icon and a "Try again" button to reattempt the fetch. ## Linked from / links to * **Linked from**: Accessed via the "Shopping" item in the main left-hand sidebar navigation. * **Links to**: * **/responses**: By clicking "View shopping answers" or the "Shopping answers" stat tile, pre-filtered to shopping answers. * **/prompts**: Via the "Manage prompts" CTA on the total empty state. * **External Retailer Sites**: Clicking a product card opens the live product page in a new browser tab. ## Common support questions * **Why am I seeing a "No shopping data yet" screen?** This appears if the AI assistants haven't returned any shopping product carousels for the prompts you are tracking. Tracking more bottom-of-the-funnel, transactional prompts increases the chance of capturing shopping data. * **Why do some product cards just say "No image"?** When an AI returns a product, it doesn't always provide an image. The system attempts to fetch the image directly from the retailer's website when you open the dashboard, but if the retailer blocks the request or the image is unavailable, the placeholder remains. * **What happens when I click on a product on the shelf?** Clicking a product card will safely open the retailer's actual product listing page in a new browser tab so you can inspect the live offer. * **Why is the "Avg position" showing as a dash?** If AI returns products in a loose list rather than a strict ranked carousel, the position data might be absent. In these cases, the average position cannot be calculated and displays as a dash ("-").