Switching affiliate platform without breaking links already published

The real risk is not the import

When you think about switching affiliate platform, you think about data first: bringing over the affiliates, the clicks, the sales history. That is real work, but it is not where things break.

What breaks is the links already published. Your affiliates put their link in video descriptions, blog posts, pinned messages, bios, PDFs, automated emails they wrote two years ago and have not touched since. You cannot ask all of them to republish, and you will not even know which ones were forgotten.

A dead link does not warn you. It simply sends visitors to an error page, or to nobody, for months.

First: the affiliate's code has to survive

An affiliate link contains an identifier: marie, mduval, a3f9. It was chosen by the person, or assigned by the old platform, and it is written into every one of those published links.

A migration that regenerates brand-new identifiers breaks everything at once. So the rule is simple: the affiliate arrives with their original code, and if two imported affiliates carry the same code, that is a conflict to settle before the import, not a problem to discover after.

Second: honour the old address formats

Every platform has its own link shape. The most widespread ones use a URL parameter:

acme.com/?via=marie      # Tapfiliate, among others
acme.com/?fpr=marie      # FirstPromoter
acme.com/?ref=marie      # very common generic form
acme.com/?rfsn=marie     # Refersion

A link in that shape already points at your site: the redirect is not the issue, the visitor arrives. What disappears is the reading of the parameter — nobody is looking at ?via= any more, so nobody gets credited. The sale happens, and the affiliate is no longer part of the story.

So the new platform has to keep reading those parameters and matching them against the imported codes. It is little work, and it is what makes the migration invisible to affiliates.

Third: recurring customers

This is the one people discover three months too late.

If you pay a recurring commission, every existing customer is already bound to an affiliate at the old platform. Next month your billing system will trigger their renewal — with no click, no cookie, no link. If the customer-to-affiliate binding was not imported, that renewal is attributed to nobody.

The result: your long-standing affiliates watch their income collapse the month after the migration, having changed nothing about their work. It is the quickest way to lose the people who keep you in business.

So the export you ask your current platform for has to include the conversions table with the customer id, not just the affiliate list and their sales totals.

Fourth: what to do with outstanding balances

At switchover, your affiliates have a balance at the old platform. There are two ways to handle it, and both are fine as long as you pick one.

• Settle at the old place, start from zero. You make one last payout there, you close it, and the imported commissions arrive marked as already settled. That is the cleanest.
• Carry the balance over. What was owed stays owed, and is paid from the new platform. Only choose this if you are certain you will make no further payout from the old one — otherwise somebody gets paid twice.

What you must not do is leave the question open. "We will sort it out later" is exactly what produces the double payment.

Fifth: send nothing during the import

An import creates accounts. Software that creates an account usually sends a welcome email. Multiply by four hundred affiliates, half of whom have been inactive for a year, and you get four hundred people receiving a simultaneous message from a brand they were not expecting to hear from.

So the import has to be silent, and the announcement has to come from you, when you have decided, with the words you wrote. The only message worth sending explains three things: the link still works, the balance is there, here is where to sign in.

The order of operations

1. Export from the old platform: affiliates, clicks, conversions, commissions. Twelve months of history is enough in most cases.
2. Look before importing. How many affiliates, how many sales, how many recurring customers bound, how much is still owed. An import you cannot preview is an import you will do twice.
3. Wire up the new tracking on your own domain, and verify it with a real click.
4. Import, with no email sent.
5. Run both in parallel for a few days. New links go through the new platform, old ones keep arriving through the honoured parameters.
6. Announce, then close the old one — after settling, if that is the option you chose.

Questions to ask before signing elsewhere

• Do my affiliates keep their original code?
• Do ?via=, ?ref=, ?fpr= and ?rfsn= still attribute?
• Is the binding between my existing customers and their affiliates imported, or only the totals?
• Do I see the result of the import before it is final?
• Does an email go out to my affiliates during the operation?

Five questions, five one-sentence answers. If one of them requires a meeting, that is already an answer.

Read next