Umzug von FirstPromoter

Diese Anleitung ist für Marken, die von FirstPromoter zu Rekomi wechseln. Der Hauptweg ist ein API-Import per Abruf: Füge deinen FirstPromoter-API-Schlüssel und deine Account ID ein, und Rekomi importiert in einem Durchlauf deine Promoter-Liste (mit dem Referral-Token und der Klickzahl seit Beginn jedes Promoters), deine Leads und deine Provisionshistorie. Ein CSV-Upload bleibt als zweiter Weg für Promoters-Exporte, die du schon hast.

Bestehende Links wie brand.com/?fpr=alex bleiben automatisch erhalten. Der Umzug ist ab Starter verfügbar, die automatische Benachrichtigung ab Growth.

Import per API (empfohlen)

Der Promoters-CSV-Export von FirstPromoter hat undokumentierte Spalten, und die Referrals-Liste (deine Leads) hat überhaupt keinen Export, deshalb ist der API-Abruf der einfachste und zugleich vollständigste Weg.

1. Öffne in FirstPromoter Settings → Integrations und kopiere deinen API key und deine Account ID (beide werden dort angezeigt).
2. Öffne /dashboard/settings/migrate, wähle FirstPromoter, wähle deine Zielkampagne in Rekomi und füge beide Werte ein. Sie werden einmal im Arbeitsspeicher verwendet und nie gespeichert, protokolliert oder erneut angezeigt.
3. Lass die Schalter Leads importieren und Provisionshistorie importieren an (oder schalte einen davon aus) und klicke auf Von FirstPromoter abrufen.

Was der Abruf importiert:

• Promoter: E-Mail, Name, Status pro Kampagne (Zuordnung der API: accepted wird als Freigegeben importiert, pending/not_set als Ausstehend, rejected und blocked als Gesperrt, inactive als Pausiert), die PayPal-E-Mail, wenn sie bereitgestellt wird, und das Referral-Token (ref_token), das als Rekomi-Link-Slug erhalten bleibt. Promoter, die in mehreren FirstPromoter-Kampagnen sind, werden einmal importiert, mit Token und Status ihrer ersten Kampagne; die Importzusammenfassung nennt, wie viele das betrifft.
• Klickzahlen: Die Summe der eindeutigen Klicks seit Beginn (clicks_count) jedes Promoters wird in seinen Klickzähler in Rekomi übernommen, damit Ranglisten und EPC-Berechnungen nicht bei null anfangen.
• Leads: Referrals, die nie zahlende Kunden wurden, werden als Lead-Datensätze ohne Geldbetrag importiert und ihrem Promoter zugeordnet, sodass dein Funnel und deine Lead-Zahlen ab dem ersten Tag gefüllt sind.
• Provisionshistorie: Betrag und Verkaufsbetrag jeder Provision (FirstPromoter meldet ganzzahlige Cent-Beträge; sie werden 1:1 importiert), Datum und Bezahlt-Status (is_paid). Bezahlte Provisionen werden als abgerechnete Historie importiert, unbezahlte als gesperrte Datensätze. Aus dem API-Abruf wird nichts auszahlbar. Abgelehnte Provisionen werden übersprungen. Beträge in Währungen ohne Nachkommastellen (zum Beispiel JPY, das keine Cent kennt) werden genau so importiert, wie FirstPromoter sie meldet, ohne Umrechnung. Wenn du ein Programm in JPY (oder einer anderen Währung ohne Nachkommastellen) betreibst, vergleiche stichprobenartig ein paar importierte Beträge mit FirstPromoter, bevor du dich auf die Summen verlässt. Provisionen in ISK, UGX oder MGA werden übersprungen und im Ergebnis des Abrufs als UnsupportedRepresentationRows gezählt, bis FirstPromoter bestätigt, wie es diese drei Währungen darstellt.

Was der Abruf nicht importieren kann: auszahlbare Guthaben (nutze den CSV-Ablauf aus Schritt 2 mit seiner Vorschau, wenn unbezahlte Provisionen auszahlbar werden sollen), Promo-Codes, die Kampagnenstruktur, eigene Felder und Logs auf Klickebene (FirstPromoter stellt nur Summen bereit). Von jeder Liste werden bis zu 5,000 Zeilen abgerufen; das Ergebnis sagt dir, ob ein Abruf abgeschnitten wurde.

Den Abruf erneut auszuführen ist sicher: Affiliates werden per E-Mail dedupliziert, Historienzeilen über die IDs von FirstPromoter.

Die CSV als Ausweichweg

Wenn dir eine Datei lieber ist, funktioniert der CSV-Importer weiterhin mit dem Export aus dem Tab Promoters. Leads und Historie können nicht aus dieser Datei kommen (nur aus dem API-Abruf oder der Referrals-CSV in Schritt 2).

Was der CSV-Importer übernimmt

Der Importer ordnet Spaltennamen unscharf und ohne Rücksicht auf Groß- und Kleinschreibung zu und akzeptiert v1- und v2-Spalten gleichermaßen. Spalten wie id, promo_code, created_at und country werden ignoriert; eine Spalte clicks_count oder clicks wird als Klickzahl des Affiliates seit Beginn importiert.

Status-Zuordnung

Mit der Einführung von v2 hat FirstPromoter mehrere Status umbenannt. Der Importer vereinheitlicht beide Vokabulare:

Diese Tabelle gilt für den CSV-Ausweichweg. Der API-Abruf ordnet die v2-Status pro Kampagne etwas anders zu: rejected und blocked werden beide als Gesperrt importiert, inactive als Pausiert.

Groß- und Kleinschreibung spielt beim Abgleich keine Rolle. Wenn deine CSV beide Spalten hat (Konten im Übergang während der Einführung von v2), gewinnt die Spalte, die der Parser zuerst sieht.

So bleiben Slugs erhalten

Die Tracking-URL von FirstPromoter ist brand.com/?fpr={ref_id}. Rekomi erkennt fpr als einen der 21 Standard-Attributionsparameter, du musst also nichts zusätzlich konfigurieren: Jeder bestehende FirstPromoter-Link funktioniert in Rekomi sofort, sobald du das Snippet austauschst.

Der Importer liest aus jeder Zeile default_ref_id (v1) oder ref_token / ref_id (v2, Referral ID wird ebenfalls akzeptiert) und versucht, genau diesen Wert als neuen Rekomi-Slug des Affiliates zu registrieren. Das klappt, wenn:

1. Der Wert ein gültiger Alias ist: 3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, kein Bindestrich am Anfang oder Ende.
2. Der Slug global noch frei ist.

Die Slugs von FirstPromoter sind meist kurz, kleingeschrieben und sauber aufgebaut, Kollisionen sind also selten. Das Detailfenster des Jobs listet alle Zeilen, die auf neue zufällige Slugs zurückgefallen sind.

Umstellung Schritt für Schritt

1. API-Abruf ausführen

Kopiere deinen API-Schlüssel und deine Account ID aus Settings → Integrations in FirstPromoter und führe den Abruf unter /dashboard/settings/migrate aus (siehe Import per API oben). Ein Durchlauf bringt deine Liste, deine Leads und deine Historie.

Wenn du stattdessen den CSV-Ausweichweg nutzt: Exportiere aus dem Tab Promoters (NICHT aus Reports; der Reports-Export lässt Promoter weg, die noch keinen Referral gebracht haben) und lade die Datei hoch. Der Importer erkennt anhand der vorhandenen Spalten automatisch, ob es v1 oder v2 ist.

2. Automatische Benachrichtigung aktivieren (nur Growth+)

Hake Affiliates nach dem Import benachrichtigen an und schreib eine persönliche Notiz. Klicke auf Beispiel an mich selbst senden, um eine Vorschau zu verschicken, und lass dann den Massenversand mit 1 E-Mail pro Sekunde laufen.

3. Tracking-Snippet austauschen

Installiere das Tracking-Snippet von Rekomi und entferne das Snippet von FirstPromoter. fpr gehört bereits zu den Standard-Attributionsparametern von Rekomi, deshalb wird jeder bestehende Link wie brand.com/?fpr=alex über Rekomi zugeordnet, sobald der Austausch live ist.

4. FirstPromoter kündigen

Lass FirstPromoter noch 24 bis 48 Stunden parallel laufen, wenn du die Zahlen vergleichen willst, und kündige es dann.

v1 oder v2: Welche Version nutze ich?

FirstPromoter wurde im September 2025 von SpringWater Capital übernommen. Die neu gestaltete v2-Oberfläche wurde ab Ende 2025 ausgerollt, und die Einführung zog sich bis Anfang 2026. Welches Exportformat du hast, siehst du, wenn du die CSV öffnest:

• Das v1-Format hat eine Spalte status (approved / pending / denied / blocked) und eine Spalte default_ref_id.
• Das v2-Format hat eine Spalte state (accepted / not_set / rejected / inactive) und eine Spalte ref_id.

Im Rekomi-Importer musst du nichts anders machen, er erkennt das Format automatisch. Wichtig wird es erst, wenn du hinterher prüfst, ob der Import richtig gelandet ist: Ist deine CSV v2, steht bei abgelehnten Affiliates in der Quellspalte „rejected“ und nicht „denied“.

Was NICHT importiert wird

Typische Stolperfallen

Mein Export aus Reports hat weniger Zeilen als erwartet. Du hast aus Reports statt aus Promoters exportiert. Der Tab Reports lässt Promoter ohne Referrals weg. Exportiere erneut über Promoters → Export.

Manche Zeilen haben status, andere state. Das passiert während der Einführung von v2, wenn FirstPromoter nur einen Teil deines Kontos umgestellt hat. Der Importer kommt damit klar: Beide Spalten werden korrekt ausgelesen.

Promo-Codes aus promo_code werden nicht übernommen. Richtig: Der Importer übernimmt derzeit keine Promo-Codes. Lege sie in der Oberfläche für Gutscheincodes von Rekomi neu an; Rekomi ordnet Einlösungen automatisch dem Affiliate zu, für den der Gutschein erstellt wurde.

Meine PayPal-E-Mails unterscheiden sich von den Affiliate-E-Mails. Das ist kein Problem. paypal_email bleibt getrennt von email erhalten. Auszahlungen gehen an die PayPal-Adresse; für die Anmeldung im Konto gilt die normale E-Mail.

Prüfen, ob der Import sauber durchgelaufen ist

Nachdem der Job abgeschlossen ist:

1. Öffne /dashboard/affiliates und prüfe stichprobenartig 3 bis 5 Zeilen.
2. Prüfe, ob der Tracking-Link eines Affiliates brand.com/?fpr={ref_id} lautet und zur Referral-ID in der Quelle passt.
3. Schick dir eine Beispielbenachrichtigung.
4. Klicke bei live geschaltetem neuem Snippet auf deinen eigenen Testlink und prüfe, ob eine Klickzeile erscheint.

Starte dann die automatische Massenbenachrichtigung und kündige FirstPromoter.

Historie und Einnahmen importieren

Der API-Abruf importiert deine Provisionshistorie (und Leads) bereits als gesperrte, abgerechnete Datensätze. Nutze stattdessen den CSV-Ablauf aus Schritt 2, wenn du eine Exportdatei mit Referrals oder Provisionen hast oder wenn unbezahlte Provisionen in Rekomi auszahlbar werden sollen: Nur der CSV-Ablauf zeigt vorab das genaue unbezahlte Guthaben und bittet dich, es zu autorisieren.

• Frühere Conversions und Provisionen werden dem Affiliate per E-Mail (oder über den erhaltenen Slug) zugeordnet und mit Betrag und Datum aus deinem Export erfasst.
• Provisionen, die FirstPromoter bereits ausgezahlt hat, werden als gesperrte Historie importiert (in den Summen seit Beginn sichtbar, nie erneut ausgezahlt). Noch offene Provisionen werden nur dann für eine Rekomi-Auszahlung vorgemerkt, wenn du das auf dem Vorschaubildschirm autorisierst.
• Wenn dein Export die Stripe-Kunden- oder Abo-ID eines Kunden enthält und dein Stripe verbunden ist, werden bestehende Abonnements bei Verlängerungen weiter demselben Affiliate gutgeschrieben.
• Eine Vorschau im Probelauf zeigt, was importiert wird (und genau wie viel Rekomi gegebenenfalls auszahlen würde), bevor du bestätigst. Ein erneuter Durchlauf ist sicher. Abgelehnte und erstattete Zeilen werden übersprungen.

Die vollständige Referenz findest du im Migrationsüberblick.

Wie es weitergeht

• Tracking und Attribution: fpr und die anderen 18 Standardparameter.
• Gutscheincodes: Promo-Codes aus FirstPromoter neu anlegen, mit Stripe-Gutscheinen, die pro Affiliate erstellt werden.
• Umzug von anderen Plattformen: die Übersicht, welche URLs erhalten bleiben.
• Rekomi vs. FirstPromoter: Vergleich nebeneinander, falls du noch am Abwägen bist.