Migrating from FirstPromoter

FirstPromoter is a practical option for companies just starting out with their affiliate programs.

Over time, companies outgrow FirstPromoter's basic features and look for more advanced solutions to overcome some limitations, including:

1. Frequent payout failures: FirstPromoter supports multiple payout methods. PayPal and Wise mass payments are manual and often result in payout failures. Companies must handle tax compliance themselves, which becomes time-consuming as their affiliate base grows. FirstPromoter also offers 1-click global payouts, but this feature is only available on their Enterprise 2 plan or higher.
2. No affiliate network: Since FirstPromoter doesn't offer an affiliate network, companies have to recruit affiliates on their own.
3. Basic reward structures: Companies can choose between two reward types: recurring or one-time sales rewards.

With Dub Partners, scaling affiliate programs is seamless.

1. Payouts you can rely on: We let you pay your partners globally in 1-click, with tax compliance built-in, so you can have peace of mind knowing that all payouts are completed successfully.
2. Powerful affiliate network: With over 5,000 active affiliates in our network, Dub makes it easy to find and recruit high-performing partners with a proven track record of driving results.
3. Advanced reward structures: On Dub, you can choose between 3 reward types – per click, per lead, and per sale (flat/percentage). You can also set different reward conditions (e.g., a higher reward for customers based in the U.S. vs other countries) and create bounties to provide additional rewards for your affiliates.

In this article, we'll learn how to import your FirstPromoter affiliate program to Dub Partners for a more powerful and scalable partner management experience.

How to migrate from FirstPromoter to Dub?

If you're looking to migrate from FirstPromoter to Dub Partners, we've built a custom migration tool that will help you migrate everything over in just 2-3 clicks – without breaking any existing FirstPromoter affiliate links.

1

Add a custom domain to your Dub workspace

Before starting the migration process, you'll need to add a custom domain to Dub. This domain will be used to create short links for each affiliate link that we import from FirstPromoter.

If you haven't added a custom domain to Dub yet, you can follow this guide to set that up.

2

Set up conversion tracking + client-side click-tracking

Next, set up conversion tracking to track signup and sale events. We also have some in-app guides that you can reference here.

For backward compatibility, we also recommend setting up client-side click-tracking when installing the client-side @dub/analytics SDK on your site. This will ensure all your existing domain.com?fp_ref=affiliate links will keep working as expected, which gives affiliates time to update their links to the new format.

You can follow our guide on how to set up client-side click-tracking for your Dub short links to set that up.

3

Get your FirstPromoter API Key and Account ID

Follow this guide to get your FirstPromoter API key – API keys can be created in the Settings tab of your FirstPromoter dashboard.

You will also need to get your FirstPromoter Account ID under your Settings tab as well.

We will use the API key and Account ID to retrieve and import your existing FirstPromoter affiliate program campaigns to Dub.

4

Import your FirstPromoter campaign in the Partners tab

Once you've set up your Dub partner program, go to your Partners tab, click on the ⋮ button and select "Import from FirstPromoter".

To save you some time, here's a quicklink that will get you directly to the FirstPromoter import flow.

Then, add your FirstPromoter API key + Account ID and select Continue.

What data is migrated?

Our FirstPromoter migration tool imports the following attributes to Dub Partners:

Campaigns / Groups

Each of your campaigns on FirstPromoter will be mapped to a partner group on Dub.

Promoters / Partners

To ensure the efficiency of your partner program, we automatically filter out dormant promoters and only import the ones that are both:

• In an "accepted" state (docs)
• Have at least 1 referral (referrals_count > 1 → docs)

We also automatically import all your promoters' links and recreate them in Dub using your program's domain and default URL.

Referrals / Customers

By default, we import all referrals that are associated with an affiliate in your FirstPromoter program. This ensures that all subsequent subscription renewal events will continue to be tracked on Dub.

Commissions

We also import all commissions associated with any customers that were imported above. Depending on the commission state on FirstPromoter, they will be marked accordingly on Dub as well:

Dub also supports 4 additional commission states:

• Paid: When the payout containing the commission has been paid.
• Refunded: If the sale for the commission was refunded.
• Fraud: Useful for marking a sale as fraudulent and excluding it from any future payouts.
• Duplicate: Useful for marketing if a commission was rewarded more than once and needs to be marked as a duplicate event.

If there are any other attributes that you'd like to see migrated (or if you would like to customize any of the rules above), please reach out to us to let us know!

Next steps

After importing your program, here are some recommended next steps:

1. Set up your bank account for partner payouts

Dub Partners supports 1-click payouts to partners all across the globe.

Albania

Algeria

Andorra

Angola

Antigua and Barbuda

Argentina

Armenia

Australia

Austria

Azerbaijan

Bahamas

Bahrain

Bangladesh

Belgium

Benin

Bermuda

Bhutan

Bolivia

Bosnia and Herzegovina

Botswana

Brazil

Brunei Darussalam

Bulgaria

Cambodia

Canada

Cayman Islands

Chile

China

Colombia

Costa Rica

Show 103 more

We generally recommend using ACH for partner payouts as it is the most cost-effective option. Here's how you can set up your bank account for ACH payouts.

Read the guide ↗

2. Notify your affiliates about the platform change

Next, you'd want to reach out to your existing partners and let them know about the platform change. To do that, you can use our in-app Messaging Center to send your partners a message:

Here's an example verbiage that you can use:

Hey,

Starting today, we are switching the [Your Company] Affiliate Program from FirstPromoter to Dub Partners.

To get started, follow these steps:

1. Sign up for a Dub Partners account here: partners.dub.co/{your_program_slug}/register
2. Connect a payout method to receive your commissions.
3. Start sharing your shiny new referral link with your audience 🚀

Let us know if you have any questions!

Take your affiliate program to the next level with Dub

Ready to take your affiliate program to the next level? Sign up today and join companies like Framer that have migrated from FirstPromoter to Dub.

Have any questions? Feel free to reach out to us!