The Analytics dashboard gives you insights into how users interact with your agent, helping you identify opportunities to improve responses and increase engagement.
Accessing Analytics
- Go to Agents in the sidebar
- Select your agent
- Click Analytics in the agent menu
Overview Metrics
The summary section shows key performance indicators:
| Metric | Description |
|---|
| Total Conversations | Number of chat sessions |
| Total Messages | All messages exchanged |
| Avg Messages/Conversation | Engagement depth |
| Thumbs Up | Positive feedback count |
| Thumbs Down | Negative feedback count |
| Feedback Ratio | Positive / total feedback % |
Date Range
Filter analytics by time period:
- Last 7 days — Recent performance
- Last 30 days — Monthly trends
- Last 90 days — Quarterly view
- Custom range — Select specific dates
Daily Trends
The daily chart shows:
- Conversations — Chat sessions per day
- Messages — Total messages per day
- Feedback — Thumbs up/down per day
Use this to identify:
- Peak usage times
- Trends over time
- Impact of changes you make
Channel Breakdown
See where conversations originate:
| Channel | Description |
|---|
| Widget | Embedded chat on your website |
| API | Programmatic API calls |
| Test | Dashboard test conversations |
Geographic Distribution
View conversations by country to understand your audience:
- See which regions use your agent most
- Identify localization opportunities
- Understand timezone patterns
Track how your tools are performing:
| Metric | Description |
|---|
| Execution Count | Times the tool was called |
| Success Count | Successful executions |
| Failure Count | Failed executions |
| Success Rate | Success percentage |
| Avg Execution Time | Average response time (ms) |
Identifying Issues
- Low success rate — Check API credentials, endpoint availability
- High execution time — Optimize external API or add caching
- Low usage — Improve tool description or agent prompts
For form tools, track the conversion funnel:
| Metric | Description |
|---|
| Impressions | Times form was shown |
| Started | Users who began filling |
| Submitted | Completed submissions |
| Conversion Rate | Submitted / Impressions |
| Completion Rate | Submitted / Started |
Field-Level Analysis
See which fields have the highest drop-off:
| Field | Completion Rate |
|---|
| Email | 98% |
| Name | 95% |
| Phone | 45% |
| Message | 85% |
High drop-off on a field? Consider making it optional or moving it later in the form.
Trigger Analytics
Measure automation effectiveness:
| Metric | Description |
|---|
| Fired | Times trigger activated |
| Converted | User engaged after trigger |
| Conversion Rate | Engaged / Fired |
Feedback Analysis
User feedback helps identify areas for improvement:
Viewing Feedback
- Go to Conversations
- Filter by Has Feedback
- Review conversations with thumbs down
Common Issues
- Wrong answers — Update knowledge base
- Missing information — Add relevant documents
- Tool failures — Check tool configuration
- Tone issues — Adjust system prompt
Exporting Data
Export analytics data for external analysis:
- Select date range
- Click Export button
- Choose format (CSV or JSON)
Best Practices
Weekly Review
- Check feedback ratio trend
- Review negative feedback conversations
- Identify top-performing tools
- Monitor form conversion rates
Monthly Analysis
- Compare month-over-month trends
- Analyze geographic patterns
- Review tool success rates
- Assess trigger effectiveness
Continuous Improvement
-
Low feedback ratio?
- Review negative feedback conversations
- Update knowledge base with missing info
- Improve system prompt clarity
-
Declining conversations?
- Check widget installation
- Review trigger configurations
- Assess content freshness
-
Poor form conversion?
- Simplify form fields
- Improve form timing (triggers)
- Add better context/descriptions
-
Tool failures increasing?
- Check external API status
- Verify credentials
- Review error logs
API Access
Access analytics programmatically:
# Get summary metrics
curl "https://api.ansa.so/analytics/summary?agentId=xxx&startDate=2024-12-01" \
-H "Authorization: Bearer $ANSA_API_KEY"
# Get daily data
curl "https://api.ansa.so/analytics/daily?agentId=xxx" \
-H "Authorization: Bearer $ANSA_API_KEY"
# Get channel breakdown
curl "https://api.ansa.so/analytics/channels?agentId=xxx" \
-H "Authorization: Bearer $ANSA_API_KEY"
# Get country data
curl "https://api.ansa.so/analytics/countries?agentId=xxx" \
-H "Authorization: Bearer $ANSA_API_KEY"
# Get tool performance
curl "https://api.ansa.so/analytics/tools?agentId=xxx" \
-H "Authorization: Bearer $ANSA_API_KEY"
Next Steps
