Skip to main content
With Dub Analytics, you can track lead and sale conversions on your Framer site, enabling you to measure the effectiveness of your marketing campaigns. You can add the Dub Analytics script to your Framer website same way you would add Google Analytics script or any other JavaScript code. Follow these steps to add the script to your site:
  • Go to your Framer project and open the Project Settings menu.
  • Open the General tab and scroll down to the Custom Code section.
  • Paste the Dub analytics script in the Start of head tag section.
  • Click on the Save button to save the changes.
<script src="https://www.dubcdn.com/analytics/script.js" defer></script>
If you’re using Dub Partners for affiliate management, you will also need to set up the data-domains property to enable client-side click-tracking. 
<script
  src="https://www.dubcdn.com/analytics/script.js"
  defer
  data-domains='{"refer":"yourcompany.link"}' // replace with your referral link domain on Dub
></script>
Read the client-side click-tracking guide for more information.
You can verify the installation with the following tests:
  1. Open the browser console and type in _dubAnalytics – if the script is installed correctly, you should see the _dubAnalytics object in the console.
  2. Add the ?dub_id=test query parameter to your website URL and make sure that the dub_id cookie is being set in your browser.
If both of these checks pass, the script is installed correctly. Otherwise, please make sure:
  • The analytics script was added to the <head> section of the page
  • If you’re using a content delivery network (CDN), make sure to purge any cached content

​
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.
​
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-params
string[]
default:"[\"via\"]"
An array of query parameters to listen to for client-side click-tracking (e.g. ?via=abc123).