Manual Installation

With @dub/analytics, you can track lead and sale conversions on your website, enabling you to measure the effectiveness of your marketing campaigns.

You can add the @dub/analytics script to your website same way you would add Google Analytics script or any other JavaScript code – by adding the @dub/analytics script in the <head> section of your HTML file.

<script src="https://www.dubcdn.com/analytics/script.js" defer />

Concepts

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.

domain

string

Specifies the value for the Domain Set-Cookie attribute. This is useful for cross-domain tracking. Example: .example.com

expires

integer

default:

"90"

Specifies the Date object to be the value for the Expires Set-Cookie attribute. Example: new Date('2024-12-31')

expiresInDays

integer

default:

"90"

Specifies the number (in days) to be the value for the Expires Set-Cookie attribute.

For example, to set the cookie window to 60 days (instead of the default 90 days), you can add the following to your script:

<script
  src="https://www.dubcdn.com/analytics/script.js"
  defer
  data-cookie-options='{"expiresInDays": 60}'
/>

path

string

default:

"/"

Specifies the value for the Path Set-Cookie attribute. By default, the path is considered the “default path”. Example: /

data-short-domain

string

The short domain you’re using on Dub for your short links. For security purposes, this must be a subdomain of your website’s domain. E.g. if your website domain is example.com, your short domain should be something like go.example.com.

data-query-param

string

default:

"via"

The query parameter to listen to for client-side click-tracking (e.g. ?via=abc123).

SDKs

Quickstarts

Client-side SDKs

CLI

Concepts

SDKs

Quickstarts

Client-side SDKs

CLI

​Concepts

Concepts