Dub Conversions Overview

Data is the lifeblood of any business. It helps you understand your customers, make data-driven decisions, and drive growth.

Whenever you run a marketing campaign, merely tracking link clicks is not sufficient to paint a complete picture of your customer acquisition funnel.

You need to track how those clicks are converting to signups & sales to be able to determine which campaigns/channels are performing the best.

This is where Dub Conversions comes in.

With Dub Conversions, you can turn any short link you create on Dub into a full attribution engine. This allows you to understand how well your links are translating to actual users and revenue dollars.

How does Dub Conversions work?

The way conversion tracking on Dub works can be boiled down to 3 simple steps:

With this 3-step process, marketing teams can make better decisions about which content or marketing efforts to invest more in – backed by real-world conversion data.

How are conversions tracked?

Dub Conversions uses a simple first-party cookie and server-side event tracking to track conversions.

Step 1: Storing click ID as a first-party cookie

When a user clicks on a conversion-enabled link, Dub generates a unique dub_id query parameter and stores it as a first-party cookie on your domain (e.g. .dub.co).

This allows Dub to attribute any subsequent conversion events to the original click – and by extension, the link that was clicked on.

To enable this, you need to install the @dub/analytics package in your project.

This package will handle the detection of the dub_id query parameter and storing it as a first-party cookie.

Step 2: Attributing conversion events to the original click

Then, when a conversion event occurs (e.g. a user signs up for an account), you can check for the dub_id cookie and attribute the conversion to the original click.

For example, if you're using a Next.js app with NextAuth for authentication, here's how you can send lead conversion events for new user signups.

When sending a lead conversion event, you can include the following properties:

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.

Step 3: Sending sale events

The final step in the conversion funnel is to track sale events and attribute them to the original link click. This can be done in 2 ways:

Option 1: Stripe integration (recommended)

At Dub, we have a native Stripe integration that you can set up in 2-3 clicks and automatically send sale events to Dub.

The way the integration works is as follows:

1. Connect your Stripe account to your Dub workspace (read-only access).
2. When a user creates a checkout session on your app, pass the user's unique ID in your system as the dubCustomerId property in the metadata field.
3. This way, when the user completes their checkout session, Dub will receive a webhook from Stripe containing the dubCustomerId.
4. If the dubCustomerId matches a customer that came from a conversion-enabled link, Dub will track the sale as a result of that link.

Option 2: Manually sending sale events

Alternatively, if you prefer to send sale events manually, you can do so using our server-side SDKs.

We expose a POST /track/sale endpoint that you can use to send sale events to Dub. Here's an example using the Dub TypeScript SDK:

import { Dub } from "dub";
 
const dub = new Dub();
 
await dub.track.sale({
  customerId: "123",
  amount: 5900, // in cents
  paymentProcessor: "stripe",
  eventName: "Subscription creation",
});

Here are the properties you can include when sending a sale event:

How do I see the conversions?

All your tracked conversions will show up on your Analytics dashboard. We provide 3 different views to help you understand your conversions:

• Time-series: A time-series view of the number clicks, leads and sales.

• Funnel chart: A funnel chart view visualizing the conversion & dropoff rates across the different steps in the conversion funnel (clicks → leads → sales).

• Real-time events stream: A real-time events stream of every single conversion event that occurs across all your links in your workspace.

What can I build with Dub Conversions?

There are various use cases for Dub Conversions. Here are a few examples:

• White-labeled affiliate/referral programs: You can use Dub Conversions to track how well your affiliate/referral links are performing and display the real-time analytics directly inside your application – using our Analytics API.
• Paid ads attribution tracking: Dub Conversions lets you understand the performance of your ads – not just the number of clicks, but also the number of signups and upgrades. You can then use the data to make data-driven decisions about which ads to spend on and where to allocate your budget.
• Tracking product-led growth: By integrating Dub Conversions into your product, you can measure how many new users (and upgrades) each existing user brings in – also known as the app's K-factor or the "viral coefficient formula".

Getting started with Dub Conversions

To get started with Dub Conversions, check out our quickstart guide.

View guide ↗