@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:

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.
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: