@dub/analytics
is a lightweight (~1kb), open-source client-side script for tracking conversion events with Dub.
The script handles the detection of the dub_id
query parameter and storing it as a first-party cookie, which will be used to attribute subsequent conversion events to the original link.

?via=john
). This gives you the flexibility to track clicks directly on your website or app, without needing to rely on link redirects.
Installation guides
You can install the@dub/analytics
script in several different ways:
React
Add Dub Analytics to your React app
Manual installation
Add Dub Analytics to your website
Google Tag Manager
Add Dub Analytics via GTM
Framer
Add Dub Analytics to your Framer site
Shopify
Add Dub Analytics to your Shopify store
WordPress
Add Dub Analytics to your WP site
Webflow
Add Dub Analytics to your Webflow site
Features
The@dub/analytics
script comes with the following features:
Properties
You can pass the following props to the@dub/analytics
script to customize its behavior:
The base URL for the Dub API. This is useful for setting up reverse
proxies to avoid
adblockers.
The attribution model to use for the analytics event. The following
attribution models are available:
first-click
: The first click model gives all the credit to the first touchpoint in the customer journey.last-click
: The last click model gives all the credit to the last touchpoint in the customer journey.
Custom properties to pass to the cookie. Refer to
MDN’s Set-Cookie documentation for
all available options.
Configure the domains that Dub will track. The following properties are available:
The query parameter to listen to for client-side click-tracking (e.g.
?via=abc123
).