Umzug von ReferralCandy

Diese Anleitung ist für Marken, die von ReferralCandy (einschließlich seiner Affiliate-Erweiterung Boost by ReferralCandy) zu Rekomi wechseln. Der Hauptweg ist ein API-Abruf mit zwei Schlüsseln (Access ID und Secret); als Ausweichweg dient eine CSV aus dem Export, den du per E-Mail bekommst.

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)

1. Öffne in ReferralCandy Account, Profile, API Tokens und kopiere deine Access ID und dein Secret.
2. Öffne /dashboard/settings/migrate, wähle ReferralCandy, wähle deine Zielkampagne in Rekomi und füge beide Werte ein. Sie werden einmal im Arbeitsspeicher verwendet und nie gespeichert, protokolliert oder wieder angezeigt.
3. Klicke auf Von ReferralCandy abrufen.

Das importiert der Abruf:

• Nur die Liste: E-Mail, Name und Status. Die ReferralCandy-API gibt an ihren Endpunkten für Referrals und Rewards überhaupt keine Geld- oder Provisionsbeträge heraus, deshalb versucht der API-Abruf gar nicht erst, eine Conversion- oder Provisionshistorie zu importieren. Er bringt die Affiliate-Liste herüber.

Die Kontaktliste enthält keinen Teilnahmestatus und kann Kunden umfassen, die nie jemanden empfohlen haben. Kontakte werden deshalb als Ausstehend importiert, damit du sie prüfen und gesammelt freigeben kannst; abgemeldete Kontakte landen als Pausiert. Gib deine echten Fürsprecher nach dem Abruf über die Sammelaktion für den Status in /dashboard/affiliates frei.

Weil hinter der API keine Historiendaten stehen, nutze den CSV-Ablauf aus Schritt 2 (unten), wenn frühere Provisionen in Rekomi erscheinen sollen.

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

Die CSV als Ausweichweg

Den Export unter Contacts, Export in ReferralCandy (oder den Export Advocates/Affiliates einer Kampagne) bekommst du per E-Mail, nicht als direkten Download: Das Erstellen kann bis zu 30 Minuten dauern, der Download-Link läuft nach 6 Stunden ab, und jeder Export umfasst höchstens 10,000 Kontakte. Der Importer ordnet die Spalten für E-Mail, Name und Status tolerant zu.

Was der CSV-Importer übernimmt

Status-Zuordnung

Nach dem Import kannst du jede Zeile in /dashboard/affiliates über die Sammelaktion für den Status neu einstufen.

So bleiben Slugs erhalten

ReferralCandy stellt zum Teilen gehostete Kurzlinks unter refr.cc aus, und die lassen sich nicht zu Rekomi mitnehmen: Die Kurzlink-Domain eines Drittanbieters kann man nicht umleiten. Die Slug-Erhaltung wird für ReferralCandy nicht unterstützt; importierte Affiliates bekommen einen neuen Rekomi-Slug.

Gutscheincodes im Shop sind eine andere Sache. Die Gutscheincodes von ReferralCandy mit dem Präfix FRIEND (zum Beispiel FRIEND-A1B2C3) sind echte Shopify-Rabattcodes. In Shopify-Shops schreiben sie deshalb weiter dem richtigen Affiliate gut, sobald du sie als Rekomi-Gutscheine neu zuordnest, auch wenn der refr.cc-Link selbst wegfällt.

Umstellung Schritt für Schritt

1. API-Abruf ausführen (Liste) oder die CSV aus der E-Mail hochladen

Erstelle in ReferralCandy unter Account, Profile, API Tokens API-Zugangsdaten und führe den Abruf unter /dashboard/settings/migrate aus, oder fordere den Export per E-Mail an und lade ihn hoch, sobald er da ist.

2. FRIEND-Gutscheincodes neu zuordnen (nur Shopify)

Wenn dein Shop auf Shopify läuft, ordne den FRIEND-Gutscheincode jedes Affiliates als Rekomi-Gutscheincode neu zu, damit er nach der Umstellung weiter dem richtigen Affiliate gutschreibt.

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 ReferralCandy. Lass ReferralCandy noch 24 bis 48 Stunden parallel laufen und kündige es dann.

Was NICHT importiert wird

Typische Stolperfallen

Keine Beträge in der API. Die Endpunkte für Referrals und Rewards von ReferralCandy liefern Status und Gutscheincodes, aber nie einen Betrag. Wenn du historische Provisionen in Rekomi brauchst, bereite aus deinen eigenen Aufzeichnungen eine CSV für Schritt 2 vor, statt darauf zu setzen, dass der API-Abruf sie bringt.

Verzögerung und Obergrenze beim Export per E-Mail. Der CSV-Export ist kein sofortiger Download: Rechne mit bis zu 30 Minuten, bis er ankommt, lade ihn herunter, bevor der Link nach 6 Stunden abläuft, und teile Konten mit mehr als 10,000 Kontakten auf mehrere Exporte auf.

Nur Geld-Rewards. Wenn dein ReferralCandy-Programm Shop-Guthaben statt Geld auszahlt, haben diese Rewards keine Entsprechung als Provision in Rekomi und tauchen in keinem Import auf.

Prüfen, ob der Import sauber durchgelaufen ist

1. Öffne /dashboard/affiliates und vergleiche stichprobenartig 3 bis 5 Zeilen mit den Daten in ReferralCandy.
2. Prüfe unter /dashboard/coupons, ob die neu zugeordneten FRIEND-Gutscheincodes aktiv sind (Shopify-Shops).
3. Schick dir eine Beispielbenachrichtigung, bevor du den Massenversand startest.

Historie und Einnahmen importieren

Weil der API-Abruf nur die Liste bringt, ist Schritt 2 der einzige Weg, die Historie und die Einnahmen aus ReferralCandy zu Rekomi zu holen. Bereite aus deinen eigenen Aufzeichnungen zu Geld-Rewards 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

• Gutscheincodes: FRIEND-Codes für Shopify-Shops als Rekomi-Gutscheine neu zuordnen.
• 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.