> For the complete documentation index, see [llms.txt](https://mind-expression-docs.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mind-expression-docs.gitbook.io/home/concepts/analytics.md).

# Analytics

View analytics of your AI activities on Analytics. With Analytics, you can see how your AI performs and how your customers engage with your subjects.

### Metrics

At the moment, Mind Expression provides analytics for API Calls, and Popular Subjects counts.

### AI Activities Report

You can view a record of chat logs as well as basic chat summary statistics in the AI Activities Report panel.&#x20;

<figure><img src="/files/zdC6cfFw2YXL7eI84Ipj" alt=""><figcaption></figcaption></figure>

How to extract the reports:

1. Select the Scope that you would like to extract analytics from.&#x20;
2. Select the date range of the desired data.&#x20;
3. Click Export Report. A zip folder containing two files will be downloaded: *`chat_history.csv`* and *`chat_history_statistics.csv`*

**`chat_history.csv`**

This file contains all chat logs from both human users and the AI responses. It includes the following fields:

1. Scope Name - scope from which the data is extracted
2. Scope ID - unique ID assigned to the corresponding scope
3. Channel - integration channel in which the chat was triggered
4. Timestamp - exact timestamp in which the chat was entered in the format:&#x20;

   `-yyyy MMM dd HH:mm:ss.SSS zzz`
5. Conversation ID - a unique ID assigned to one whole conversation, which begins once the CAI is triggered and ends once the user terminates the session or experiences a session timeout.&#x20;
6. Query ID - a unique ID assigned to each query within a conversation
7. Chat - the exact output or log of the chats from the user and the AI&#x20;
8. Is Query - `TRUE` if the chat is from the human user, `FALSE` if the chat is a response from the AI
9. Subject Recognition - the specific subject name that was triggered by the chat
10. Is Fallback - `TRUE` if the chat is a fallback, `FALSE` if the chat is not a fallback

**`chat_history_statistics.csv`**

This file contains basic summary statistics of the chat logs that were extracted from the chat history. It contains the following metrics:

1. Date Range - time period covered by the data&#x20;
2. Total number of transactions - total number of inquiries that have been responded/answered with substantive information to the users of the Customer&#x20;
3. Total number of queries - Number of chats in the history log that are entered by the user&#x20;
4. Number of unique chats - total number of unique conversations that have been completed, i.e, a chat that was triggered and terminated.&#x20;
5. Average number of transaction per chat - average number of chats that a user enters within one whole conversation
6. Chat Duration - length of time a user takes to complete a whole conversation from start to finish. The percentile breakdowns are also presented.&#x20;
7. Number of fallbacks - number of chats that are not recognized by the conversational AI and thus resulted to fallbacks
8. Subject Activation Counts - a breakdown of the number of times each subject has been activated

### API Calls

You can see the total API calls during the selected timeline. Use the drop downs to choose the time you want to know the analytics and the time format for the data display.

![](/files/Ebdd2qelfCumpellSKIo)

### Popular Subjects&#x20;

The Popular Subjects section authorizes you to browse the overall tally of your scope. It allows you also to see how many of your users have been able to activate your Subjects.

![](/files/fYzxkaJggZjvWAiMNy15)


---

# 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://mind-expression-docs.gitbook.io/home/concepts/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.
