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

# App Analytics

See how people use your app, what brings them back, and what to do next. Learn how dates, comparisons and the Overview tab work.

App Analytics shows how people use your app, what brings them back, and what to do next. Open it from your app's dashboard.

{% hint style="info" %}
App Analytics needs the **PowerSuite** plan. Without an active PowerSuite plan, the page is locked.
{% endhint %}

If your app's current version doesn't support App Analytics, the page shows **Feature not supported**. Choose **Add new version** to create a new version of your app. See [Create New App Version](https://help.twinr.dev/app-version/create-new-app-version.md).

## What's recorded automatically

You don't need to set anything up for these:

* **Sessions.** A session starts when someone opens your app or brings it back to the screen, and ends when they leave it.
* **Page views.** Every screen and web page people open in your app.
* **Firebase and element events.** Taps you set up as events in [Custom Analytics](https://help.twinr.dev/native-integrations/firebase-analytics/custom-analytics.md), plus hamburger menu items and navigation bar buttons.
* **Store orders.** If your store is connected through the Twinr Shopify or WooCommerce plugin, its orders show on the **Revenue** tab.
* **Push permission and push campaigns.** Who allowed push, and how many pushes were sent and tapped.

To add your own events, or orders from your own website, see [Track Custom Events](https://help.twinr.dev/twinr-in-built-analytics/track-custom-events.md).

## The five tabs

| Tab                                                                               | What it shows                                                                    |
| --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **Overview**                                                                      | A summary of the period, what to do next, and your key numbers. Described below. |
| [**Engagement**](https://help.twinr.dev/twinr-in-built-analytics/engagement.md)   | Pages, custom events, and tools to check your event tracking.                    |
| [**Retention**](https://help.twinr.dev/twinr-in-built-analytics/retention.md)     | How many people come back, and who is about to stop.                             |
| [**Acquisition**](https://help.twinr.dev/twinr-in-built-analytics/acquisition.md) | New users, where sessions come from, and the devices people use.                 |
| [**Revenue**](https://help.twinr.dev/twinr-in-built-analytics/revenue.md)         | Revenue, orders, top products and promo codes.                                   |

The gear at the top opens **Analytics settings**: your reporting time zone, page grouping and reporting currency. See [Settings](https://help.twinr.dev/twinr-in-built-analytics/settings.md).

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-8515ddbd518606147b8780eb5aa1d79582329697%2Fanalytics-overview-1.png?alt=media" alt="The Overview tab with the date ranges, the period summary and the key numbers"><figcaption></figcaption></figure>

## Choose a date range

Every tab uses the date range you pick above it. The page opens on **7 days**.

| Range                                | What it covers                                                  |
| ------------------------------------ | --------------------------------------------------------------- |
| **Today**                            | Today so far.                                                   |
| **7 days**, **30 days**, **90 days** | That many full days, ending yesterday.                          |
| **12 months**                        | The last 12 months, ending yesterday.                           |
| **Custom**                           | Any start and end day, up to 366 days, ending today or earlier. |

Next to the range you see its dates. Under them, **Compare: previous period** shows the dates it is compared with. The previous period is the same number of days, right before your range. For **Today**, it is yesterday up to the same time of day.

A change shows under each number as a green tag with an upward arrow when it went up, or a red tag with a downward arrow when it went down, followed by **vs previous**. Rates, such as retention, change in points (**pts**). A change is hidden when the previous period had nothing to compare with.

Charts group your data by size of range:

| Range length   | Each point on a chart is |
| -------------- | ------------------------ |
| Up to 31 days  | A day                    |
| Up to 186 days | A week, starting Monday  |
| Longer         | A month                  |

## Your app's time zone

Days in App Analytics are your app's days, in its reporting time zone. The first time you open App Analytics, it takes your browser's time zone. You can change it in [Settings](https://help.twinr.dev/twinr-in-built-analytics/settings.md#reporting-time-zone).

## When numbers update

New sessions, page views, events and orders show up within about 15 minutes.

Some numbers are worked out once a day, shortly after midnight in your app's time zone: return rates, cohorts, the **People** counts for preset ranges, the **What to do next** cards and milestones.

When App Analytics first starts for your app, it works out your past days in the background. Until it's done, charts that reach back that far show **Preparing your history**, and changes against the previous period stay hidden.

## Before your first session

Until someone opens your app, App Analytics shows **Getting started** instead of the tabs: "Your numbers will show here once people start opening your app." The checklist has three steps:

1. **Publish your app.** **Go to App Build** takes you there. It shows **Done** once your app is published.
2. **Your first session.** It shows **Waiting** until someone opens your app.
3. **Send your first push.** **Create a push** opens Engage.

## The Overview tab

### This period

The line at the top sums up your range in one sentence.

For an established app, it compares sessions with the previous period: "Sessions were up 24% this period (1,200 → 1,488)". An app is established once its first session is at least 14 days old and it had 50 or more active users in the last 30 days. The sentence appears when sessions changed by at least 10% and by at least 20 sessions, with at least 30 sessions in both periods.

For **Today**, it compares with yesterday up to the same time: "Sessions are up 12% today (300 → 336)".

Otherwise, and always for **Custom**, it counts people: "320 people opened your app this period, and 85 came back." When no one came back, it says "…all for the first time.", and with no visits, "No one opened your app this period."

### Milestones

When your app reaches a milestone, it shows under the summary for 14 days, with the next one to aim for.

| Milestone       | Steps                                             |
| --------------- | ------------------------------------------------- |
| Users           | 1, 10, 100, 1,000, 5,000, 10,000, 50,000, 100,000 |
| Returning users | Your first returning user                         |
| Pushes sent     | Your first push                                   |
| Push taps       | 1, 1,000                                          |
| Orders          | 1, 100, 1,000                                     |

### Key numbers

| Number           | What it means                                                                                                                            |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Active users** | People who opened your app in the range                                                                                                  |
| **Sessions**     | How many sessions people had in your app. Everyone counted in **Active users** had at least one session, so **Sessions** is never lower. |
| **Avg session**  | Average time per session                                                                                                                 |
| **D7 retention** | Share of new users who came back a week later. Shows for the 7 days, 30 days, 90 days and 12 months ranges.                              |
| **Push opt-in**  | Share of devices seen in the last 90 days that allow push and can receive it. It doesn't change with the range.                          |
| **Revenue**      | Revenue in the range. Shows when the range has orders.                                                                                   |

### What to do next

Up to three cards suggest your next step. Each one opens the right place, with the audience filled in. They are updated once a day.

| Card                       | When it shows                                                                                                    | Button                   |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------ |
| **Send your first push**   | Your app isn't established yet and hasn't sent a push                                                            | **Create a push**        |
| **Track what people do**   | Your app isn't established yet and has no custom events                                                          | **Add your first event** |
| **Track your sales**       | Your app isn't established yet and has no orders                                                                 | **Read the guide**       |
| **Bring back quiet users** | Your app is established, and 20 or more people used it in the last 60 days but not in the last 14                | **Send a win-back push** |
| **Your last push worked**  | Your app is established, and a one-time push in the last 14 days led to 10 or more sessions in the next 24 hours | **Reuse this campaign**  |

Two more buttons on each card:

* **Dismiss for 30 days** hides the card for 30 days.
* **Mark as done** hides a setup card for good. A **Bring back quiet users** or **Your last push worked** card can come back after 30 days.

**Send a win-back push** opens Engage with a new one-time push, aimed at a segment named **Quiet users**: people who used your app in the last 60 days but not in the last 14. If your app doesn't have that segment yet, it is created for you. If it can't be created, you see "Couldn't create the audience. Try again or pick a segment in Engage."

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-913d37883964abad71e5f655fe82c7a1a8b569b4%2Fanalytics-overview-2.png?alt=media" alt="What to do next cards, the Active users chart, and the top pages and top custom events"><figcaption></figcaption></figure>

### Active users

The chart shows how many people used your app on each day, or the average per day for each week or month. The big number is the **avg daily users** over your range. The previous period shows as a dashed line.

### Top pages and top custom events

**Top pages** lists your five most viewed pages. **Top custom events** lists your five most frequent events. **See all** opens the [Engagement](https://help.twinr.dev/twinr-in-built-analytics/engagement.md) tab.

If your app has no custom events yet, **Add your first event** opens [Track Custom Events](https://help.twinr.dev/twinr-in-built-analytics/track-custom-events.md).
