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

# HelpAlive Audience and Reports: tenants, people and assists

> See which tenants and people use the HelpAlive agent, open any assist or chat, and read the reports on what the agent did.

**Audience** and **Reports** are the pages in the HelpAlive dashboard that show who uses the agent and how it goes. **Audience** goes from tenants to people to each assist or chat. **Reports** adds up what the agent did over a period.

For tenants and people, see [Key concepts](/product/concepts).

## Audience and Reports at a glance

* **Audience** goes from tenants to people to each assist or chat.
* **Reports** adds up what the agent did over a period you pick, and each report downloads as CSV.
* Assists and chats from a test link on **Test** are marked **Test run** or **Test chat**.
* Your team can read your users' chats here.
* After your retention window, a chat keeps its counts and dates but loses its words.

## Audience

### The Audience figures

| Figure | What it counts |
| - | - |
| **People** | Everyone your app has identified. |
| **Active this period** | People active in this billing period. |
| **Have the agent** | People that **Who gets it** on **Controls** gives the agent today. |
| **Helped this period** | People who started an assist in this billing period. |
| **Tenants** | Tenants on file. |

### Tenants

The left list, **Tenants**, holds "The companies or workspaces in your app." **B2C customers** refers to the one tenant that holds every person your app sends with no tenant. Use **Search tenants…**, and filter with **Every tenant**, **Helped** or **Not helped yet**. **All tenants** shows people across every tenant.

Click a tenant to show its people and open its drawer.

### People

The right list, **People**, shows each person with when they were last active. Use **Search people…** and filter by **Desktop** or **Mobile**.

### The Audience drawer

Clicking a row opens a drawer. It goes one level deeper each time, and **Open as page** shows any level as a full page.

* **A tenant**: how far the agent reaches in it, and its **Events**, **Chats** and **Assists**. Then **Its people**, its assists, and its latest activity for **7 days**, **30 days**, **90 days** or **A year**. It ends with the tenant's privacy state and history.
* **A person**: tabs for **Activity**, **Assists**, **Chats**, **Platforms** and **Privacy**.
* **An assist**: its name is the one the agent gave its offer, or else what they asked for. **The story** shows **What they asked for**, **How it ended** and the agent's closing words. **The assist in numbers** shows how long it took, its steps, and whether it **Counts toward your plan**. **What happened** goes step by step.
* **A chat**: its messages, any assist the chat offered and the person's answer, and the assists it ran, under **It ran one assist** or, for more, a count such as **It ran 2 assists**.

In the lists, a chat shows its first question in quotes under its title. An assist that stopped says the step it stopped at. Assists and chats from a test link on **Test** are marked **Test run** or **Test chat**. Test runs never count toward your plan.

Your team can read your users' chats here. Your terms with your own users should tell them so. After your retention window, a chat keeps its counts and dates but loses its words. See [Privacy Management](/dashboard/privacy-management).

The **Privacy** part of a tenant or person shows their tracking state and history, with **Open Privacy Management** to act on them.

## Reports

### The report period

Pick **Last 24 hours**, **Last 7 days**, **Last 30 days** (the default), **Last 90 days** or **Last 365 days**. **More ranges → Custom range** picks your own dates, up to a year.

### The five reports

Each report has a button to download it as CSV.

| Report | What it shows |
| - | - |
| **What the agent did** | **People helped**, **Assists started**, **Finished** (share of assists started), **Conversations** and **Messages**, against the period before. |
| **Assists per day and how they ended** | Assists started each day, split by ending. Press an ending to hide it. |
| **From started to finished** | The assists that finished, of every assist started. |
| **Questions and assists by page** | Each page of your app: **Questions** asked there, **Assists started** and **Finished**. Sort by any column and use **Find a page**. |
| **Agent use by tenant** | Assists and chats in each tenant, all time, with its people. Use **Find a tenant**. |

### How an assist ended

| Ending | Meaning |
| - | - |
| **Finished** | The agent took them to the end. |
| **Could not finish** | The agent could not do it and said so. |
| **Stopped** | They closed it, or started another assist. |
| **Timed out** | It went quiet until it timed out. |
| **Abandoned** | They left the page while it ran. |
| **Still going** | Started and not ended yet. |

### A page's detail drawer

In **Questions and assists by page**, click a number to open that page's drawer: the questions asked there, the assists started there, and the assists that did not finish, each saying how far it got. Questions past your retention window keep their count but not their words.

## Check it works

Once people use the agent in your app, **Audience** lists them under their tenants, and **Reports** fills in for the period you pick.

## Troubleshooting

* **A tenant shows as "Tenant" and a short id.** Pass `tenantName` in `identify()`. See [Identify users](/sdk/identify).
* **Audience is empty.** This is because nobody has been identified yet. The list says "No activity yet. Add HelpAlive to your app on Setup to start tracking." Finish the step **Add HelpAlive to your app** on **Settings → Setup & API Key**. See [The four steps](/dashboard/setup#the-four-steps).
* **A chat has no words.** This is because it is older than your retention window, or the person's data was deleted.

## Next

<CardGroup cols={3}>
  <Card title="Controls" icon="sliders" href="/dashboard/controls">
    Change who gets the agent.
  </Card>

  <Card title="Privacy Management" icon="shield" href="/dashboard/privacy-management">
    Stop tracking or delete a person's data.
  </Card>

  <Card title="Limits and usage" icon="gauge" href="/dashboard/usage">
    What counts against your plan.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.