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

# Analytics

> A comprehensive overview of user interactions and performance metrics for your AI agent.

## Overview

The Analytics page provides a variety of metrics to help you understand user interactions with your AI agent. From monthly interaction counts to detailed retention charts, this page equips you with the tools to assess your agent’s effectiveness and make informed, data-driven decisions.

***

## Key Features

### 1. **Interactions**

<Note>
  This metric shows the total number of user interactions your chatbot has handled within the selected time range, helping you track growth in usage.
</Note>

* Displays total interactions and conversations handled by the chatbot.
* Includes insights on average messages per chat and time spent per chat.

### 2. **Top Intents**

<CardGroup cols={2}>
  <Card title="Monthly Interactions" icon="calendar">
    Track the number of interactions your agent handles over time.

    <img src="https://mintcdn.com/convocore/YDOB1G28XgxvIwqF/images/monthly-interactions.png?fit=max&auto=format&n=YDOB1G28XgxvIwqF&q=85&s=bf4bc814a208ec928f6bc56f9de3cdc8" alt="Total Conversations Graph" width="550" data-path="images/monthly-interactions.png" />

    <Check>Custom limits can be set in the agent settings tab.</Check>
  </Card>

  <Card title="AI Tokens Usage" icon="coin">
    Monitor AI token consumption to optimize costs and performance.

    <img src="https://mintcdn.com/convocore/kNoD7_2-fZetOeo6/images/total-usage.png?fit=max&auto=format&n=kNoD7_2-fZetOeo6&q=85&s=be361ab06a6f7deef0fc2643e1b57362" alt="Total Conversations Graph" width="550" data-path="images/total-usage.png" />

    <Check>Custom limits can be set in the agent settings tab.</Check>
  </Card>

  <Card title="Unique Traffic" icon="messages">
    Track the number of distinct users initiating conversations with your agent.
  </Card>

  <Card title="Total Interactions" icon="comments">
    View the cumulative number of interactions over time.
  </Card>

  <Card title="Average Messages per Chat" icon="comment-dots">
    Understand the average length and depth of conversations with your agent.
  </Card>

  <Card title="Average Seconds per Chat" icon="clock">
    Measure your agent's efficiency by tracking the average duration of interactions.
  </Card>
</CardGroup>

<Note>
  The **total interactions** and **total conversations** are displayed as key metrics at the top of the Analytics tab and as graphs based on your selected time range.
</Note>

### 3. **Understood Messages**

<Card>
  A pie chart visualizes the percentage of messages understood by your agent.
</Card>

* Green and red sections of the chart highlight successful versus misunderstood messages.

### 4. **Total Conversations**

<Note>
  This metric indicates the total number of conversations your agent has had across all platforms.
</Note>

### 5. **User Retention**

<Note>
  User retention tracks how many interactions users have before leaving the conversation.
</Note>

* The graph shows the percentage of users retained across different interaction counts, helping identify where users drop off.

### 6. **Time Retention**

<Tip>
  This metric shows how long users stay engaged with the chatbot during conversations. Higher retention indicates better engagement.
</Tip>

* Measured in seconds, it represents engagement duration across the user base.

***

## Visual Representation

Add the following visual aids to the documentation:

* **Monthly Interactions**: Embed a bar graph screenshot to illustrate how interactions are represented.
* **Retention Metrics**: Include retention graphs for both user and time retention to explain trends.
* **Top Intents**: Add a pie chart visualization for intents to provide a clear picture of chatbot use cases.

<Warning>
  Ensure your agent’s intents are well-defined and aligned with user needs to maintain high message understanding.
</Warning>

***

## Best Practices

<Tip>
  Regularly review your agent's analytics to spot trends, identify areas for improvement, and ensure the bot meets user expectations effectively.
</Tip>

***

## Conclusion

The Analytics page is a powerful tool for monitoring your AI chatbot's performance. By leveraging the metrics and insights provided, you can continuously refine your bot and ensure a high-quality user experience.