Umzug von Rewardful

Diese Anleitung ist für Marken, die von Rewardful zu Rekomi wechseln. Der Hauptweg ist ein API-Abruf mit einem einzigen Schlüssel: Füge dein Rewardful-API-Secret ein, und Rekomi importiert in einem Durchgang deine Affiliate-Liste (jedes bestehende ?via=-Token bleibt erhalten, die Besucherzahlen seit Beginn werden übernommen), deine Leads und deine Provisionshistorie. Ein CSV-Upload bleibt als zweiter Weg für Dateien, die der Support bereitstellt.

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)

Rewardful hat keinen CSV-Export zum Selbermachen für Affiliates, Referrals oder Provisionen (nur die Datei mit fälligen Auszahlungen lässt sich im Dashboard herunterladen; alles andere läuft über den Support). Der API-Abruf ist deshalb der einfachste und zugleich der vollständigste Weg.

1. Öffne in Rewardful die Company Settings und kopiere deinen geheimen API-Schlüssel.
2. Öffne /dashboard/settings/migrate, wähle Rewardful, wähle deine Zielkampagne in Rekomi und füge den Schlüssel ein. Er wird einmal im Arbeitsspeicher verwendet und nie gespeichert, protokolliert oder wieder angezeigt.
3. Lass die Schalter Leads importieren und Provisionshistorie importieren eingeschaltet (oder schalte einen davon aus) und klicke auf Von Rewardful abrufen.

Das importiert der Abruf:

• Affiliates: E-Mail, Name, Status (active wird als Freigegeben importiert, disabled als Gesperrt, suspicious als Pausiert zur Prüfung), die Auszahlungs-E-Mail für PayPal oder Wise und das ?via=-Token, das als Slug des Rekomi-Links erhalten bleibt, damit bestehende Links weiter funktionieren. Affiliates mit mehreren Rewardful-Links bekommen EINEN Rekomi-Link (ihr erstes Token); die Importzusammenfassung sagt dir, wie viele das betrifft.
• Klickzahlen: Die Gesamtzahl visitors jedes Affiliates wird in seinen Klickzähler in Rekomi übernommen, damit Ranglisten und die EPC-Rechnung nicht auf null zurückfallen.
• Leads: Referrals im Rewardful-Status lead (registriert, nie gekauft) werden als Lead-Datensätze ohne Betrag importiert und ihrem Affiliate zugeordnet, mit Name, E-Mail-Adresse und Stripe-Kunden-ID des Kunden. So sind dein Funnel und deine Lead-Zahlen vom ersten Tag an gefüllt.
• Provisionshistorie: Betrag und Verkaufsbetrag jeder Provision (Rewardful gibt ganzzahlige Cent an; sie werden 1:1 als ISO-Kleinsteinheiten importiert), Währung, Datum und Status. Provisionen mit paid werden als abgerechnete Historie importiert; Provisionen mit pending oder due ebenfalls als gesperrte Datensätze (durch den API-Abruf wird nichts auszahlbar); Provisionen mit voided werden übersprungen. Die Stripe-Kunden-IDs werden mitgenommen, damit bestehende Abonnements bei Verlängerungen weiter an denselben Affiliate zahlen. Provisionen in ISK, UGX oder MGA werden übersprungen und im Ergebnis des Abrufs als UnsupportedRepresentationRows gemeldet, weil Rewardful nicht dokumentiert, ob diese drei Codes in der Stripe-Darstellung oder in ISO-Einheiten ankommen; wende dich für diese Zeilen an den Support.

Das kann der Abruf nicht importieren: auszahlbare Guthaben (nutze den CSV-Ablauf aus Schritt 2 mit seiner Vorschau, wenn unbezahlte Provisionen auszahlbar werden sollen), die Kampagnenstruktur, Provisionssätze pro Affiliate und Protokolle einzelner Klicks (Rewardful stellt nur Summen bereit). Jede Liste wird mit bis zu 5,000 Zeilen abgerufen, und Rewardful begrenzt die Anfragen an seine API (etwa 45 Anfragen pro 30 Sekunden). Ein großer Abruf kann deshalb ein bis zwei Minuten dauern; das Ergebnis sagt dir, ob ein Abruf abgeschnitten wurde.

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

Die CSV als Ausweichweg

Wenn dir der Rewardful-Support bereits einen Datenexport per E-Mail geschickt hat (hello@getrewardful.com stellt einen auf Anfrage bereit), nimmt ihn der CSV-Importer unten weiterhin an.

Was der CSV-Importer übernimmt

Eine Spalte mit der Wise-Auszahlungs-E-Mail und eine Summenspalte Visitors oder Clicks werden ebenfalls importiert, wenn sie vorhanden sind; alles andere in der Affiliate-CSV (Kampagnen-IDs, eigene Felder, Umsatzsummen) ignoriert der Listenimporter. Historische Verkäufe und Provisionen holst du mit der separaten Referrals-CSV in Schritt 2 herüber (siehe Historie und Einnahmen importieren).

Status-Zuordnung

Die Statuswerte von Rewardful werden auf die Status in Rekomi abgebildet. Der Importer liest zuerst eine Spalte state und greift sonst auf status zurück:

Groß- und Kleinschreibung spielt beim Abgleich keine Rolle. Freigegebene Importe bekommen einen Zeitstempel ApprovedAt mit dem Importzeitpunkt, damit die Berechnung der Auszahlungsberechtigung korrekt funktioniert.

So bleiben Slugs erhalten

Das ist der Teil, auf den es bei den meisten Umzügen von Rewardful ankommt: Deine Affiliates müssen keine neuen Links teilen.

Die Tracking-URL von Rewardful ist brand.com/?via={token}. Die Standard-Tracking-URL von Rekomi ist ebenfalls brand.com/?via={slug}; via ist einer der eingebauten Attributionsparameter von Rekomi und wird deshalb von Haus aus erkannt. Der Importer liest aus jeder Zeile die Token-Spalte (Einzahl oder Mehrzahl; bei Zellen mit mehreren Werten zählt der erste Eintrag), greift sonst auf die Spalte mit Link oder URL zurück und versucht, genau diese Zeichenfolge als Rekomi-Slug des neuen Affiliates zu registrieren.

Der Slug bleibt genau dann erhalten, wenn:

1. Der token-Wert ein gültiger Alias ist: 3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, kein Bindestrich am Anfang oder Ende.
2. Der Slug im globalen Rekomi-Namensraum noch frei ist (Slugs sind plattformweit eindeutig, nicht pro Organisation).

Wenn beide Bedingungen erfüllt sind, funktioniert jeder bestehende Link wie brand.com/?via=alex in Rekomi weiter, sobald du das Tracking-Snippet austauschst. Fehlt in einer Zeile das Feld token, liest der Importer den Slug stattdessen aus der Spalte link (er zieht den Query-Parameter ?via= heraus). Fehlt beides, bekommt der Affiliate einen neuen zufälligen Slug mit 12 Zeichen: Sein alter Link funktioniert dann nicht mehr, sein Konto wird aber trotzdem importiert.

Kollisionen werden im Ergebnis des Importjobs pro Zeile protokolliert. Wenn dasselbe token in zwei Rewardful-Workspaces vorkommt, die in eine Rekomi-Organisation umziehen, bekommt der zweite Eintrag einen neuen Slug. In der Detailansicht des Jobs siehst du, welche Slugs erhalten blieben und welche neu erzeugt wurden.

Umstellung Schritt für Schritt

1. API-Abruf ausführen

Kopiere deinen geheimen API-Schlüssel in Rewardful unter Company Settings und führe den Abruf unter /dashboard/settings/migrate aus (siehe Import per API oben). Ein Durchgang bringt deine Liste, Leads und Historie. Wenn du stattdessen eine CSV vom Support hast, lade sie über die eingeklappte CSV-Option auf derselben Karte hoch.

2. Attributionsparameter: für via nichts zu konfigurieren

via ist einer der 21 eingebauten Attributionsparameter von Rekomi und wird immer erkannt; du musst nichts konfigurieren, und genau deshalb führen die importierten Links zu den richtigen Affiliates. Wenn deine Affiliates auch Links mit einem anderen eigenen Parameter teilen, füge diesen Parameter unter /dashboard/settings/attribution hinzu.

3. Importergebnis prüfen

Der Import läuft synchron und zeigt das Ergebnis Zeile für Zeile: importiert, übersprungen (Duplikat oder fehlende E-Mail) oder fehlerhaft (Lesefehler). Jeder Job steht in der Importhistorie, mit einer Detailansicht pro Zeile und dem Button Rückgängig.

4. Automatische Benachrichtigung aktivieren (nur Growth+)

Hake Affiliates nach dem Import benachrichtigen an und schreib im Rich-Text-Editor eine kurze persönliche Notiz (etwa 500 sichtbare Zeichen). Die Notiz erscheint oben in jeder Benachrichtigungs-E-Mail als Zitatblock in deiner Markenfarbe, über einem einzigen Button Konto übernehmen, der den Affiliate zu einer vorausgefüllten Registrierung bei Clerk führt.

Klicke auf Beispiel an mich selbst senden, um dir vor dem Massenversand eine Vorschau an deine eigene bestätigte E-Mail-Adresse zu schicken. Der Massenversand ist auf eine E-Mail pro Sekunde gedrosselt, mit bis zu 200ms zufälliger Verzögerung (Jitter); ein Import mit 500 Zeilen braucht von Anfang bis Ende etwa 8 Minuten.

5. Tracking-Snippet austauschen

Installiere das Tracking-Snippet von Rekomi auf deiner Marketing-Website und entferne dann das Rewardful-Snippet. Sobald das neue Snippet live ist, wird jeder bestehende Link wie brand.com/?via=alex über Rekomi statt über Rewardful zugeordnet. Deine Affiliates müssen von der Umstellung nichts wissen.

Lass Rewardful noch 24 bis 48 Stunden parallel laufen, um beide Seiten zu vergleichen, wenn du auf Nummer sicher gehen willst, und kündige Rewardful dann.

Was NICHT importiert wird

Für historische Verkäufe und Provisionen brauchst du keine Hilfe mehr: Importiere sie selbst über Schritt 2 (bezahlte Zeilen werden als Historie gesperrt, unbezahlte werden nur ausgezahlt, wenn du das autorisierst).

Typische Stolperfallen

In meinem Export fehlt die Spalte token. Ältere Rewardful-Exporte enthalten kein token; der Importer liest ?via= dann automatisch aus der Spalte link. Du musst nichts tun.

Der Slug eines Affiliates kollidiert mit dem einer anderen Organisation. Global gesehen selten, aber möglich. Die Zeile bekommt einen neuen zufälligen Slug, und der alte Link des Affiliates funktioniert nicht mehr. Er wird trotzdem importiert und kann ganz normal benachrichtigt werden; schreib in deine Benachrichtigung einfach einen Hinweis wie „Deinen neuen Link findest du in deinem Dashboard unter /a“.

Meine Affiliates nutzen ?ref= statt ?via=. Du musst nichts tun: ref ist ebenfalls einer der Standard-Attributionsparameter von Rekomi, und der Importer liest sowohl ?via= als auch ?ref= aus der Spalte link, wenn token leer ist.

Ich habe archivierte Rewardful-Affiliates. Sie kommen standardmäßig als Freigegeben herüber, wenn status fehlt. Setze sie nach dem Import in /dashboard/affiliates über die Sammelaktion für den Status in einem Durchgang auf Abgelehnt oder Gesperrt.

Prüfen, ob der Import sauber durchgelaufen ist

Wenn der Importjob abgeschlossen ist:

1. Öffne /dashboard/affiliates und prüfe stichprobenartig 3 bis 5 Zeilen. Prüfe, ob Name, E-Mail und Status mit den Daten in Rewardful übereinstimmen.
2. Öffne die Detailseite eines Affiliates und prüfe, ob der Tracking-Link brand.com/?via={original-token} lautet.
3. Schick dir eine Beispielbenachrichtigung und prüfe, ob der Button Konto übernehmen zur vorausgefüllten Registrierung bei Clerk führt.
4. Klicke bei installiertem neuem Snippet auf deinen eigenen Affiliate-Testlink und prüfe, ob innerhalb weniger Sekunden eine Klickzeile bei diesem Affiliate erscheint.

Wenn die Schritte 1 bis 4 alle klappen, starte den Massenversand der automatischen Benachrichtigung und kündige Rewardful, sobald du dich sicher fühlst.

Historie und Einnahmen importieren

Der API-Abruf importiert deine Provisionshistorie (und die Leads) bereits als gesperrte, abgerechnete Datensätze. Nutze stattdessen den CSV-Ablauf aus Schritt 2, wenn du einen Referrals-Export vom Support hast oder wenn unbezahlte Provisionen in Rekomi auszahlbar werden sollen: Nur der CSV-Ablauf zeigt dir das genaue unbezahlte Guthaben in einer Vorschau und bittet dich, es zu autorisieren. Die Referral-Daten von Rewardful sind die umfangreichsten aller Quellen: Sie enthalten E-Mail-Adresse des Kunden, stripe_customer_id, Verkaufsbetrag, Provision, Status und Erstellungsdatum.

• Frühere Conversions und Provisionen werden dem Affiliate über die E-Mail-Adresse (oder den erhaltenen Slug) zugeordnet und mit Betrag und Datum aus deinem Export erfasst.
• Provisionen, die Rewardful bereits ausgezahlt hat, werden als gesperrte Historie importiert (sie zählen in den Gesamtwerten mit und werden nie erneut ausgezahlt). Noch offene Provisionen werden nur dann für eine Rekomi-Auszahlung eingeplant, wenn du das auf dem Vorschaubildschirm autorisierst.
• Weil Rewardful die stripe_customer_id exportiert, zahlen bestehende Abonnements bei Verlängerungen weiter an denselben Affiliate, sobald dein Stripe-Konto verbunden ist.
• Eine Vorschau im Probelauf zeigt dir, was importiert wird (und genau wie viel Rekomi auszahlen würde, falls überhaupt etwas), bevor du bestätigst. Ein erneuter Lauf ist sicher. Stornierte und erstattete Zeilen werden übersprungen.

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

Wie es weitergeht

• Tracking und Attribution: Attributionsparameter anpassen, Cookie-Laufzeit und Stickiness (Bindung eines Kunden an einen Affiliate) einstellen.
• Umzug von anderen Plattformen: die umfassende Matrix zur URL-Erhaltung, falls du auch Affiliates auf anderen Plattformen hast.
• Pläne und Testphasen: was jede Stufe enthält und wie die 14-tägige kostenlose Testphase funktioniert.
• Rekomi vs. Rewardful: der direkte Funktionsvergleich, falls du noch am Abwägen bist.