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

You can add the @dub/analytics script to your WordPress website same way you would add Google Analytics script or any other JavaScript code.

Follow these steps to add the script to your site:

  • On your WordPress dashboard, navigate to the Theme Editor section under the Appearance menu.
  • Open the Theme Header (header.php) file on the right column.
  • Paste the Dub analytics script in the header area.
  • Click on the Update File 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'}"
/>

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.

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