Skip to Content
Developer DocsWeb installationServer-side tracking (recommended)

// snippet import removed // snippet import removed // snippet import removed // snippet import removed // snippet import removed // snippet import removed

💡

This feature is only available on Business plans and above .

Dub’s powerful attribution platform lets you understand how well your links are translating to actual users and revenue dollars.

Conversion analytics

In this guide, we’ll learn how to track conversion events with Dub using server-side tracking.

📝

The recommended way to track conversions on Dub is using server-side tracking, which is more reliable than client-side tracking.

Step 2: Install the Dub Analytics script

Next, you’ll need to install the Dub Analytics script.

This script detects 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

Step 3: Install the Dub server-side SDK

Depending on which framework you’re using, you can use our native SDKs to track conversion events:

📦

TypeScript

TypeScript library for the Dub API

golang

Go

Go library for the Dub API

python

Python

Python library for the Dub API

gem

Ruby

Ruby library for the Dub API

php

PHP

PHP library for the Dub API

If you’re using a framework that isn’t listed, you can use the Dub REST API to track events on the server-side:

Step 4: Track conversion events

Now comes the fun part – tracking conversion events.

Tracking lead events

The first event you’ll want to track is a lead event. This happens when a user performs an action that indicates interest in your product or service. This could be anything from:

  • Signing up for an account
  • Adding a product to cart
  • Joining a mailing list

A diagram showing how lead events are tracked in the conversion funnel

Our most common lead event is Sign Up, which happens when a user signs up for an account. Depending on which authentication framework you’re using, here are a few examples of how to send Sign Up lead events:

The lead event will serve as the source of truth for the customer’s identity and which link they came from. This means that all subsequent actions performed by the customer (e.g. upgrading their plan, purchasing a product) will automatically be attributed to the original link.

Tracking sale events

The second event you’ll want to send is a sale event. This happens when a user purchases your product or service. This could be anything from:

  • Subscribing to a paid plan
  • Usage expansion (upgrading from one plan to another)
  • Purchasing a product

A diagram showing how sale events are tracked in the conversion funnel

Depending on which payment processor you’re using, we offer native integrations for the following:

💳

Stripe

🛒

Shopify

Alternatively, you can also send sale events manually using our SDKs or the POST /track/sale API endpoint.

💡

Looking to track sales without a prior lead event? Check out our direct sale tracking guide.

Looking to track refunds? Check out our refunds tracking guide.

Step 5: View your conversions

Once you’ve enabled conversion tracking for your links, all your tracked conversions will show up on your Analytics dashboard . We provide 3 different views to help you understand your conversions:

Example Apps