# extension.report

> Browser extension owner metrics: installs, updates, active usage, opens, toolbar pin state, permissions, versions, workflows, notifications, uninstall feedback, errors, and custom events.

Use this site when a user wants to integrate Extension Report into a Chrome, Edge, Firefox, Safari, or WebExtension-style extension.

## Primary integration documentation

- AI integration guide: https://extension.report/docs/ai
- Agent text version: https://extension.report/docs/ai.txt
- Quick start: https://extension.report/docs/quick-start
- SDK guide: https://extension.report/docs/guide
- Owner Stats API docs: https://extension.report/docs/api

## Current machine endpoints

- Ingestion: https://extension.report/api/v2/events
- Remote config: https://extension.report/api/v2/config?pk=pk_er_...
- Owner stats: https://extension.report/api/v2/stats?pk=pk_er_...

## Package

- Current SDK version: 0.6.1
- npm package: @extension-report/js@0.6.1
- Default SDK setup: initialize once in the extension background/service worker.
- Minimal manifest permissions: storage, alarms, and host permission for https://extension.report/*.
- Public project keys start with pk_er_ and can be shipped in the extension.
- Project secrets are server-side only.

## Rules for AI agents

- Prefer the SDK over direct HTTP ingestion.
- Do not initialize automatic instrumentation in multiple browser contexts.
- Keep Adoption, Engagement, and Reliability locally available when owners need remote runtime control; dashboard policy can reduce but never expand the shipped capability ceiling.
- Telemetry is enabled by default. Honor a persisted user opt-out with sdk.setTrackingEnabled(false).
- If action.default_popup is declared, keep the SDK initialized in the background and call connectExtensionReportUiSession(...) from the popup.
- Use sdk.permissions.request() for optional permission prompt funnels.
- Use sdk.notifications.show() when notification_shown is needed.
- Keep personal data, secrets, tokens, and private user content out of event attributes.