> For the complete documentation index, see [llms.txt](https://docs.letsmetrix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.letsmetrix.com/insights-and-metrics-v2/overview.md). # Overview Start here. Learn how the new Insights & Metrics area on the app page is organized, and how to read the App Health Snapshot. This page explains how the new **Insights & Metrics** area on the app page works. Read it first. It helps you understand every chart in the next 5 pages. {% hint style="info" %} **Where to find it:** Open any app page on Letsmetrix. Scroll down, past the app information. You will see the date bar, the **App Health Snapshot**, and the **Insights & Metrics** menu. {% endhint %} ### How the page is organized The page has 4 parts, from top to bottom: | # | Part | What it does | | - | ----------------------- | --------------------------------------------------------------------------- | | 1 | **Date range bar** | Choose the period you want to see, and the period you want to compare with. | | 2 | **Time zone** | Choose which time zone is used to group data by day. | | 3 | **App Health Snapshot** | 5 cards that show the health of the app in one look. | | 4 | **Insights & Metrics** | 5 tabs with detailed charts. Each tab answers one big question. |
### Date range and compare period **What it does:** Every number on the page is calculated for the **date range** you choose. The second box (it starts with "vs") is the **compare period**. By default, it is the period just before your date range, with the same length. **How to read the change badges:** * A **green** badge means the metric moved in a good direction. * A **red** badge means the metric moved in a bad direction. * The arrow shows if the number went up (↑) or down (↓). {% hint style="warning" %} **Rank is different.** For rankings, a smaller number is better (#1 is the top). So when a rank number goes up, the badge is red, because the app moved down the list. {% endhint %} **How to use it:** 1. Click **Date range** and choose a period (for example, the last 30 days). 2. Click the **vs** box and choose what to compare with (for example, the previous 30 days). 3. All cards and charts update. Look at the badges to see what changed. ### Time zone Some sections show a small **UTC tag** (for example, `UTC+07:00`) next to their title. In these sections, days follow the time zone you choose. Other sections keep the dates from their data source. {% hint style="info" %} Choose the same time zone that your team uses for reports. This way, "one day" means the same thing in Letsmetrix and in your own reports. {% endhint %} ### Data source badges Each chart has a badge. The badge tells you where the data comes from and what you need to see it. | Badge | Meaning | What you need | | --------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `PUBLIC` | Open data from the Shopify App Store. | Nothing. You can see it for any app. | | `SHOPIFY` | Data from the Shopify Partner API (installs, revenue, plans). | Your own app, connected with [Connect Shopify API](https://docs.letsmetrix.com/get-started/connect-shopify-api). | | `GA4` | Traffic data from Google Analytics 4 (views, channels, conversion). | Your own app, connected with [Connect GA4](https://docs.letsmetrix.com/get-started/connect-ga4). | ### App Health Snapshot **What question does it answer?** "Is my app healthy right now, and what changed?" The snapshot shows 5 cards. Each card has a main number, a small trend line, a change badge, and a short note below. | Card | Main number | Note below the number | | ------------------ | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | | **Visibility** | The average rank of the app in its main category (for example, #5 / 250 means rank 5 of 250 apps). | The category used. | | **Installs** | New installs in the date range. Needs Shopify sync. | Uninstalls and the net change (installs minus uninstalls). | | **Retention Rate** | The average share of installed stores that are still active. The change is in percentage points (pp). | How many stores are active now, out of all stores that ever installed. | | **Revenue** | Net revenue received, after Shopify fees. | Gross billed (the amount before fees). | | **Reputation** | The current star rating. | New reviews, removed reviews, and the net change. The badge compares new reviews with the compare period. | **How to use it:** 1. Read the 5 badges first. Find the red ones. 2. Open the tab that matches the red card (see the table below). 3. Use the charts in that tab to find the reason. **Example:** Imagine the **Installs** card is red, but **Visibility** is green. Your rank is fine, so people still find the app. The problem is more likely on the listing page. Open **Acquisition & Conversion** and check the conversion rate. ### Which tab should I open? | Your question | Open this tab | | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | Can merchants find my app? | [Visibility & Discovery](https://docs.letsmetrix.com/insights-and-metrics-v2/visibility-and-discovery) | | Do visitors install my app? Where do they come from? | [Acquisition & Conversion](https://docs.letsmetrix.com/insights-and-metrics-v2/acquisition-and-conversion) | | Is my merchant base growing? Do merchants stay? | [Growth & Retention](https://docs.letsmetrix.com/insights-and-metrics-v2/growth-and-retention) | | How much do I earn? Which plans make money? | [Revenue & Monetization](https://docs.letsmetrix.com/insights-and-metrics-v2/revenue-and-monetization) | | What do merchants think of my app? | [Reputation & Trust](https://docs.letsmetrix.com/insights-and-metrics-v2/reputation-and-trust) | ### Glossary | Term | Meaning | | ----------------------------------- | ------------------------------------------------------------------------------------------------ | | **pp (percentage points)** | The simple difference between two percentages. From 30% to 32% is +2 pp. | | **Net** | The result after you subtract the negative side. For example, installs minus uninstalls. | | **CTR (click-through rate)** | Clicks divided by page views. | | **CR / Install rate** | Installs divided by page views. It shows how well a page turns visitors into users. | | **MRR (monthly recurring revenue)** | The revenue you expect every month from active paid plans. | | **ARPU (average revenue per user)** | The average monthly revenue from one paying merchant. | | **LTV (lifetime value)** | The total revenue you can expect from one paying merchant over the whole time they use your app. | | **Cohort** | A group of merchants who installed the app in the same day, week, or month. | | **Churn** | Merchants who stop using the app (they uninstall it or their store closes). | {% hint style="info" %} Looking for the old dashboards? They are still available in **V1 - Insights & Metrics**. {% endhint %}