Usage Analytics

This document explains how to use the analytics features in the InsightEmbed Management Portal to track and understand how visitors are using the widget on your website.

Analytics Overview

The Usage Analytics dashboard provides comprehensive insights into how your InsightEmbed widget is being used. These analytics help you understand user engagement, optimize widget placement, and make data-driven decisions about your content strategy.

Accessing Analytics

To access the Usage Analytics dashboard:

1. Log in to the InsightEmbed Management Portal
2. Navigate to Analytics in the main navigation menu
3. The dashboard will load with your usage data

Dashboard Sections

Usage Summary

The Usage Summary section provides a high-level overview of your widget usage:

Metric	Description
Total Analyses	Total number of content analyses performed
Active Users	Number of unique users who have used the widget
Avg. Analyses per User	Average number of analyses performed per user
Quota Usage	Percentage of your monthly quota used
Remaining Analyses	Number of analyses remaining in your quota

Usage Trends

The Usage Trends chart displays your widget usage over time, allowing you to identify patterns and trends:

• Time Range: Select from predefined ranges (Today, Last 7 Days, Last 30 Days, Last 90 Days) or set a custom date range
• Granularity: View data by hour, day, week, or month
• Metrics: Toggle between total analyses, unique users, or both

Analysis Types

The Analysis Types section breaks down usage by the type of analysis performed:

• Text Analysis: Content analyzed through text selection or direct input
• Image Analysis: Images analyzed through the widget
• Screenshot Analysis: Screenshots captured and analyzed through the widget

This data is presented as both a pie chart and a detailed table with counts and percentages.

Top Pages

The Top Pages section shows which pages on your website have the highest widget usage:

Column	Description
Page URL	The URL of the page
Analyses	Number of analyses performed on this page
Users	Number of unique users who used the widget on this page
Avg. Time on Page	Average time users spent on the page before using the widget

This data helps you understand which content drives the most engagement with the widget.

User Demographics

The User Demographics section provides information about the users interacting with your widget:

Device Types

Breakdown of widget usage by device type:

• Desktop
• Mobile
• Tablet

Browsers

Breakdown of widget usage by browser:

• Chrome
• Firefox
• Safari
• Edge
• Others

Countries

Geographic distribution of widget usage, displayed as both a map visualization and a table of top countries.

Advanced Analytics

Engagement Metrics

The Engagement Metrics section provides deeper insights into how users interact with the widget:

Metric	Description
Avg. Session Duration	Average time users spend interacting with the widget
Bounce Rate	Percentage of users who open the widget but don't perform an analysis
Repeat Usage Rate	Percentage of users who use the widget multiple times
Completion Rate	Percentage of started analyses that are completed

Content Insights

The Content Insights section analyzes the content being processed by the widget:

• Popular Topics: Common themes and topics in analyzed content
• Content Length: Distribution of content length being analyzed
• Query Types: Types of prompts and questions users are asking

Filtering and Segmentation

You can filter and segment your analytics data using various criteria:

• Date Range: Customize the time period for your analysis
• Domains: Filter by specific domains if you have the widget installed on multiple sites
• Pages: Filter by specific pages or page patterns
• Device Types: Filter by desktop, mobile, or tablet
• Analysis Types: Filter by text, image, or screenshot analysis

To apply filters:

1. Click the Filter button at the top of the dashboard
2. Select your desired filters in the filter panel
3. Click Apply Filters to update the dashboard

Exporting Data

You can export analytics data for further analysis or reporting:

1. Navigate to the section you want to export
2. Click the Export button (usually represented by a download icon)
3. Select your preferred format (CSV, Excel, or PDF)
4. The file will be downloaded to your device

Setting Up Custom Events

You can track custom events to gain more specific insights into how users interact with your widget:

1. Go to Settings > Analytics in the Management Portal
2. Click Add Custom Event
3. Configure your event with the following options:
   • Event Name: A descriptive name for your event
   • Event Trigger: When the event should be recorded
   • Properties: Additional data to capture with the event
4. Click Save Event

Once configured, custom events will appear in your analytics dashboard.

Analytics API

For programmatic access to your analytics data, you can use the Analytics API:

curl -X GET https://api.insightembed.com/v1/analytics/summary \
  -H "Authorization: Bearer YOUR_API_KEY"

For more information about the Analytics API, see the API Reference.

Best Practices

1. Regular Monitoring: Check your analytics dashboard regularly to identify trends and patterns

2. Compare Time Periods: Use the comparison feature to see how metrics change over time

3. Segment Your Data: Use filters to gain insights into specific user segments

4. Act on Insights: Use analytics data to optimize widget placement, content strategy, and user experience

5. Export for Reporting: Export data regularly for team reporting and analysis

Troubleshooting

Missing Data

If you notice missing data in your analytics:

1. Check that the widget is properly installed on all pages
2. Verify that there are no JavaScript errors preventing the widget from loading
3. Ensure that your users' browsers are not blocking the analytics tracking
4. Check if any ad blockers might be interfering with the tracking

Discrepancies in Data

If you notice discrepancies between your analytics and actual usage:

1. Check for any filters that might be excluding certain data
2. Verify the date range is set correctly
3. Consider time zone differences that might affect the data
4. Contact support if discrepancies persist

Privacy Considerations

InsightEmbed analytics are designed with privacy in mind:

• No personally identifiable information (PII) is collected by default
• IP addresses are anonymized
• All data collection complies with GDPR, CCPA, and other privacy regulations
• Users can opt out of analytics tracking through your privacy settings

For more information about privacy, see the Privacy Policy.