Analytics

​

Accessing Analytics

1. Go to Agents in the sidebar
2. Select your agent
3. Click Analytics in the agent menu

​

Overview Metrics

​

Date Range

• Last 7 days — Recent performance
• Last 30 days — Monthly trends
• Last 90 days — Quarterly view
• Custom range — Select specific dates

​

Daily Trends

• Conversations — Chat sessions per day
• Messages — Total messages per day
• Feedback — Thumbs up/down per day

• Peak usage times
• Trends over time
• Impact of changes you make

​

Channel Breakdown

​

Geographic Distribution

• See which regions use your agent most
• Identify localization opportunities
• Understand timezone patterns

​

Tool Performance

​

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

​

Form Analytics

​

Field-Level Analysis

​

Trigger Analytics

​

Feedback Analysis

​

Viewing Feedback

1. Go to Conversations
2. Filter by Has Feedback
3. 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

1. Select date range
2. Click Export button
3. Choose format (CSV or JSON)

​

Best Practices

​

Weekly Review

1. Check feedback ratio trend
2. Review negative feedback conversations
3. Identify top-performing tools
4. Monitor form conversion rates

​

Monthly Analysis

1. Compare month-over-month trends
2. Analyze geographic patterns
3. Review tool success rates
4. Assess trigger effectiveness

​

Continuous Improvement

1. Low feedback ratio?
   • Review negative feedback conversations
   • Update knowledge base with missing info
   • Improve system prompt clarity
2. Declining conversations?
   • Check widget installation
   • Review trigger configurations
   • Assess content freshness
3. Poor form conversion?
   • Simplify form fields
   • Improve form timing (triggers)
   • Add better context/descriptions
4. Tool failures increasing?
   • Check external API status
   • Verify credentials
   • Review error logs

​

API Access

# 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