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.
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.
Import per API (empfohlen)
- Ö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.
- Ö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. - Klicke auf Von Refersion abrufen.
Das importiert der Abruf:
- Affiliates: E-Mail, Name und Status (
ACTIVEwird als Freigegeben importiert,Pendingals Ausstehend,Deniedals 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
| Feld | Quellspalte | Hinweise |
|---|---|---|
beste Übereinstimmung mit email | Pflichtfeld. Kleingeschrieben und getrimmt. Primärer Schlüssel für die Duplikatprüfung. | |
| Vollständiger Name | beste Übereinstimmung mit first_name + last_name | Wird zusammengesetzt, wenn beide vorhanden sind. |
| Status | beste Übereinstimmung mit einer Statusspalte | Siehe Zuordnungstabelle unten. |
| Tracking-Slug | ?rfsn= aus einer Link-Spalte, falls vorhanden | Fehlt der Wert, wird ein neuer Slug erzeugt. |
Status-Zuordnung
| Refersion | Rekomi |
|---|---|
| Active / Approved | Freigegeben |
| Pending | Ausstehend |
| Denied | Abgelehnt |
| alles andere, leer oder fehlend | Ausstehend |
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
| Daten | Status | Lösung |
|---|---|---|
| Conversion- und Bestellhistorie | Von der REST-API von Refersion nicht bereitgestellt | Nutze den CSV-Ablauf aus Schritt 2 mit den allgemeinen Spalten (E-Mail des Affiliates, Betrag, Provision, Währung, Datum). |
| Gutscheinzuweisungen | Nicht importiert | Erstelle 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
- Öffne
/dashboard/affiliatesund vergleiche stichprobenartig 3 bis 5 Zeilen mit den Daten in Refersion. - Öffne die Detailseite eines Affiliates und prüfe, ob der
rfsn-Slug erhalten geblieben ist (der vollständige Wertid.code). - Klicke bei installiertem neuem Snippet auf einen bestehenden
?rfsn=-Link eines Affiliates und prüfe, ob innerhalb weniger Sekunden eine Klickzeile erscheint. - 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
- Tracking und Attribution: der Parameter
rfsn, die Cookie-Laufzeit und die Stickiness (Bindung eines Kunden an einen Affiliate). - Umzug von anderen Plattformen: die umfassende Matrix zur URL-Erhaltung.
- Pläne und Testphasen: was jede Stufe enthält und wie die 14-tägige kostenlose Testphase funktioniert.
Umzug von ReferralCandy
Bring eine ReferralCandy-Affiliate-Liste per API-Abruf zu Rekomi. Die ReferralCandy-API gibt keine Provisionsbeträge heraus, deshalb importiert der Abruf nur die Liste; FRIEND-Gutscheincodes schreiben in Shopify-Shops weiter gut.
Umzug von BixGrow
Bring eine BixGrow-Affiliate-Liste per CSV-Export zu Rekomi. bg_ref-Tracking-Links bleiben erhalten, und Gutscheincodes schreiben weiter gut, weil sie echte Shopify-Rabatte sind.