Introduction
Learn more about the @dub/analytics script and how to install it.
@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.
If you’re using Dub Partners, this script also lets you track clicks on the client-side using query parameters (e.g. ?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
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
).
Open-source examples
Here are some open-source code examples that you can referece: