Umzug von Tolt

Diese Anleitung ist für Marken, die von Tolt zu Rekomi wechseln. Tolt ist eine Affiliate-Plattform für SaaS-Startups, die direkt auf Stripe, Paddle und Chargebee aufsetzt. Der Hauptweg ist ein API-Abruf mit einem einzigen Schlüssel: Füge deinen Tolt-API-Schlüssel ein, und Rekomi importiert in einem Durchgang deine Partnerliste (mit dem Link-Slug und der Klickzahl seit Beginn jedes Partners), deine Leads und deine Provisionshistorie.

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)

Das Tolt-Dashboard hat überhaupt keinen CSV-Export für Partner, Kunden oder Provisionen (die einzige CSV im Dashboard ist die Auszahlungsdatei im Vorlagenformat für PayPal/Wise), deshalb ist der API-Abruf der einzige vollständige Migrationsweg.

1. Öffne im Tolt-Dashboard Settings → API und kopiere deinen API-Schlüssel.
2. Öffne /dashboard/settings/migrate, wähle Tolt, 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 Tolt abrufen.

Das importiert der Abruf:

• Partner: E-Mail, Name, Status (Zuordnung beim API-Abruf: active wird als Freigegeben importiert, pending als Ausstehend, suspended als Pausiert, rejected als Gesperrt) und die PayPal-Auszahlungs-E-Mail, wenn Tolt sie bereitstellt.
• Link-Slugs: Tolt führt Empfehlungscodes in seiner separaten Ressource Links. Der Abruf liest deine Links deshalb direkt und übernimmt den Wert des ersten Links jedes Partners als seinen Rekomi-Slug, wenn der Wert die üblichen Slug-Prüfungen besteht (3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, noch nicht vergeben); ein Wert, der sie nicht besteht, bekommt stattdessen einen neuen Slug. Bestehende ?aff=-Links funktionieren unverändert weiter. Partner mit mehreren Tolt-Links bekommen einen Rekomi-Link; die Importzusammenfassung sagt dir, wie viele das betrifft.
• Klickzahlen: Die Gesamtzahl total_clicks jedes Partners wird in seinen Klickzähler in Rekomi übernommen, damit Ranglisten und die EPC-Rechnung nicht auf null zurückfallen.
• Leads: Kunden, die in Tolt noch den Status lead haben, werden als Lead-Datensätze ohne Betrag importiert und ihrem Partner zugeordnet, mit Name und E-Mail-Adresse des Kunden. So sind dein Funnel und deine Lead-Zahlen vom ersten Tag an gefüllt. Wenn die customer_id in Tolt eine Stripe-Kunden-ID ist, wird sie für die wiederkehrende Attribution mitgenommen.
• Provisionshistorie: Provisionen samt ihren Transaktionen (Tolt gibt ganzzahlige Cent an; sie werden 1:1 als ISO-Kleinsteinheiten importiert), mit Verkaufsbetrag, Datum und Kundenidentität aus der Transaktion. Tolt gibt nicht heraus, welche Provisionen bezahlt wurden, deshalb wird alles als abgerechnete, gesperrte Historie importiert: Durch den API-Abruf wird nichts auszahlbar. Abgelehnte Provisionen werden übersprungen.

Das kann der Abruf nicht importieren: auszahlbare Guthaben (nutze den CSV-Ablauf aus Schritt 2 mit seiner Vorschau, wenn offene Guthaben auszahlbar werden sollen), Warteschlangen mit von Hand eingereichten Leads, die Kampagnenstruktur und Protokolle einzelner Klicks (Tolt stellt nur Summen bereit). In Tolt gilt die Währung pro Programm, deshalb liest Rekomi die Währung deines Tolt-Programms und trägt sie in die importierte Historie ein; deine Heimatwährung in Rekomi wird nur verwendet, wenn sich die Programmwährung nicht lesen lässt. Wenn in deinem Tolt-Konto mehrere Programme laufen, gilt die Währung des ersten Programms für jede Zeile; prüfe bei Konten mit mehreren Währungen also die Summen. Wenn die Programmwährung (oder deine Heimatwährung, falls Tolt keine angibt) ISK, UGX oder MGA ist, werden Provisionen übersprungen und im Ergebnis des Abrufs als UnsupportedRepresentationRows gezählt, bis Tolt bestätigt, wie es diese drei Währungen darstellt; Leads werden trotzdem importiert. Jede Liste wird mit bis zu 5,000 Zeilen abgerufen; 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 Tolt.

Die CSV als Ausweichweg

Es gibt keinen Dashboard-Export zum Hochladen, aber eine vom Support bereitgestellte oder aus der API erzeugte Datei funktioniert mit dem CSV-Importer unten (Beträge müssen ganzzahlige Cent sein).

Was der CSV-Importer übernimmt

Alles andere in der Partner-CSV (Firmenname, Land, Summen) ignoriert der Listenimporter stillschweigend. Historische Verkäufe und Provisionen holst du mit dem separaten Provisionsexport in Schritt 2 herüber (siehe Historie und Einnahmen importieren).

Status-Zuordnung

Die Partnerstatus von Tolt werden auf die Affiliate-Status in Rekomi abgebildet:

Diese Tabelle gilt für die CSV als Ausweichweg. Der API-Abruf ordnet einen Status anders zu: Partner mit rejected werden als Gesperrt importiert.

Groß- und Kleinschreibung spielt beim Abgleich keine Rolle. suspended ist in Tolt eine umkehrbare, vorübergehende Deaktivierung (der Partner kann keine neuen Provisionen verdienen und das Portal nicht erreichen, bis er wieder aktiviert wird), deshalb wird der Status auf Pausiert abgebildet statt auf ein hartes Gesperrt. Nach dem Import kannst du jede Zeile in /dashboard/affiliates über die Sammelaktion für den Status neu einstufen. Freigegebene Importe bekommen einen Zeitstempel ApprovedAt mit dem Importzeitpunkt, damit die Berechnung der Auszahlungsberechtigung korrekt funktioniert.

So bleiben Slugs erhalten

Die Empfehlungslinks von Tolt nutzen den Query-Parameter ?aff=, zum Beispiel brand.com/?aff=alex. aff ist einer der eingebauten Attributionsparameter von Rekomi und funktioniert sofort, deshalb werden die bestehenden ?aff=-Links deiner Affiliates in Rekomi weiter richtig zugeordnet, sobald du das Tracking-Snippet austauschst, ganz gleich, ob der Importer den genauen Slug beibehält.

Die Slug-Erhaltung selbst geschieht bei Tolt so weit wie möglich. Tolt führt den Empfehlungscode in seiner separaten Ressource Links statt im Partner-Objekt, deshalb enthält ein CSV-Export der Partner oft gar keine Slug-Spalte. Ein Slug bleibt erhalten, wenn:

1. Der Export eine Spalte referral_code (oder ref_code / code) enthält oder eine Spalte mit dem Empfehlungslink (referral_link, affiliate_link, link, url), aus der er den ?aff=-Wert lesen kann.
2. Der Wert ein gültiger Alias ist: 3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, kein Bindestrich am Anfang oder Ende.
3. Der Slug im globalen Rekomi-Namensraum noch frei ist (Slugs sind plattformweit eindeutig, nicht pro Organisation).

Wenn alle drei Bedingungen erfüllt sind, behält der Affiliate genau seinen Slug. Enthält der Export weder einen Code noch einen lesbaren Link, bekommt der Affiliate einen neuen zufälligen Slug mit 12 Zeichen; sein Konto wird trotzdem sauber importiert. In der Detailansicht des Importjobs siehst du, welche Slugs erhalten blieben und welche neu erzeugt wurden.

Umstellung Schritt für Schritt

1. API-Abruf ausführen

Kopiere deinen API-Schlüssel in Tolt unter Settings → API und führe den Abruf unter /dashboard/settings/migrate aus (siehe Import per API oben). Ein Durchgang bringt deine Liste, Link-Slugs, Leads und Historie. In Tolt gibt es keinen Dashboard-Export; nutze die eingeklappte CSV-Option nur, wenn dir der Support eine Datei geschickt hat.

2. Attributionsparameter: für aff nichts zu konfigurieren

aff ist einer der eingebauten Attributionsparameter von Rekomi und wird immer erkannt; eigene Parameter erweitern die Liste nur, du musst also nichts konfigurieren. Genau deshalb führen die bestehenden Tolt-Links deiner Affiliates in Rekomi zum richtigen Affiliate.

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 Tolt-Snippet (tolt.js). Sobald das neue Snippet live ist, wird jeder bestehende Link wie brand.com/?aff=alex über Rekomi statt über Tolt zugeordnet. Deine Affiliates müssen von der Umstellung nichts wissen.

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

Was NICHT importiert wird

Typische Stolperfallen

Mein Export hat keine Spalte referral_code. Das ist zu erwarten: Tolt führt den Empfehlungscode in seiner Ressource Links, nicht im Partner-Objekt. Affiliates, deren Code nicht in der Datei steht, bekommen einen neuen Rekomi-Slug, aber ihre bestehenden ?aff=-Links werden weiter zugeordnet, weil aff ein bekannter Attributionsparameter ist. Wenn du die genauen Slugs erhalten willst, füge dem Export vor dem Download eine Spalte mit Empfehlungslink oder Code hinzu (falls dein Tolt-Plan das kann).

Ein Partner ist in Tolt suspended. Er wird als Pausiert importiert (nicht als Gesperrt), weil suspended in Tolt umkehrbar ist. Aktiviere ihn wieder oder stufe ihn über die Sammelaktion für den Status in /dashboard/affiliates neu ein.

Meine Affiliates nutzen ein Portal mit eigener Domain. Das gebrandete Portal von Tolt (z. B. affiliates.yourbrand.com) wird durch den Affiliate-Bereich von Rekomi ersetzt, sobald der Affiliate sein Konto beansprucht; seine ?aff=-Empfehlungslinks sind davon nicht betroffen.

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 Tolt übereinstimmen.
2. Öffne die Detailseite eines Affiliates und prüfe, ob der Tracking-Link vorhanden ist (der ursprüngliche ?aff=-Slug, wenn er erhalten blieb, sonst ein neuer Rekomi-Slug).
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 einen bestehenden ?aff=-Link eines Affiliates 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 Tolt, 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 eine Provisionsdatei vom Support hast oder wenn offene Guthaben in Rekomi auszahlbar werden sollen: Nur der CSV-Ablauf zeigt dir das genaue unbezahlte Guthaben in einer Vorschau und bittet dich, es zu autorisieren.

• Tolt erfasst Beträge in ganzzahligen Cent (das Feld amount ist die Provision des Partners, revenue der Bruttobetrag des Verkaufs), deshalb liest der Importer diese Spalten als Kleinsteinheiten.
• Frühere Conversions und Provisionen werden dem Affiliate innerhalb der Zielkampagne über die E-Mail-Adresse (oder den erhaltenen Slug) zugeordnet und mit Betrag und Datum aus deinem Export erfasst.
• Provisionen, die Tolt bereits ausgezahlt hat, werden als gesperrte Historie importiert (sie zählen in den Gesamtwerten mit und werden nie erneut ausgezahlt). Noch offene Provisionen (pending oder approved) werden nur dann für eine Rekomi-Auszahlung eingeplant, wenn du das auf dem Vorschaubildschirm autorisierst. Erstattete, als Betrug markierte und abgelehnte Zeilen werden übersprungen.
• 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.

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

Wie es weitergeht

• Tracking und Attribution: der Parameter aff, die Cookie-Laufzeit und die Stickiness (Bindung eines Kunden an einen Affiliate).
• 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.