Rekomi Docs
Für MarkenVon einer anderen Plattform wechseln
Brands

Umzug von Refersion

Bring eine Refersion-Affiliate-Liste per API-Abruf mit zwei Schlüsseln zu Rekomi. rfsn-Tracking-Links bleiben erhalten; die Conversion-Historie kommt über den CSV-Ablauf aus Schritt 2.

Refersion-Logo

Diese Anleitung ist für Marken, die von Refersion zu Rekomi wechseln. Der Hauptweg ist ein API-Abruf mit zwei Schlüsseln; als Ausweichweg dient eine CSV aus dem Export, den Refersion dir per E-Mail schickt.

Die meisten Teams schaffen die Umstellung an einem einzigen Nachmittag. Der Umzug ist ab Starter verfügbar, die automatische Benachrichtigung ab Growth.

  1. Öffne in Refersion Account, Settings, Refersion API und kopiere deinen Public Key und deinen Secret Key. Für den API-Zugriff brauchst du bei Refersion den Growth-Plan oder höher.
  2. Öffne /dashboard/settings/migrate, wähle Refersion, wähle deine Zielkampagne in Rekomi und füge beide Schlüssel ein. Sie werden einmal im Arbeitsspeicher verwendet und nie gespeichert, protokolliert oder wieder angezeigt.
  3. Klicke auf Von Refersion abrufen.

Das importiert der Abruf:

  • Affiliates: E-Mail, Name und Status (ACTIVE wird als Freigegeben importiert, Pending als Ausstehend, Denied als Abgelehnt).
  • Tracking-Link: Der Refersion-Link trägt ?rfsn={affiliateId}.{affiliateCode}, zum Beispiel ?rfsn=123456.abc123. Rekomi übernimmt den vollständigen Wert {affiliate_id}.{code} als Slug, nicht nur einen Teil davon, deshalb funktionieren bestehende Links weiter.

Die REST-API von Refersion gibt keine Conversion- oder Bestellhistorie heraus, deshalb bringt der API-Abruf keine historischen Conversions herüber; nutze dafür den CSV-Ablauf aus Schritt 2 (unten).

Den Abruf erneut auszuführen ist sicher: Affiliates werden über die E-Mail-Adresse dedupliziert.

Die CSV als Ausweichweg

Den Dashboard-Export von Refersion bekommst du per E-Mail. Der Importer ordnet die Spalten für E-Mail, Name und Status tolerant zu.

Was der CSV-Importer übernimmt

FeldQuellspalteHinweise
E-Mailbeste Übereinstimmung mit emailPflichtfeld. Kleingeschrieben und getrimmt. Primärer Schlüssel für die Duplikatprüfung.
Vollständiger Namebeste Übereinstimmung mit first_name + last_nameWird zusammengesetzt, wenn beide vorhanden sind.
Statusbeste Übereinstimmung mit einer StatusspalteSiehe Zuordnungstabelle unten.
Tracking-Slug?rfsn= aus einer Link-Spalte, falls vorhandenFehlt der Wert, wird ein neuer Slug erzeugt.

Status-Zuordnung

RefersionRekomi
Active / ApprovedFreigegeben
PendingAusstehend
DeniedAbgelehnt
alles andere, leer oder fehlendAusstehend

Abgelehnte Affiliates können sich bei Refersion nicht erneut bewerben, deshalb werden sie in Rekomi als Abgelehnt importiert, passend zu ihrem endgültigen Status.

So bleiben Slugs erhalten

Der Tracking-Link von Refersion trägt den Empfehlungswert als ?rfsn={affiliateId}.{affiliateCode}. rfsn ist ein eingebauter Attributionsparameter von Rekomi, und Rekomi übernimmt den vollständigen Wert, also die numerische Affiliate-ID und den Code, statt nur des Code-Teils. Deshalb werden bestehende Refersion-Links in Rekomi weiter richtig zugeordnet, sobald du das Tracking-Snippet austauschst, sofern die Zeile beim Import erreicht wurde.

Umstellung Schritt für Schritt

1. API-Abruf ausführen

Erstelle in Refersion unter Account, Settings, Refersion API einen Public Key und einen Secret Key und führe den Abruf unter /dashboard/settings/migrate aus.

2. Attributionsparameter: nichts zu konfigurieren

rfsn ist ein eingebauter Attributionsparameter von Rekomi, deshalb führen bestehende ?rfsn=-Links ohne jede Konfiguration zum richtigen Affiliate.

3. Importergebnis prüfen

Der Import läuft synchron und zeigt das Ergebnis Zeile für Zeile. Jeder Job steht in der Importhistorie und lässt sich dort mit Rückgängig zurücknehmen.

4. Automatische Benachrichtigung aktivieren (nur Growth+)

Schick den importierten Affiliates einen Link, über den sie ihr Konto beanspruchen und ihre Auszahlungen in Rekomi einrichten. Schick dir vorher selbst ein Beispiel.

5. Tracking-Snippet austauschen

Installiere das Tracking-Snippet von Rekomi und entferne dann das Skript von Refersion. Bestehende ?rfsn=-Links werden ab sofort über Rekomi zugeordnet. Lass Refersion noch 24 bis 48 Stunden parallel laufen und kündige es dann.

Was NICHT importiert wird

DatenStatusLösung
Conversion- und BestellhistorieVon der REST-API von Refersion nicht bereitgestelltNutze den CSV-Ablauf aus Schritt 2 mit den allgemeinen Spalten (E-Mail des Affiliates, Betrag, Provision, Währung, Datum).
GutscheinzuweisungenNicht importiertErstelle neue Gutscheincodes in Rekomi.

Typische Stolperfallen

Beide Schlüssel sind nötig. Der API-Abruf aus Refersion braucht den Public Key und den Secret Key zusammen; ein einzelner Schlüssel reicht nicht.

Die API hängt am Plan. Die Refersion-API setzt den Growth-Plan oder höher voraus. Wenn dein Konto keinen API-Zugriff hat, nutze stattdessen den CSV-Export per E-Mail.

Keine Historie über die API. Die REST-API von Refersion hat keinen Endpunkt für Conversion-Listen, deshalb bringt der API-Abruf, was die Historie angeht, nur die Liste. Für historische Conversions bereite aus deinen eigenen Aufzeichnungen eine CSV für Schritt 2 vor.

Prüfen, ob der Import sauber durchgelaufen ist

  1. Öffne /dashboard/affiliates und vergleiche stichprobenartig 3 bis 5 Zeilen mit den Daten in Refersion.
  2. Öffne die Detailseite eines Affiliates und prüfe, ob der rfsn-Slug erhalten geblieben ist (der vollständige Wert id.code).
  3. Klicke bei installiertem neuem Snippet auf einen bestehenden ?rfsn=-Link eines Affiliates und prüfe, ob innerhalb weniger Sekunden eine Klickzeile erscheint.
  4. Schick dir eine Beispielbenachrichtigung, bevor du den Massenversand startest.

Historie und Einnahmen importieren

Weil der API-Abruf keine Conversion-Historie enthält, ist Schritt 2 der Weg, die früheren Conversions aus Refersion zu Rekomi zu holen. Bereite aus deinen eigenen Aufzeichnungen eine CSV mit den allgemeinen Spalten vor (E-Mail des Affiliates, Betrag, Provision, Währung, Datum) und lade sie unter Einstellungen > Umzug > Schritt 2 hoch. Die vollständige Referenz findest du im Migrationsüberblick.

Wie es weitergeht