Install attribution

Add the website SDK to your landing and welcome pages using the same project ID as your extension. For the initial release, the landing page and welcome page must share an origin. The website SDK records acquisition details, such as supported UTM parameters and the referring website. When someone installs your extension, the extension records the install and opens your welcome page. Call this method on that page:

import { analytics } from "@crxbase/analytics/web";

analytics.init({ projectId: "YOUR_PROJECT_ID" });
await analytics.attributeInstall();

Attribution uses the most recent eligible campaign or external referrer within 30 days of installation. The supported parameters are utm_source, utm_medium, utm_campaign, utm_content, and utm_term. A new campaign or external referrer replaces the previous source. A direct return keeps an existing eligible source without extending its window. If no website history is available, the install remains unattributed. If the welcome page doesn’t open or the attribution cannot be delivered, the install may still appear without a source. The website SDK retries failed attribution delivery when possible.

Get started

Track and identify

Understand your data

Reference

Install attribution