Von einer anderen Affiliate-Plattform wechseln

Die größte Sorge beim Wechsel der Affiliate-Plattform ist, jedem Affiliate schreiben zu müssen, damit er seine Links aktualisiert. Mit Rekomi musst du das fast nie.

Rekomi erkennt von Haus aus die Query-Parameter für die Attribution, die mehr als 20 große Affiliate-Plattformen nutzen. Solange deine bisherige Plattform eine der 21 Parameter-Konventionen aus der Tabelle unten genutzt hat, funktionieren die bestehenden Empfehlungslinks deiner Affiliates unverändert weiter, wenn du das JavaScript-Snippet auf deiner Website austauschst. Dieselben Slugs, dieselben URLs, keine Ansprache deiner Affiliates nötig.

Wie Affiliate-URLs wirklich funktionieren (die langweilige Wahrheit)

Fast jede Affiliate-Plattform auf dem Markt erzeugt Links, die so aussehen:

https://your-brand.com/?via=alex
https://your-brand.com/?ref=alex
https://your-brand.com/?fpr=alex
https://your-brand.com/?aff=alex

Das JavaScript-Snippet der Plattform auf deiner Website liest den Query-Parameter (via, ref, fpr, aff usw.) und speichert den Slug (alex) als vermittelnden Affiliate. Der Slug und der Name des Parameters sind die einzigen beiden Dinge, die entscheiden, ob der Link nach dem Umzug noch zuordnet. Für den Umzug heißt das also:

1. Gleicher Slug + gleiche Parameter-Konvention → der Link funktioniert, wie er ist, kein Affiliate merkt einen Unterschied.
2. Gleicher Slug + anderer Parameter → eine Redirect-Zeile auf deinem Reverse Proxy löst das.
3. Anderer Slug → Affiliates brauchen einen neuen Link.

Die meisten Umzüge sind Fall 1.

Native Kompatibilitätstabelle

Steht deine Plattform nicht in dieser Liste, nutzt aber eine erkennbare Parameter-Konvention, kannst du sie im Rekomi-Dashboard unter Einstellungen > Link-Tags als eigenen Parameter hinzufügen.

Der Umzug in 3 Schritten

Vorausgesetzt, deine bisherige Plattform nutzt einen der 21 erkannten Parameter:

1. Affiliates mit erhaltenen Slugs importieren

Es gibt zwei Wege, deine bestehenden Affiliates mit unveränderten Slugs zu übernehmen:

Option A: die eigenen Importer (Einstellungen > Umzug). Wähle deine bisherige Plattform.

Für Rewardful, Affonso, FirstPromoter und Tolt ist der Hauptweg ein API-Abruf mit einem Schlüssel, der die Affiliate-Liste (mit erhaltenen Slugs) plus Leads, Klicksummen seit Beginn und Provisionshistorie in einem Durchgang importiert; ein CSV-Upload bleibt als Alternative. Lemon Squeezy läuft ebenfalls über einen API-Abruf (nur die Affiliate-Liste; die API liefert weder Verlauf noch Klicks). Tapfiliate, PartnerStack und Dub Partners sind CSV-Uploads. Gumroad ist ein CSV-Upload für die Affiliate-Liste mit einem API-Abruf für die Verkaufshistorie; Slugs bleiben dort nie erhalten (Gumroad-Links unter /a/ nutzen anonyme IDs, die nur innerhalb von Gumroad weiterleiten, es gibt also keinen Slug, den man übernehmen könnte). So oder so liest der Importer den Slug der Quellplattform automatisch:

Liest der Parser Slugs aus, erscheint auf der Upload-Seite neben dem Namen der Plattform das grüne Badge „Affiliate-Links werden automatisch erhalten“. Jeder importierte Affiliate behält seinen bestehenden Slug; seine bestehende öffentliche Empfehlungs-URL (z. B. brand.com/?via=alex) ordnet in Rekomi unverändert weiter zu.

Kontinuität bei ?aff= von Lemon Squeezy. Affiliate-Links von Lemon Squeezy nutzen ?aff=, das schon zu den Parametern gehört, die Rekomi erkennt, auf der Parameterseite musst du also nichts einstellen. Die Slugs sind Handarbeit: Lemon Squeezy hat keinen CSV-Export für Affiliates, und die API liefert den Code ?aff= der einzelnen Affiliates nicht (er ist nur auf der Profilseite des Affiliates im Dashboard von Lemon Squeezy zu sehen). Deshalb nimmt der Lemon-Squeezy-Importer optional eine eingefügte Zuordnung email,aff_code für die Codes an, die du erhalten willst. Die Kontinuität gilt für Links, die auf deiner eigenen Website landen, wo das Rekomi-Snippet läuft; Links, die direkt auf deinen Storefront unter *.lemonsqueezy.com zeigen, kann kein Umzugstool übernehmen.

Option B: Sammeleinladung mit Slugs (Seite Affiliates > Affiliates einladen > Mehrere auf einmal). Stell das Einfügeformat auf E-Mail, Code, Name um und füge eine Zeile pro Affiliate ein:

alex@example.com, alex, Alex Example
jamie@example.com, jamie-r, Jamie Recommends

Wir verschicken jede Einladung wie gewohnt; beim Annehmen wird der Slug genutzt, den du angegeben hast. Ist ein Slug vergeben oder ungültig, bekommt der Affiliate trotzdem eine Einladung, aber mit einem neuen zufälligen Slug. Die Antwort führt diese Zeilen im Array slugConflicts auf, damit du sie neu senden oder dir etwas anderes überlegen kannst.

Option C: der MCP-Installationsassistent. Frag den verbundenen KI-Assistenten: „Ich ziehe von FirstPromoter um. Hier ist meine Affiliate-Liste.“ Gib ihm die CSV-Datei; der Assistent ruft im Hintergrund bulk_invite_affiliates mit der Struktur recipients auf (pro Zeile E-Mail-Adresse + Slug + Name) und meldet das Ergebnis jeder Zeile zurück.

Einzelne Einladungen sind in jedem Plan kostenlos, auch in der Testphase. Sammeleinladungen erfordern Starter oder höher mit einem aktiven bezahlten Abonnement; die Importer für den Umzug funktionieren ab Starter, auch während der Testphase.

Was passiert, wenn ein Slug vergeben ist

Affiliate-Slugs sind in ganz Rekomi eindeutig. Willst du einen Affiliate mit dem Slug alex übernehmen und eine andere Marke irgendwo in Rekomi hat schon einen Affiliate mit dem Slug alex, dann passiert bei deinem Import Folgendes:

1. Die Einladung oder der Affiliate-Datensatz wird trotzdem angelegt.
2. Für diesen einen Affiliate wird stattdessen ein neuer zufälliger Slug mit 12 Zeichen vergeben.
3. Sammeleinladungen melden diese Zeilen im Feld slugConflicts der Antwort; CSV-Importe weichen stillschweigend aus, prüfe in der Importvorschau also, bei welchen Affiliates sich der Slug geändert hat. In beiden Fällen kannst du die Einladung mit einem anderen Slug neu senden oder den Affiliate bitten, seinen Link zu aktualisieren.

In der Praxis passiert das bei Umzügen selten, weil die meisten Affiliate-Slugs auf Namen beruhen und der globale Namensraum dünn besetzt ist. Am ehesten trifft es Marken mit sehr allgemeinen Slugs (z. B. ein Affiliate, der tatsächlich affiliate1 heißt).

2. Das JavaScript-Snippet auf deiner Website austauschen

Ersetze das Script-Tag deiner alten Affiliate-Plattform durch den Rekomi-Loader. Das Snippet steht im Dashboard unter Einrichtung > Tracking-Skript installieren auf jeder Seite mit einem Installationsrezept.

3. Stripe verbinden (oder die Attribution über Gutscheine einrichten)

Lief deine bisherige Plattform über Stripe-Webhooks (das gilt für die meisten), verbinde Stripe im Schritt Zahlungsanbieter verbinden (/dashboard/setup/connect-sales), und die Attribution der Conversions läuft automatisch. Hast du bisher über Gutscheincodes zugeordnet, lege auf der Detailseite jedes Affiliates eigene Stripe-Promotion-Codes für ihn an.

4. (Optional) Bisherige Einnahmen importieren

Bei Rewardful, Affonso, FirstPromoter und Tolt hat der API-Abruf in Schritt 1 Leads, Klicksummen seit Beginn und Provisionshistorie schon übernommen; mehr musst du nicht tun, es sei denn, offene Guthaben sollen auszahlbar werden. Bei den CSV-Quellen lädst du den Export der Conversions oder Provisionen deiner Plattform unter Einstellungen > Umzug > Schritt 2 hoch, um die bisherigen Conversions und Provisionen jedes Affiliates zu übernehmen, damit seine Statistiken nicht auf null zurückgesetzt werden (Zeilen, die der Export ausdrücklich als Leads kennzeichnet, werden als Lead-Datensätze ohne Geldbetrag importiert). Bereits ausgezahlte Provisionen werden als gesperrter Verlauf importiert (und nie erneut ausgezahlt); unbezahlte kommen nur dann in eine Rekomi-Auszahlung, wenn du das auf der Vorschauseite ausdrücklich freigibst. Enthält der Export die Stripe-Kunden- oder -Abo-ID eines Kunden und ist dein Stripe verbunden, legen wir die Attribution vorab an, damit bestehende Abonnements bei Verlängerungen weiter demselben Affiliate gutgeschrieben werden. Jeder Import des Verlaufs zeigt vor dem Übernehmen eine Probelauf-Vorschau (mit dem genauen Betrag, den Rekomi gegebenenfalls auszahlen würde), und ein erneuter Durchlauf ist gefahrlos. Mehr dazu im Überblick über Umzüge.

Das war's. Deine Affiliates mussten keinen einzigen Link ändern, und ihr Verlauf zieht mit um.

Wann du DOCH eine Redirect-Regel brauchst

In ein paar Fällen brauchst du eine zusätzliche Zeile auf deinem Server:

Plattformen mit seltenen Query-Parametern

Hat deine bisherige Plattform einen Parameter genutzt, der nicht zu den 19 erkannten gehört (z. B. ein internes Tool mit ?our_aff_id= oder Ähnlichem), füge ihn unter Einstellungen > Link-Tags als eigenen Parameter hinzu:

• Zusätzliche Parameter durch Kommas getrennt, jeweils 2 bis 32 Zeichen, Kleinbuchstaben / Ziffern / Unterstrich / Bindestrich
• Bis zu 10 eigene Einträge, insgesamt 256 Zeichen

Nach dem Speichern erkennt der Loader die neuen Parameter beim nächsten Seitenaufruf. Kein erneutes Einfügen des Snippets, keine Ansprache deiner Affiliates.

Pfadbasierte Plattformen (älteres PartnerStack, Impact)

PartnerStack und Impact erzeugen oft pfadbasierte Links wie partner.brand.com/refer/alex oder offers.impact.com/c/12345/alex. Die lassen sich nicht allein über die Erkennung von Query-Parametern übernehmen, weil der Slug nicht im Query-String der URL steht. Deine Möglichkeiten:

1. Die alte Subdomain per CNAME auf deinen Origin zeigen lassen und einen Path-Rewrite ergänzen. Beispiel für Cloudflare Workers:

addEventListener("fetch", (event) => {
  const url = new URL(event.request.url);
  const m = url.pathname.match(/^\/refer\/([a-z0-9-]+)\/?$/);
  if (m) {
    return event.respondWith(
      Response.redirect(`https://your-brand.com/?via=${m[1]}`, 302),
    );
  }
});

2. Deinen Affiliates einmal eine E-Mail mit den neuen Links schicken. Bei Affiliates mit viel Volumen ist das mühsam, aber wenn du nur wenige Affiliates auf einer pfadbasierten Plattform hast, ist es vielleicht die sauberste Lösung.

Eigene Plattformen mit völlig anderen Konventionen

Hat deine alte Plattform etwas Ausgefallenes gemacht (Attribution per POST, Fingerprinting usw.), schreib an support@rekomi.com, und wir helfen dir, einen eigenen Integrationsweg zu planen.

Warum dir deine bisherige Plattform den Wechsel schwer gemacht hat

Die meisten Affiliate-Plattformen haben einen finanziellen Anreiz, den Abschied von ihnen schmerzhaft zu machen. Hilfe beim Umzug zu ihnen hin ist großzügig dokumentiert, während die Exportwege nach draußen dünn bleiben; Rewardful zum Beispiel bietet keinen Export der Empfehlungen zum Selbermachen. Das „Media Partner Migration Team“ von Impact ist eine Vertriebshürde, die als Kostenfaktor gleich ins Produkt eingebaut ist. Der „Concierge Migration“-Service von PartnerStack ist dasselbe in anderer Verpackung.

Wir haben diesen Anreiz nicht. Je mehr Marken zu uns wechseln, desto besser wird Rekomi. Die direkte Kompatibilität mit den 19 häufigsten Parametern ist ein einmaliger Entwicklungsaufwand, den wir vorab übernommen haben, damit du ihn nie hast.

Umzug per Programm über den MCP-Installationsassistenten

Hast du einen KI-Client per MCP mit Rekomi verbunden (Claude Desktop, Claude Code, Cursor, Continue, Zed, ChatGPT Connectors), frag ihn:

„Ich ziehe von FirstPromoter um. Hier ist meine Affiliate-Liste als CSV. Hilf mir, alles zu übernehmen.“

Der Assistent ruft auf:

1. get_billing_state, um zu prüfen, ob dein Plan Sammeleinladungen abdeckt.
2. get_attribution_params, um zu prüfen, ob der Parameter deiner Quellplattform zu den Standards gehört (?fpr= von FirstPromoter gehört dazu).
3. bulk_invite_affiliates, um die Einladungs-E-Mails mit deinem Branding zu verschicken.
4. Optional update_attribution_params, wenn du einen eigenen Parameter brauchst.

Der ganze Umzug läuft im Chat. Keine Oberfläche für CSV-Uploads, kein Hin- und Herkopieren zwischen Tabs.

Siehe auch

• MCP-Server: der KI-Installationsassistent und mehr als 50 weitere Tools
• Pixel-Tracking: das Verhalten des Loader-Skripts + erkannte Parameter
• API für Sammeleinladungen von Affiliates: der Endpunkt, den der Installationsassistent nutzt