@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.
A diagram showing how click events are tracked in the conversion funnel
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:
​
data-api-host
url
default:"https://api.dub.co"
The base URL for the Dub API. This is useful for setting up reverse proxies to avoid adblockers.
​
data-attribution-model
first-click | last-click
default:"last-click"
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.
​
data-cookie-options
JSON-stringified object
Custom properties to pass to the cookie. Refer to MDN’s Set-Cookie documentation for all available options.
​
data-domains
JSON-stringified object
Configure the domains that Dub will track. The following properties are available:
​
data-query-param
string
default:"via"
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:

Dub Analytics with Client-side Click Tracking + Reverse Proxy

See the full example on GitHub.

Dub Analytics with Geolocation

See the full example on GitHub.