Umzüge von anderen Plattformen

Wenn du von einer anderen Affiliate-Plattform wechselst, ist diese Seite dein Ausgangspunkt. Rekomi bringt Importer zum Selbermachen für 22 Quellen mit: Wähle unten die passende Anleitung für deine Plattform. Rewardful, Affonso, FirstPromoter, Tolt, Lemon Squeezy, impact.com, PromoteKit, LeadDyno, Trackdesk, Partnero, UpPromote, GoAffPro, Refersion, ReferralCandy und Everflow sind API-Importe per Abruf: Du fügst einen Schlüssel ein (FirstPromoter braucht zusätzlich deine Account ID; impact.com nutzt ein Paar aus Account SID und Auth Token; Trackdesk eine Tenant ID und ein persönliches Zugriffstoken; Partnero-Schlüssel gelten pro Programm; Refersion braucht einen Public Key und einen Secret Key; ReferralCandy eine Access ID und ein Secret; Everflow einen Network-Schlüssel plus die Wahl der Region US oder EU), und Rekomi holt alles. Bei Rewardful, FirstPromoter, Tolt, PromoteKit, LeadDyno, Partnero, UpPromote und GoAffPro bringt der Abruf die Liste plus Leads oder Historie in einem Durchlauf (ein CSV-Upload bleibt als Ausweichweg für Dateien, die du schon hast); die Abrufe von impact.com und Trackdesk bringen die Liste, die Klicksummen seit Beginn und bis zu 3 Jahre Conversion-Historie; der Abruf von Everflow bringt die Liste, die Klicksummen der letzten 12 Monate und bis zu 365 Tage Conversion-Historie (die Aufbewahrungsgrenze für Rohdaten bei Everflow); die API von Lemon Squeezy stellt nur die Liste bereit (Historie, Klicks oder Sätze pro Affiliate gibt es dort nicht abzurufen); auch der API-Abruf von ReferralCandy liefert nur die Liste, weil die API von ReferralCandy überhaupt keine Geld- oder Provisionsbeträge bereitstellt; der API-Abruf von Refersion bringt die Liste (die Historie muss aus einer CSV in Schritt 2 kommen, weil die REST-API von Refersion keinen Conversion-Endpunkt hat). Tapfiliate, PartnerStack, Dub Partners, BixGrow, Shopify Collabs und Post Affiliate Pro sind CSV-Importer (Post Affiliate Pro nimmt sowohl seine kanonische, durch Semikolons getrennte Datei aus Tools, Import/Export als auch seine Tabellenexporte an). Gumroad läuft über zwei Wege: Die Liste ist ein CSV-Upload (der Affiliates-Export aus dem Dashboard; eine öffentliche Affiliates-API gibt es nicht), die Verkaufshistorie kommt aus der API. Für jede andere Plattform nutzt du die Option Eigene / andere CSV unter Einstellungen > Umzug, mit der du die Spalten deines Exports selbst den Rekomi-Feldern zuordnest (E-Mail, Name, Status, Empfehlungs-Slug, PayPal).

Anleitungen für jede Plattform

Jede Anleitung führt durch den Export, die genaue Spaltenzuordnung des Importers, die Übersetzung der Status, das Verhalten beim Slug-Erhalt und einen Umstellungsplan Schritt für Schritt.

Was alle 22 Importer gemeinsam haben

Die folgende Mechanik gilt für jede plattformspezifische Anleitung. Lies sie einmal, dann konzentrieren sich die Seiten pro Plattform auf das, was jeweils besonders ist.

Was importiert wird

Jeder Importer übernimmt dieselbe einheitliche Struktur:

• E-Mail (Pflichtfeld, primärer Schlüssel für die Duplikatprüfung, kleingeschrieben und getrimmt).
• Vollständiger Name (eine Spalte oder first_name + last_name zusammengesetzt).
• Status, vereinheitlicht auf die fünf Status von Rekomi: Freigegeben, Ausstehend, Abgelehnt, Pausiert (zur Prüfung importiert) oder Gesperrt.
• PayPal-E-Mail, wo die Quelle sie liefert (Rewardful, Affonso, wenn PayPal die Auszahlungsmethode ist, FirstPromoter, Tolt, PromoteKit, LeadDyno, Trackdesk, wo dessen eingebettete Zahlungsmethoden eine enthalten, und Everflow, wo die Abrechnung eines Partners auf PayPal per E-Mail läuft).
• Standard-Tracking-Link, mit dem Slug der Quellplattform, wo möglich. Fehlt das Quellfeld, ist es fehlerhaft oder global vergeben, wird stattdessen ein neuer zufälliger Slug mit 12 Zeichen erzeugt.
• Klickzahl seit Beginn, wo die Quelle eine Summe bereitstellt (die API-Abrufe von Rewardful, FirstPromoter, Tolt, PromoteKit und LeadDyno tun das immer; die Abrufe von impact.com, Trackdesk und Everflow lesen sie, so weit möglich, aus einem Report; die Abrufe von Partnero und Affonso lesen sie pro Affiliate in einer begrenzten Detailschleife; CSV-Dateien liefern sie, wenn sie eine Klickspalte haben, etwa die zuschaltbare Spalte Clicks bei Dub oder der Performance-Report von PartnerStack). Importierte Klicks zählen zu den Klicksummen seit Beginn, den Ranglisten und der EPC-Berechnung jedes Affiliates, es fängt also nichts bei null an. Es sind Summen, keine Ereignisse: Sie erscheinen nicht in zeitlich gegliederten Diagrammen und sind nie auszahlbar (Kampagnen mit Vergütung pro Klick (CPC) schließen sie aus).

Das ist Schritt 1: deine Affiliate-Liste. Ein optionaler Schritt 2 importiert ihre Historie und Einnahmen (frühere Conversions, Provisionen, Leads und die Zuordnung von Kunden); siehe Historie und Einnahmen importieren unten. Die API-Abrufe von Rewardful, Affonso, FirstPromoter, Tolt, PromoteKit, LeadDyno und Partnero holen Leads und Provisionshistorie im selben Durchlauf (impact.com, Trackdesk und Everflow holen ebenfalls die Conversion-Historie), dort brauchst du Schritt 2 also nur, wenn unbezahlte Guthaben aus einer CSV auszahlbar werden sollen.

Der Importer übernimmt NICHT:

• Die Historie einzelner Klickereignisse: Die Klickzahlen seit Beginn werden übernommen (siehe oben), aber die einzelnen Klickereignisse (Datum, Referrer, Geo) lassen sich aus keiner Quellplattform exportieren, deshalb starten zeitlich gegliederte Klickdiagramme in Rekomi neu.
• Bestehende Tracking-Links über den Slug hinaus: Importierte Affiliates bekommen einen Link auf Rekomi-Seite, mit erhaltenem Slug, wo das möglich ist (die Übersicht findest du in den Anleitungen pro Plattform).

Für GrowSurf, Reditus oder selbst gebaute Systeme nutzt du den begleiteten Umzug: Schreib uns über den Messenger in der App, und wir planen ihn mit dir. Persönliche Hilfe ist beim Onboarding für frühe Kunden in jedem Plan enthalten.

Historie und Einnahmen importieren (Schritt 2)

Wenn deine Affiliates importiert sind (Schritt 1), lädst du unter Einstellungen > Umzug > Schritt 2 den Conversions-Export deiner Plattform hoch (eine andere Datei als die Affiliate-Liste; jede Anleitung nennt die genaue Datei, etwa den Commissions-Export von Dub, das Paket aus Commissions und Transactions von PartnerStack, die Conversions- und Customers-Exporte von Tapfiliate oder den Transaktionsexport von Post Affiliate Pro in beiden Formen). So kommt die bisherige Leistung jedes Affiliates mit, seine Statistiken beginnen nicht bei null, und seine bestehenden Kunden können ihm weiter Provision bringen. Bei Rewardful, Affonso, FirstPromoter, Tolt, PromoteKit, LeadDyno und Partnero importiert der API-Abruf diese Historie bereits (Schritt 2 ist die CSV-Alternative und der einzige Ablauf, der unbezahlte Guthaben auszahlbar machen kann; für die Slugs von PromoteKit, LeadDyno, Trackdesk und Partnero nutzt die Datei für Schritt 2 die generischen Spalten: E-Mail des Affiliates, Betrag, Provision, Währung, Datum, bezahlt), und die Abrufe von impact.com und Trackdesk importieren im selben Durchlauf bis zu 3 Jahre Historie (immer als abgerechnete Datensätze; der Abruf von Everflow macht dasselbe für bis zu 365 Tage, seine Aufbewahrungsgrenze für Rohdaten). Schritt 2 ist bei Gumroad ein API-Abruf statt einer Datei (einen Conversions-Export gibt es nicht): Er importiert Verkäufe mit Affiliate-Zuordnung als abgerechnete Historie, überspringt erstattete und per Rückbuchung zurückgeholte Verkäufe und zählt teilweise erstattete (zum vollen Wert importiert) zur Prüfung. Die Ausnahme ist Lemon Squeezy: Dort gibt es nirgends eine Referral- oder Auszahlungshistorie (keine API, kein Export), deshalb ist Schritt 2 für diese Quelle nicht verfügbar.

Das macht der Historienimport:

• Erfasst frühere Conversions und Provisionen, die innerhalb der Zielkampagne per E-Mail (oder über den erhaltenen Slug) dem Affiliate zugeordnet werden. Provisionsbetrag und Datum werden unverändert aus deinem Export übernommen, nicht neu berechnet.
• Berücksichtigt bezahlt und unbezahlt. Der Import erfasst nur Daten; Rekomi zahlt nie automatisch jemanden aus. Zeilen, die deine alte Plattform bereits ausgezahlt hat, werden als abgerechnete Historie importiert (sie erscheinen in den Summen seit Beginn, werden aber nie erneut ausgezahlt). Zeilen, die noch offen waren, werden ebenfalls als Historie importiert und werden nur dann auszahlbar (in deinen nächsten Auszahlungslauf aufgenommen, den du selbst startest), wenn du das auf dem Vorschaubildschirm ausdrücklich autorisierst; andernfalls werden sie als abgerechnet erfasst, und Rekomi zahlt sie nicht aus.
• Hält wiederkehrende Provisionen am Laufen. Wenn dein Export die Stripe-Kunden- oder Abo-ID eines Kunden enthält, legen wir die Zuordnung so an, dass die nächste Verlängerung per invoice.paid demselben Affiliate gutgeschrieben wird, innerhalb des Provisionszeitraums der Kampagne (ein fester Zeitraum zählt ab der ersten Zahlung des Kunden in der importierten Historie, ein Kunde, der schon darüber hinaus ist, bringt also keine Provision mehr). Dafür muss dein Stripe-Konto verbunden sein, und diese IDs müssen im Export stehen.
• Importiert Leads als Leads. Zeilen, die die Quelle ausdrücklich als Lead markiert (ein Referral, der sich registriert, aber nie gekauft hat: der Status lead bei Rewardful, die Referrals mit lead und trialing bei Affonso, die trial-Zeilen im Customers-Export von Tapfiliate, die Referrals mit signed_up bei PromoteKit, die Registered-Leads bei LeadDyno, Partnero-Kunden ohne Transaktion), werden als Lead-Datensätze ohne Geldbetrag importiert und ihrem Affiliate zugeordnet. Sie füllen deinen Funnel und deine Lead-Zahlen ab dem ersten Tag und sind nie auszahlbar.
• Zeigt zuerst eine Vorschau. Jeder Historienimport läuft zuerst als Probelauf mit Vorschau, die zeigt, wie viele Zeilen importiert werden und genau wie viel Rekomi gegebenenfalls auszahlen soll, bevor du bestätigst. Ein erneuter Durchlauf ist sicher: Duplikate werden automatisch übersprungen.

Stornierte, erstattete und betrügerische Zeilen werden übersprungen. Der Historienimport ist wie der Listenimport ab Starter verfügbar.

Voraussetzungen je Plan

Der Importer ist ab Starter verfügbar (bezahlt oder in der Testphase). Die automatische Benachrichtigung erfordert mindestens die Stufe Growth mit einem aktiven Abonnement; eine Testphase kann auf keiner Stufe, auch nicht bei Pro, an alle verschicken. Nutzer in der Testphase können die Benachrichtigung schreiben und in der Vorschau ansehen (auch über „Beispiel an mich selbst senden“), aber erst an die importierten Affiliates verschicken, wenn eine Zahlungsmethode hinterlegt ist.

Greift diese Sperre, antwortet die API mit 402 und error: "paid_plan_required", required: "Growth", subscriptionStatus sowie einem Kennzeichen trialing.

Zielkampagne wählen

Jeder Importer ordnet die importierten Affiliates einer deiner bestehenden Rekomi-Kampagnen zu. Wähle die Kampagne vor dem Hochladen. Du kannst mehrere Importe in mehrere Kampagnen ausführen; der Importer startet für dieselbe Organisation keinen zweiten gleichzeitigen Import, bevor der erste fertig ist (das verhindert doppelte Affiliates durch parallele Läufe).

Automatische Benachrichtigung (ab Growth)

Wenn jeder importierte Affiliate direkt nach dem Import eine Einladung zur Registrierung bekommen soll, hake Affiliates nach dem Import benachrichtigen an und schreib im Editor eine persönliche Notiz.

Die persönliche Notiz kann fett, kursiv und Links enthalten (nur https-Links sind erlaubt), bis zu etwa 500 sichtbare Zeichen. Sie erscheint in einem Zitatblock in deiner Markenfarbe oben in jeder Benachrichtigungs-E-Mail. Darunter steht ein einziger Button: Konto übernehmen. Der Button öffnet app.rekomi.com/sign-up/affiliate mit der vorausgefüllten E-Mail des Affiliates, sodass er sich bei der ersten Anmeldung mit dem bestehenden importierten Datensatz verbindet (keine doppelten Konten).

Bevor du den echten Versand startest, klicke auf Beispiel an mich selbst senden. Wir schicken eine einzelne Vorschau-E-Mail an deine verifizierte E-Mail-Adresse, mit genau dem Inhalt, den deine Affiliates sehen würden, plus einem gelben Banner „DIES IST EINE VORSCHAU“, damit du Text und HTML-Darstellung prüfen kannst.

Wenn der Massenversand startet, drosselt Hangfire ihn auf eine E-Mail pro Sekunde mit bis zu 200ms zufälliger Verzögerung, ein Import mit 500 Zeilen dauert insgesamt also etwa 8 Minuten. Die Historientabelle zeigt pro Job live die Zähler Benachrichtigungen: X gesendet · Y fehlgeschlagen.

Affiliates melden sich an und übernehmen ihr Konto

Wenn ein importierter Affiliate in seiner E-Mail auf den Button zur Registrierung klickt (oder du app.rekomi.com/sign-up/affiliate?email=their@email direkt teilst), legt Clerk sein Konto an. Der Rekomi-Handler für die automatische Übernahme verbindet den neuen Clerk-Nutzer über die E-Mail-Adresse mit der bestehenden importierten Zeile Affiliate. Der Affiliate landet in seinem neuen Affiliate-Dashboard, sein Tracking-Link ist schon eingerichtet.

Gründe für übersprungene Zeilen und was sie bedeuten

Das Ergebnis jeder Zeile siehst du im Detailfenster der Importhistorie:

Historienimporte aus Schritt 2 zeigen im selben Fenster ihre eigenen Gründe: affiliate_not_found (kein Treffer in der Liste für E-Mail, Slug oder Namen der Zeile), affiliate_excluded (der zugeordnete Affiliate ist Gesperrt oder Abgelehnt), already_exists (Duplikat eines früheren Imports), excluded_paid (du hast gewählt, bereits bezahlte Provisionen zu überspringen), missing_required_fields, unsupported_currency und negative_amount. Zeilen der Liste aus einem API-Abruf, die einzeln fehlschlagen, zeigen row_import_failed.

Sicherheit und Zustellbarkeit

• HTML-Bereinigung: Deine persönliche Notiz wird serverseitig auf eine Positivliste bereinigt (Absatz, Zeilenumbruch, fett, kursiv, Link mit reiner https-Adresse). Script-Tags, Inline-Styles und Links ohne https werden entfernt.
• Festgelegte Empfänger: Der Hangfire-Job trägt nur die Kennung der Zeile, nicht die E-Mail. Der Worker liest die E-Mail des Affiliates beim Versand erneut aus der Datenbank, eine manipulierte Warteschlange kann E-Mails also nicht umleiten.
• Abmeldungen werden respektiert: Jede E-Mail enthält List-Unsubscribe-Header, und wir prüfen die Abmeldeliste deiner Organisation beim Versand erneut, nicht nur beim Einreihen.
• Drosselung: eine E-Mail pro Sekunde und Importjob. So bleibst du unter den Limits von Resend für Transaktions-E-Mails und deutlich unter den Schwellen, mit denen Gmail / Microsoft 365 plötzliche Versandspitzen von neuen Absendern erkennen.
• Audit-Log: Jeder Statuswechsel (migration.completed, migration.notify.queued, migration.notify.sent, migration.notify.failed, migration.notify.sample_sent) wird für Compliance und Nachverfolgung im Audit-Log deiner Organisation festgehalten.

Import per API oder MCP

Die Dashboard-Importer oben lesen für dich eine bestimmte CSV des jeweiligen Anbieters. Wenn du den Umzug lieber automatisierst oder deine Daten irgendwo ohne CSV-Export liegen, kannst du dieselben zwei Dinge über die öffentliche REST-API und über den MCP-Server importieren (dann kann ein KI-Assistent das für dich erledigen). Beide nehmen generische, einheitliche JSON-Zeilen statt einer Anbieterdatei an und nutzen genau dieselben protokollierten Importdienste wie das Dashboard, die Regeln für Geld und Identität sind also identisch.

• Affiliates: POST /api/v1/affiliates/import (MCP-Tool import_affiliates). Dedupliziert per E-Mail, behält Slugs bei, optionaler Statusfilter und Benachrichtigung.
• Conversions und Provisionen: POST /api/v1/conversions/import plus ein Probelauf über POST /api/v1/conversions/import/preview (MCP-Tools import_conversions und preview_conversion_import). Bezahlte Zeilen werden als abgerechnete Historie gesperrt; unbezahlte Zeilen werden nur auszahlbar, wenn du confirmUnpaidPayout=true übergibst. Sieh dir immer zuerst die Vorschau an, um das unbezahlte Guthaben zu sehen.

Beide sind für Aufrufe mit API-Schlüssel ab Starter+ verfügbar, auf 1,000 Zeilen pro Anfrage begrenzt, mit Rate-Limit versehen, sicher wiederholbar und erzeugen denselben umkehrbaren Importjob, den du in der Importhistorie siehst. Die vollständigen Schemas für Anfragen und Antworten stehen in der API-Referenz und in der MCP-Anleitung.

FAQ

Welchen Importer wähle ich, wenn meine Quelle nicht in der Liste steht?

Für GrowSurf, Reditus oder selbst gebaute Systeme nutzt du den begleiteten Weg (Chat unten rechts). Wir planen den Import von Anfang bis Ende.

Kann ich die persönliche Notiz ändern, nachdem der Import gestartet ist?

Nein. Die Notiz wird beim Hochladen festgeschrieben und geht mit demselben Inhalt an jeden Affiliate dieses Durchlaufs. Wenn du eine andere Nachricht willst, führe einen separaten Import mit einer anderen Notiz aus oder schick hinterher einen Broadcast über den Tab E-Mails der Kampagne.

Können Affiliates die Benachrichtigung abbestellen?

Ja. Jede E-Mail enthält List-Unsubscribe-Header und einen Abmeldelink in der Fußzeile. Wer sich abmeldet, wird bei diesem Versand und bei jeder künftigen E-Mail deiner Organisation übersprungen, bis er sich wieder anmeldet.

Was, wenn ich in die falsche Kampagne importiere?

Die Affiliate-Datensätze sind ab dem Import an die Kampagne gebunden. Die Kampagne eines einzelnen Affiliates kannst du unter /dashboard/affiliates/{id} ändern (ab der Rolle Manager). Eine Neuzuordnung in großen Mengen steht auf der Roadmap.

Legt der Importer beim Import Clerk-Konten an?

Nein. Wir legen nur die Zeile Affiliate auf Rekomi-Seite plus einen Standard-Tracking-Link an. Das Clerk-Konto entsteht, wenn sich der Affiliate über seinen Einladungslink registriert. So bestimmst du selbst, wann deine Affiliates in der Nutzerliste von Clerk auftauchen, und es gibt keine überraschenden Registrierungs-E-Mails, bevor du bereit bist.

Werden auch Verkäufe oder Provisionen importiert?

Ja. Nutze Schritt 2: Historie und Einnahmen (siehe oben), um den Referral- oder Provisionsexport deiner Plattform hochzuladen. Der Import erfasst nur Daten; Rekomi zahlt nie automatisch jemanden aus. Bereits bezahlte Provisionen werden als gesperrte Historie importiert (nie erneut ausgezahlt); unbezahlte werden ebenfalls als Historie importiert und nur dann auszahlbar (in einen Auszahlungslauf aufgenommen, den du selbst startest), wenn du das auf dem Vorschaubildschirm ausdrücklich autorisierst. Wiederkehrende Provisionen für bestehende Kunden laufen weiter, wenn dein Export die Stripe-Kunden- oder Abo-IDs enthält und dein Stripe-Konto verbunden ist.

Die CSV meiner Quellplattform hat Spalten, die der Importer nicht erkennt. Ist das ein Problem?

Nein. Der Importer ordnet die Spaltennamen unscharf zu und ignoriert unbekannte Spalten stillschweigend. Solange die Pflichtspalte email vorhanden ist, läuft der Import. Unbekannte Spalten werden in v1 NICHT gespeichert; wenn du eigene Felder oder plattformspezifische Metadaten behalten musst, wende dich an den Support.

Wie es weitergeht

• E-Mail-Versand: Richte deine eigene Domain ein, damit Migrationsbenachrichtigungen von you@yourbrand.com statt vom gemeinsamen Rekomi-Absender kommen.
• Affiliates gewinnen: der Editor für direkte Einladungen, um einzelne Creator anzusprechen, über den Massenimport hinaus.
• Pläne und Testphasen: was jede Stufe enthält und wie die 14-tägige kostenlose Testphase funktioniert.