Dub Destination Setup Guide Beta

Set up Dub as a destination in RudderStack.

  •   3 minute read  

This guide will help you set up Dub as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Dub.

Connection compatibility

Destination Information
  • Status: Beta
  • Supported sources: Android, iOS , Web, Unity, AMP , Cloud, React Native , Flutter, Cordova, Shopify
  • Refer to it as DUB in the Integrations object.
Connection Modes
SourceCloud modeDevice modeHybrid mode
AMPsupportednot supportednot supported
Androidsupportednot supportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportednot supportednot supported
iOSsupportednot supportednot supported
React Nativesupportednot supportednot supported
Shopifysupportednot supportednot supported
Unitysupportednot supportednot supported
Websupportednot supportednot supported
Supported Message Types
SourceIdentifyPageTrackScreenGroupAliasRecord
Cloud mode
Supported sourcesnot supportednot supportedsupportednot supportednot supportednot supportednot supported

Setup

  1. In your RudderStack dashboard, set up a source.
  2. Go to the Overview tab of your source and select Add Destination > Create new destination.
Add new destination in RudderStack dashboard
  1. Select Dub from the list of destinations. Then, click Continue.

Connection settings

Setting
Description
NameAssign a name to uniquely identify the destination in RudderStack.
API key
Required		Your Dub API key used for authentication. It must follow the format dub_ followed by alphanumeric characters.

warning
Note that:

  • Your Dub API key must have the relevant permissions to create conversion events.
  • Make sure to secure your API key — anyone with access to this key can send conversion events to your Dub account.
Convert amount to centsThis setting is toggled on by default. When enabled, RudderStack multiplies monetary amounts by 100 before sending them to Dub, thereby converting dollars to cents as required by Dub’s API.

If this setting is disabled, RudderStack sends the specified amount value as is, without any conversion.

See the Dub documentation for more information on currency conversion support.

Configuration settings

Setting
Description
Event mappingsMap your RudderStack events to Dub’s LEAD_CONVERSION or SALES_CONVERSION events.

warning
To successfully deliver events to Dub, you must:

  • Configure the event mappings via this setting
  • Include the clickId parameter in those events.
See the Cloud Mode Integration guide for detailed mapping instructions.
Consent management settingsConfigure the consent management settings for the specified source by choosing the Consent management provider from the dropdown and entering the relevant consent category IDs.

See Consent Management in RudderStack for more information on this feature.

info
When consent management is enabled, RudderStack only sends events to Dub when the user has provided appropriate consent.

Next steps

After setting up your Dub destination in RudderStack:

  • See the Dub Cloud Mode Integration guide to understand how RudderStack maps and sends events to Dub
  • Send test events to verify your setup is working correctly
  • See the detailed FAQ guide for answers to the commonly asked questions on this integration

FAQ

Where can I find my Dub API key?

  1. Log in to your Dub dashboard.
  2. Click the profile in the left sidebar to see Settings.
Dub API Key Links
  1. Go to the API Keys section and copy your API key — it should start with dub_ followed by alphanumeric characters.
Dub API Key Links

Questions? Contact us by Email or on Slack