Skip to main content

Extensions Tracking

The Extensions section allows you to monitor and analyze your browser extensions (Chrome, Firefox, Edge) with comprehensive tracking, user engagement metrics, and performance analytics.

Adding Your First Extension

Basic Extension Setup

  1. Navigate to Extensions: Click on the “Extensions” tab in your dashboard
  2. Click “Add Extension”: Use the prominent button to start adding
  3. Select Browser: Choose your target browser platform
  4. Enter Extension Details:
    • Extension Name: Your extension’s display name
    • Extension ID: Unique identifier from the browser store
    • Store URL: Link to your extension in the browser store
    • Description: Brief description of your extension

Browser-Specific Configuration

For Chrome Web Store extensions:
  • Extension ID: Found in your Chrome Web Store dashboard
  • Manifest Version: V2 or V3 compatibility
  • Permissions: Required permissions for tracking
  • Content Scripts: Scripts that run on web pages
For Firefox Add-ons:
  • Add-on ID: Found in your Firefox Add-ons dashboard
  • Manifest Version: V2 or V3 compatibility
  • Permissions: Required permissions for tracking
  • Background Scripts: Service worker scripts
For Microsoft Edge extensions:
  • Extension ID: Found in your Edge Add-ons dashboard
  • Manifest Version: V2 or V3 compatibility
  • Permissions: Required permissions for tracking
  • Content Scripts: Scripts that run on web pages

Extension Performance Metrics

User Acquisition

Track how users discover and install your extension:
  • Installs: Total number of extension installations
  • Active Users: Users who actively use your extension
  • Store Performance: Ratings, reviews, and store visibility
  • Geographic Distribution: Where your users are located
  • Browser Distribution: Chrome vs Firefox vs Edge usage

User Engagement

Monitor how users interact with your extension:
  • Daily Active Users (DAU): Users active in the last 24 hours
  • Monthly Active Users (MAU): Users active in the last 30 days
  • Session Duration: How long users stay engaged
  • Feature Usage: Which extension features are most popular
  • User Retention: Percentage of users who continue using

Performance Analytics

User Behavior

Track how users interact with your extension

Feature Adoption

Monitor which features users adopt

Performance Metrics

Track extension speed and responsiveness

Error Tracking

Identify and fix extension issues

Extension Development Integration

Manifest Configuration

Configure your extension for tracking:
{
  "manifest_version": 3,
  "name": "Your Extension Name",
  "version": "1.0.0",
  "permissions": [
    "storage",
    "activeTab"
  ],
  "content_scripts": [
    {
      "matches": ["<all_urls>"],
      "js": ["content.js"]
    }
  ],
  "background": {
    "service_worker": "background.js"
  }
}

SDK Integration

Integrate the Inhouse SDK into your extension:
// content.js
import { Inhouse } from '@inhouse/extension';

// Initialize the SDK
Inhouse.init({
  apiKey: 'YOUR_API_KEY',
  extensionId: 'YOUR_EXTENSION_ID'
});

// Track user actions
Inhouse.track('button_click', {
  button: 'save',
  page: window.location.href
});

// Track page views
Inhouse.track('page_view', {
  url: window.location.href,
  title: document.title
});

Background Script Integration

// background.js
import { Inhouse } from '@inhouse/extension';

// Initialize background tracking
Inhouse.init({
  apiKey: 'YOUR_API_KEY',
  extensionId: 'YOUR_EXTENSION_ID'
});

// Track extension events
chrome.runtime.onInstalled.addListener(() => {
  Inhouse.track('extension_installed');
});

chrome.runtime.onStartup.addListener(() => {
  Inhouse.track('extension_started');
});

User Experience Tracking

Page Interaction

Monitor how users interact with web pages through your extension:
  • Button Clicks: Track user interactions with page elements
  • Form Submissions: Monitor form completion rates
  • Page Navigation: Track user browsing patterns
  • Content Engagement: Measure time spent on content

Extension Features

Track usage of your extension’s features:
  • Toolbar Actions: Monitor toolbar button usage
  • Context Menu: Track right-click menu usage
  • Keyboard Shortcuts: Monitor shortcut key usage
  • Settings Changes: Track configuration modifications

Store Optimization

Chrome Web Store

Optimize your Chrome extension listing:
  • Extension Title: Include relevant keywords
  • Description: Clear, compelling description
  • Screenshots: High-quality visuals of your extension
  • Promotional Images: Eye-catching promotional graphics
  • Keywords: Strategic keyword placement

Firefox Add-ons

Optimize your Firefox add-on listing:
  • Add-on Name: Include relevant keywords
  • Summary: Concise feature summary
  • Description: Detailed feature description
  • Screenshots: Visual examples of functionality
  • Categories: Choose relevant add-on categories

Analytics Dashboard

Real-time Monitoring

  • Live User Count: See active users in real-time
  • Live Events: Monitor user actions as they happen
  • Performance Alerts: Get notified of extension issues
  • Geographic Heatmap: Visualize user distribution

Custom Reports

Create personalized analytics views:
  • Developer View: Focus on technical metrics and errors
  • Product View: Monitor user engagement and feature usage
  • Marketing View: Track acquisition and retention metrics
  • Executive View: High-level business metrics and KPIs

Privacy and Compliance

Data Collection

Ensure responsible data collection:
  • Minimal Data: Only collect essential analytics data
  • User Consent: Implement proper consent mechanisms
  • Data Anonymization: Anonymize user data when possible
  • GDPR Compliance: Follow European privacy regulations

Security Measures

Protect user data and privacy:
  • Secure Transmission: Use HTTPS for all data transmission
  • Data Encryption: Encrypt sensitive data at rest
  • Access Controls: Limit access to user data
  • Regular Audits: Conduct regular security reviews

Troubleshooting

Common Issues

  • Check manifest.json configuration
  • Verify permissions are correct
  • Test in incognito/private mode
  • Check browser console for errors
  • Review extension onboarding
  • Analyze user drop-off points
  • Test extension performance
  • Gather user feedback
  • Check API key configuration
  • Verify extension ID setup
  • Review SDK version compatibility
  • Check network connectivity

Best Practices

Extension Development

  1. Performance First: Ensure your extension doesn’t slow down browsing
  2. User Privacy: Respect user privacy and data preferences
  3. Clear Permissions: Only request necessary permissions
  4. Regular Updates: Keep your extension updated and maintained

Analytics Implementation

  1. Efficient Tracking: Use lightweight tracking methods
  2. Meaningful Events: Track events that provide actionable insights
  3. User Segmentation: Group users by behavior and characteristics
  4. A/B Testing: Test different features and configurations

Next Steps

Customer Insights

Track customer relationships and conversions.

Settings

Configure extension settings and team access.

API Reference

Integrate extension tracking into your workflows.

SDK Documentation

Get started with our official SDKs.
Need help with extension tracking? Check our API documentation or contact [email protected].