> For the complete documentation index, see [llms.txt](https://playbook.nativemsg.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://playbook.nativemsg.com/get-started/quickstart/analytics.md).

# Analytics

## nativeMsg Analytics: Quick Start Guide

**Goal:** Understand how to measure performance across your bots, messages, and audiences — and use analytics to improve engagement.\
**Estimated Time:** 10 minutes

***

### 🧭 Overview

The **Analytics** section in nativeMsg helps you track performance across all your bots, messages, and users.\
You can view trends at a high level (all bots) or drill down into one bot’s activity.

> 💡 *Think of Analytics as your mission control — where you see what’s working, what’s not, and when your audience is most active.*

***

### 1️⃣ Where to Find It

* In the left navigation, click **Analytics.**
* Choose **All Bots** to view total activity, or pick a specific bot to zoom in.

You’ll see multiple panels — Ads, Bot Activity, Humans, Messaging, Subscribers, and Custom Reports.

***

### 2️⃣ What You Can See

#### 🔹 **Ads**

Track how your ad-driven campaigns perform.

* Impressions, Conversations, Engagements, Clicks
* Active Hours chart (see when engagement peaks)
* Identify which ads drive real conversation starts

***

#### 🔹 **Bot Activity**

Everything happening inside your bots.

* **Overview:** Conversations and engagement stats
* **Interactions Report:** Which flows are performing best
* **Common Phrases:** What users are typing most often
* **Active Hours:** When your users chat the most
* **Conversation Length:** Average duration of chat sessions

> 💡 *Use Common Phrases to refine your bot’s wording with real customer language.*

***

#### 🔹 **Humans**

Your audience metrics — new vs. returning users.

* Track audience growth over time
* Identify your most active customer segments
* See how engagement evolves after campaigns

***

#### 🔹 **Messaging**

Message-level performance across all bots and channels.

* Sent, Received, and Total message counts
* Compare message volume to user engagement
* Spot spikes to understand campaign or event impact

> 📈 *This is your quick pulse check for engagement health.*

***

#### 🔹 **Subscribers**

Understand your subscribed audience.

* Total **Subscribed** vs. **Unsubscribed** users
* View by **Tag** (audience segment) or **Channel** (SMS, Web, Facebook, etc.)

**Breakdowns available:**

| View                       | What It Shows                         |
| -------------------------- | ------------------------------------- |
| **Subscriptions by Tag**   | How many users belong to each segment |
| **Subscribers by Channel** | Where users are most active           |

> 💡 *Helps you focus future Blasts on the best-performing audiences.*

***

#### 🔹 **Custom Reports**

Create your own dashboards with only the data you care about.

1. Click **Custom Reports → + Add.**
2. Name your report.
3. Select the analytics modules to include (Ads, Bot Activity, Messaging, etc.).
4. Rearrange or remove panels using drag-and-drop.
5. Click **Create** to save.

✅ *Perfect for weekly KPI snapshots or monthly performance reviews.*

***

### 3️⃣ Filtering Data

Filter any analytics view to focus on the right bot, channel, or time period.

**At the top of the page:**

1. Choose a **Bot** (All Bots or specific).
2. Select a **Date Range**:
   * Today
   * This Week
   * 15 Days
   * 90 Days
   * Custom range (set your own start/end dates)
3. *(Optional)* Check **Exclude Deleted Channels** for cleaner reports.
4. Click **Apply Filters.**

> 💡 *The dashboard refreshes instantly with your filtered data.*

***

### 4️⃣ Exporting & Sharing

Need to share performance data with your team? You can export any view.

1. Click **Download** (top-right corner).
2. Choose your file format:
   * **CSV** (for spreadsheets)
   * **XLSX** (Excel)
   * **ODS** (OpenDocument)
   * **PDF** (for reports & presentations)
3. nativeMsg will refresh the latest data before exporting.
4. Share the file via email or include it in your internal reporting.

> 📤 *Pro Tip:* Filter your data first — exports match your active filters and date range.

***

### ✅ Pro Tips for New Users

| Tip                                        | Why It Matters                                            |
| ------------------------------------------ | --------------------------------------------------------- |
| **Start with “Humans + Messaging” panels** | Get a quick snapshot of overall engagement health.        |
| **Use “Common Phrases”**                   | Improve flows based on real customer input.               |
| **Create Custom Reports**                  | Save time on weekly or monthly reporting.                 |
| **Apply date filters before exporting**    | Keeps data aligned with your reporting period.            |
| **Check “Active Hours”**                   | Identify the best times to send Blasts or respond faster. |

***

### 📊 Example Use Cases

* **Marketing Teams:** Track campaign engagement, subscriber growth, and message conversions.
* **Customer Success Teams:** Monitor customer interactions and FAQs from Common Phrases.
* **Operations:** Evaluate support load via average conversation length and daily message volume.

***

### ✅ Quick Recap

You can use Analytics to:

* Measure campaign and bot performance
* Discover peak user activity hours
* Understand audience growth and retention
* Build and export your own reports

> 🧭 *Data is your feedback loop — check Analytics weekly to keep improving your messaging experience.*


---

# 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://playbook.nativemsg.com/get-started/quickstart/analytics.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.