Umzug von Trackdesk

Diese Anleitung ist für Marken, die von Trackdesk zu Rekomi wechseln. Trackdesk ist eine Affiliate-Plattform mit Schwerpunkt auf Performance-Tracking. Der Hauptweg ist ein API-Abruf mit zwei Schlüsseln: Füge deine Trackdesk-Tenant-ID und ein Personal Access Token ein, und Rekomi importiert in einem Durchgang deine Affiliate-Liste (die öffentliche Affiliate ID jedes Affiliates bleibt als sein Rekomi-Slug erhalten), bis zu 3 Jahre Conversion-Historie und die Klicksummen pro Affiliate für denselben Zeitraum von 3 Jahren.

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)

Für den API-Zugriff brauchst du bei Trackdesk den Business-Plan oder höher (laut Hilfe-Center von Trackdesk); Konten mit einem älteren Starter-Plan oder kostenlose Konten nutzen stattdessen die CSV als Ausweichweg.

1. Öffne in Trackdesk Settings → Integrations → Personal access tokens und erzeuge ein Token. Deine Tenant-ID ist die Subdomain deines Programms: Bei https://acme.trackdesk.com lautet die Tenant-ID acme (sie steht auch in den Settings unter Your Trackdesk identifiers).
2. Öffne /dashboard/settings/migrate, wähle Trackdesk, 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. Lass den Schalter Conversion-Historie importieren eingeschaltet (oder schalte ihn aus) und klicke auf Von Trackdesk abrufen.

Das importiert der Abruf:

• Affiliates: E-Mail, Name und Status (ENABLED aus Trackdesk wird als Freigegeben importiert, PENDING als Ausstehend und DISABLED als Pausiert, weil sich das Deaktivieren in Trackdesk rückgängig machen lässt), dazu die PayPal-E-Mail, wenn die hinterlegten Zahlungsmethoden in Trackdesk eine enthalten.
• Affiliate IDs als Slugs: Die öffentliche Affiliate ID jedes Affiliates (die URL-taugliche Kennung von Trackdesk mit 2 bis 50 Zeichen) bleibt als sein Rekomi-Slug erhalten, wenn sie die üblichen Slug-Prüfungen besteht (global noch frei, gültige Zeichen).
• Klicksummen: die Klickzahlen pro Affiliate aus dem Affiliate-Übersichtsbericht von Trackdesk, für denselben Zeitraum von 3 Jahren wie die Conversion-Historie, so weit wie möglich. Liefert der Bericht nichts, läuft der Import mit null historischen Klicks weiter, und das Ergebnis sagt es dir.
• Conversion-Historie: bis zu 3 Jahre Conversions mit Bestellbetrag, der Affiliate-Vergütung als Provision, Währung pro Zeile und Datum. Trackdesk gibt Beträge als Dezimal-Strings in der Haupteinheit an; Rekomi rechnet mit der echten Zahl der Nachkommastellen der jeweiligen Währung um. Conversions mit FRAUD, NOT_ALLOWED, BLOCKED, REFUNDED, REJECTED und TEST werden nie importiert. Zeilen, die bereits in einer Trackdesk-Abrechnung enthalten sind, werden mit einem Zahlungsdatum importiert; alles wird als abgerechnete, gesperrte Historie importiert: Durch den API-Abruf wird nichts auszahlbar.

Das kann der Abruf nicht importieren: auszahlbare Guthaben (nutze dafür den CSV-Ablauf aus Schritt 2 mit seiner Vorschau), E-Mail-Adressen von Kunden (Trackdesk gibt bei Conversions nur eine anonyme Kunden-ID heraus), Zuweisungen von Gutscheinen an Affiliates (erstelle neue Gutscheincodes in Rekomi) und Lead-Listen (Trackdesk hat keine eigene Lead-Ressource; Conversions vom Typ Lead werden als Conversions ohne Betrag mit ihrer Vergütung 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 Conversion-IDs von Trackdesk.

Die CSV als Ausweichweg

Affiliate list → Export in Trackdesk erzeugt affiliates.csv (direkter Download) mit Referral ID, Login-E-Mail, vollständigem Namen, Stufe, Status und Land. Exportiere mit Komma als Trennzeichen und „.“ als Dezimalzeichen (der Exportdialog bietet auch die Varianten „;“ und „,“ an, die der Importer nicht verarbeitet). Die CSV als Ausweichweg deckt nur die Liste ab; die Conversion-Historie kommt aus dem API-Abruf oder dem CSV-Ablauf mit den allgemeinen Spalten in Schritt 2, die Klicksummen aus dem API-Abruf.

Was der CSV-Importer übernimmt

Der Export hat keine Spalten für Auszahlung oder Abrechnung (die gibt es in Trackdesk nur per API), deshalb importiert der CSV-Weg Affiliates ohne Auszahlungs-E-Mails; sie richten ihre Auszahlungen in Rekomi neu ein.

Status-Zuordnung

Die Zuordnung akzeptiert außerdem ACTIVE und APPROVED als Aliasse für Freigegeben. DISABLED lässt sich in Trackdesk rückgängig machen (es gibt eine Reaktivierung), deshalb wird der Status auf Pausiert abgebildet statt auf Gesperrt, und die Historie des Affiliates bleibt importierbar. Nach dem Import kannst du jede Zeile in /dashboard/affiliates über die Sammelaktion für den Status neu einstufen.

So bleiben Slugs erhalten

Die gut lesbare Affiliate ID von Trackdesk (2 bis 50 Zeichen, Kleinbuchstaben mit Bindestrichen) ist die Kennung, die in Tracking-Links und Berichten steckt. Der Importer übernimmt sie als Rekomi-Slug, wenn sie die üblichen Prüfungen besteht (3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, global noch frei).

Dass Links weiter funktionieren, klappt bei Trackdesk nur teilweise, und hier ist Ehrlichkeit wichtig:

• Direkte Links zeigen auf deine eigenen Landingpages und hängen Trackdesk-Parameter an. Nach der Umstellung sind diese Parameter wirkungslose Query-Strings auf deiner eigenen Domain; die Seiten laden weiter, aber für die Attribution braucht der Affiliate seinen neuen Rekomi-Link (oder seinen erhaltenen Affiliate-ID-Slug in einem Link im Rekomi-Format).
• Weiterleitungslinks über {tenant}.trackdesk.com werden von Trackdesk gehostet und funktionieren nicht mehr, sobald dein Konto geschlossen ist. Eine eigene Weiterleitungsdomain (wie go.yourbrand.com) gehört dir: Leite sie um, sobald Rekomi live ist.
• Gutscheincodes, die in Trackdesk Affiliates zugewiesen sind, werden nicht übernommen; erstelle für jeden Affiliate neue Gutscheincodes in Rekomi.

Plane die Umstellung als Linktausch: Importiere die Liste (Slugs bleiben erhalten) und lass dann die automatische Benachrichtigung jedem Affiliate seinen Rekomi-Link geben.

Umstellung Schritt für Schritt

1. API-Abruf ausführen

Erzeuge in Trackdesk unter Settings → Integrations ein Personal Access Token, notiere dir deine Tenant-ID und führe den Abruf unter /dashboard/settings/migrate aus.

2. Importergebnis prüfen

Der Import läuft synchron und zeigt das Ergebnis Zeile für Zeile. Jeder Job steht in der Importhistorie, mit einer Detailansicht pro Zeile und dem Button Rückgängig.

3. Automatische Benachrichtigung aktivieren (nur Growth+)

Bei einem Umzug von Trackdesk ist die Benachrichtigung wichtiger als sonst, weil Affiliates ihren Rekomi-Link brauchen. Schreib eine kurze persönliche Notiz und schick dir vor dem gedrosselten Massenversand selbst ein Beispiel.

4. Snippet installieren und eigene Domains umleiten

Installiere das Tracking-Snippet von Rekomi auf deiner Marketing-Website. Wenn du eine eigene Trackdesk-Weiterleitungsdomain hattest, leite sie um. Lass Trackdesk noch 24 bis 48 Stunden parallel laufen und kündige es dann.

Was NICHT importiert wird

Typische Stolperfallen

Mehrere Offers. Ein Trackdesk-Konto kann mehrere Offers führen; die Liste gilt kontoweit, und der Historienabruf importiert die Conversions aller Offers in die eine Rekomi-Kampagne, die du gewählt hast. Marken mit mehreren Offers, die sie getrennt halten wollen, legen getrennte Rekomi-Kampagnen an und nutzen den CSV-Ablauf aus Schritt 2 pro Offer.

Keine API in meinem Plan. Konten mit einem älteren Starter-Plan und kostenlose Trackdesk-Konten haben keinen API-Zugriff; nutze für die Liste die affiliates.csv als Ausweichweg und für die Historie den Export des Conversion-Berichts über den allgemeinen CSV-Weg in Schritt 2.

CSVs mit Semikolon. Der Exportdialog von Trackdesk bietet für europäische Ländereinstellungen „;“ als Trennzeichen und „,“ als Dezimalzeichen an; der Importer braucht das Komma als Trennzeichen und „.“ als Dezimalzeichen.

Prüfen, ob der Import sauber durchgelaufen ist

1. Öffne /dashboard/affiliates und vergleiche stichprobenartig 3 bis 5 Zeilen mit den Daten in Trackdesk (einschließlich Status).
2. Öffne die Detailseite eines Affiliates und prüfe, ob seine Affiliate ID als Slug übernommen wurde.
3. Prüfe, ob die Klickzahlen im Vergleich zum Übersichtsbericht von Trackdesk für die letzten 3 Jahre plausibel aussehen.
4. Schick dir eine Beispielbenachrichtigung, bevor du den Massenversand startest.

Historie und Einnahmen importieren

Der API-Abruf importiert bereits bis zu 3 Jahre Conversions als gesperrte, abgerechnete Datensätze (Zeilen aus einer Abrechnung tragen ein Zahlungsdatum). Nutze den CSV-Ablauf aus Schritt 2, 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. Eine Datei für Schritt 2 aus Trackdesk nutzt die allgemeinen Spalten (E-Mail des Affiliates, Betrag, Provision, Währung, Datum); exportiere den Conversion-Bericht mit Komma als Trennzeichen und „.“ als Dezimalzeichen. Die vollständige Referenz findest du im Migrationsüberblick.

Wie es weitergeht

• Tracking und Attribution: Cookie-Laufzeit, Attributionsparameter und 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.