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

# Analytics

> Monitor agent performance with usage metrics, conversation trends, and geographic insights

## Overview

The Analytics dashboard gives you comprehensive insights into how your agent is performing. Track conversation volumes, measure user satisfaction through feedback metrics, and understand where your visitors are coming from geographically.

<Tip>
  Use analytics data to make informed decisions about improving your agent's knowledge base and system prompt.
</Tip>

***

## Accessing Analytics

Navigate to Analytics by selecting your agent from the sidebar and clicking on **Analytics** in the agent menu. You'll see an interactive dashboard with various metrics and visualizations.

***

## Key Metrics

The dashboard displays four primary metrics at the top:

| Metric                  | Description                                                                  |
| ----------------------- | ---------------------------------------------------------------------------- |
| **Total Conversations** | The total number of chat sessions with your agent during the selected period |
| **Total Messages**      | The combined count of all messages exchanged (visitor and agent messages)    |
| **Thumbs Up**           | Number of positive feedback responses from visitors                          |
| **Thumbs Down**         | Number of negative feedback responses from visitors                          |

<Note>
  Feedback metrics (thumbs up/down) help you gauge overall satisfaction. A high ratio of positive to negative feedback indicates your agent is providing helpful responses. Visitors rate responses using thumbs up and thumbs down buttons that appear on each agent message in the chat widget.
</Note>

### Understanding the Metrics

<AccordionGroup>
  <Accordion icon="comments" title="Total Conversations">
    Each conversation represents a unique chat session. A visitor opening the widget and sending messages counts as one conversation, regardless of how many times they return within the session.
  </Accordion>

  <Accordion icon="message" title="Total Messages">
    This counts every message in both directions. It includes visitor questions and agent responses. Higher message counts per conversation may indicate engaged users or complex queries requiring multiple exchanges.
  </Accordion>

  <Accordion icon="thumbs-up" title="Feedback Metrics">
    Visitors can rate agent responses with thumbs up or thumbs down. These ratings help you identify which responses are helpful and which need improvement.
  </Accordion>
</AccordionGroup>

***

## Date Range Selection

Use the date range picker in the top-right corner to analyze specific time periods:

* **Last 7 days** - Default view for recent trends
* **Last 30 days** - Monthly performance overview
* **Custom range** - Select specific start and end dates

<Tip>
  Compare different time periods to identify trends. For example, compare this week to last week to see if your recent knowledge base updates have improved engagement.
</Tip>

***

## Chats Over Time Chart

The interactive line chart shows conversation volume trends over your selected date range:

### What to Look For

| Pattern               | What It Means                                                            |
| --------------------- | ------------------------------------------------------------------------ |
| **Upward trend**      | Growing engagement with your agent                                       |
| **Spikes**            | Increased traffic, possibly from marketing campaigns or product launches |
| **Dips**              | Lower engagement periods (weekends, holidays)                            |
| **Consistent volume** | Stable, predictable usage                                                |

### Using the Chart

* **Hover** over data points to see exact conversation counts for each day
* **Identify patterns** such as weekly cycles or seasonal trends
* **Track growth** over time to measure the impact of improvements

***

## Geographic Distribution

The Chats by Country section shows where your visitors are located:

### World Map View

An interactive map displays chat distribution globally:

* **Hover** over countries to see chat counts
* **Identify** your primary markets
* **Discover** unexpected geographic interest

### Country Data Table

Below the map, a detailed table shows:

| Column      | Description                               |
| ----------- | ----------------------------------------- |
| **Country** | Visitor's geographic location             |
| **Chats**   | Number of conversations from that country |
| **Flag**    | Visual country identifier                 |

<Note>
  Geographic data helps you understand your audience. If you notice significant traffic from non-English speaking countries, consider adding localized content or enabling multiple languages.
</Note>

***

## Channel Distribution

See where conversations originate from:

| Channel              | Description                                             |
| -------------------- | ------------------------------------------------------- |
| **Widget or Iframe** | Visitors using the embedded chat widget on your website |
| **Playground**       | Test conversations from your agent's Playground         |
| **API**              | Conversations initiated through direct API integration  |

### Channel Insights

<AccordionGroup>
  <Accordion icon="desktop" title="Widget/Iframe dominance">
    Most conversations should come from your website widget - this indicates proper deployment and good visibility.
  </Accordion>

  <Accordion icon="flask" title="High Playground usage">
    Significant Playground traffic might indicate team members are actively testing and improving the agent.
  </Accordion>

  <Accordion icon="code" title="API traffic">
    API conversations show programmatic integration, useful for custom applications or third-party integrations.
  </Accordion>
</AccordionGroup>

***

## Top Pages

Track which pages on your website generate the most chat conversations:

| Column              | Description                                       |
| ------------------- | ------------------------------------------------- |
| **Page**            | The URL path where visitors started conversations |
| **Views**           | Total page views                                  |
| **Chats**           | Number of conversations started on that page      |
| **Conversion Rate** | Percentage of page views that resulted in a chat  |

### Using Page Data

* **High conversion pages** - These pages drive engagement; ensure the agent has excellent knowledge about topics on these pages
* **Low conversion pages** - Consider improving widget visibility or page content
* **High-traffic, low-chat pages** - May indicate visitors find the information they need without assistance

<Tip>
  Focus on improving agent knowledge for your highest-converting pages. If visitors frequently chat on your pricing page, make sure pricing information is thoroughly covered in your knowledge base.
</Tip>

***

## Workspace-Level Usage

Beyond individual agent analytics, you can view overall workspace usage:

1. Navigate to **Usage** in the main sidebar
2. View aggregated metrics across all agents in your workspace
3. Compare performance between different agents

<Note>
  Workspace usage analytics show combined activity for all agents. This is useful for tracking overall platform adoption and identifying your most active agents.
</Note>

<Note>
  GO credits are only consumed by explicit agent interactions — not by dashboard navigation or background processes. The Usage page shows per-event attribution so you can see exactly what consumed your credits.
</Note>

***

## Analyzing Performance

Use analytics data to continuously improve your agent:

### Weekly Review Process

<Steps>
  <Step title="Check key metrics">
    Review total conversations and feedback ratios. Are conversations increasing? Is feedback mostly positive?
  </Step>

  <Step title="Examine trends">
    Look at the chats over time chart for patterns. Any unexpected spikes or drops?
  </Step>

  <Step title="Review geographic data">
    Check if traffic is coming from expected regions. Consider localization if you see significant international traffic.
  </Step>

  <Step title="Analyze top pages">
    Identify high-converting pages and ensure your agent has strong knowledge coverage for those topics.
  </Step>

  <Step title="Take action">
    Based on your findings, update your knowledge base, refine your system prompt, or adjust widget placement.
  </Step>
</Steps>

### Improvement Strategies

Based on your analytics, consider these actions:

| Finding                       | Suggested Action                                                                                       |
| ----------------------------- | ------------------------------------------------------------------------------------------------------ |
| Low thumbs up ratio           | Review [Conversations](/agents/conversations) to identify problematic responses; update knowledge base |
| High traffic from new country | Add localized content; consider enabling that language                                                 |
| Spike on specific page        | Ensure comprehensive coverage of that page's topic in your sources                                     |
| Declining conversations       | Check widget visibility; review recent changes that may have affected engagement                       |

***

## Best Practices

<AccordionGroup>
  <Accordion icon="calendar" title="Monitor regularly">
    Check analytics weekly to catch issues early and track improvement trends.
  </Accordion>

  <Accordion icon="chart-mixed" title="Compare periods">
    Use date range selection to compare current performance against previous periods.
  </Accordion>

  <Accordion icon="bullseye" title="Set benchmarks">
    Establish baseline metrics for your agent and track progress over time.
  </Accordion>

  <Accordion icon="lightbulb" title="Act on insights">
    Analytics are only valuable if you use them. Make regular improvements based on what you learn.
  </Accordion>

  <Accordion icon="users" title="Share with your team">
    Share analytics insights with stakeholders to demonstrate ROI and gather input on improvements.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-exclamation" title="No analytics data showing">
    **Possible causes:**

    * Agent not yet deployed
    * No conversations have occurred yet
    * Date range doesn't include any activity

    **Solutions:**

    * Verify deployment in [Deployment](/agents/deployment) settings
    * Expand the date range to include more history
    * Test the agent through the widget to generate data
  </Accordion>

  <Accordion icon="clock" title="Data seems delayed">
    **Possible causes:**

    * Analytics processing time
    * Browser caching

    **Solutions:**

    * Allow a few minutes for new conversations to appear
    * Refresh the page to see the latest data
  </Accordion>

  <Accordion icon="map" title="Geographic data missing for some countries">
    **Possible causes:**

    * Visitors using VPN
    * Privacy settings blocking location

    **Note:** Some visitors may appear without location data due to privacy settings, which is normal.
  </Accordion>

  <Accordion icon="filter" title="Metrics don't match expectations">
    **Possible causes:**

    * Date range doesn't match expected period
    * Multiple agents in workspace

    **Solutions:**

    * Verify the selected date range
    * Ensure you're viewing the correct agent's analytics
  </Accordion>
</AccordionGroup>

***

## Receptionist Avatar & Voicebot Analytics

Receptionist Avatar and Voicebot channels have dedicated analytics pages with call-specific metrics:

| Metric               | Description                                    |
| -------------------- | ---------------------------------------------- |
| **Total Calls**      | Total number of calls handled by the agent     |
| **Answered**         | Calls that were successfully connected         |
| **Missed**           | Calls where no contact was reached             |
| **Average Duration** | Average call length across the selected period |
| **Answer Rate**      | Percentage of calls that were answered         |

Navigate to your Receptionist Avatar or Voicebot channel and click **Analytics** to access these metrics. Date range filtering is supported.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="View Conversations" icon="messages" href="/agents/conversations">
    Dive into individual chat sessions for detailed insights.
  </Card>

  <Card title="Improve Knowledge Base" icon="database" href="/sources/overview">
    Add content to address gaps identified in analytics.
  </Card>

  <Card title="Refine System Prompt" icon="flask" href="/agents/playground">
    Adjust your agent's behavior based on performance data.
  </Card>

  <Card title="Check Deployment" icon="rocket" href="/agents/deployment">
    Ensure your agent is properly deployed to maximize engagement.
  </Card>
</CardGroup>