Umzug von Tapfiliate

Diese Anleitung ist für Marken, die von Tapfiliate zu Rekomi wechseln. Der Importer liest den Standard-CSV-Export von Tapfiliate, dedupliziert über die E-Mail-Adresse, erhält jeden referral_code, damit bestehende Links wie brand.com/?ref=alex weiter funktionieren, und schickt jedem importierten Affiliate auf Wunsch eine persönliche Einladung zum Anmelden.

Das Einzige, was bei einem Umzug von Tapfiliate anders ist als bei den anderen: Tapfiliate schickt dir die CSV per E-Mail, statt sie direkt zum Download anzubieten. Plane dafür einen zusätzlichen Zwischenschritt ein.

Der Umzug ist ab Starter verfügbar, die automatische Benachrichtigung ab Growth.

Was der Importer übernimmt

Der Importer achtet bei keiner Spaltenüberschrift auf Groß- und Kleinschreibung, deshalb funktioniert „Firstname“ von Tapfiliate genauso wie „first_name“. Jede Spalte, die der Importer nicht kennt (z. B. Affiliate_id, Signed_up_at, Signup_source, company, country), wird stillschweigend ignoriert. Der Affiliate-Export hat überhaupt keine Klickspalte (die Klickzahlen von Tapfiliate sind Summen auf der Seite Reporting und nur per API abrufbar), deshalb können historische Klickzahlen nicht aus dieser Datei kommen.

Status-Zuordnung

Der Tapfiliate-Export enthält ein einziges Freigabe-Flag: Program_approved. Die Zuordnung:

Groß- und Kleinschreibung spielt beim Abgleich keine Rolle. Die Tapfiliate-CSV kann archivierte nicht von aktiven Affiliates unterscheiden (archivierte Affiliates fehlen im Export komplett). Siehe die Stolperfalle zu archivierten Affiliates unten.

So bleiben Slugs erhalten

Die Tracking-URL von Tapfiliate ist brand.com/?ref={referral_code}. Die Tracking-URL von Rekomi ist ebenfalls brand.com/?ref={slug}: ref ist einer der 21 Standard-Attributionsparameter von Rekomi, du musst also nichts zusätzlich konfigurieren.

Der Importer liest den Empfehlungscode aus der URL in Program_referral_link jeder Zeile (eine von Hand angelegte Spalte referral_code oder ref_code hat Vorrang, wenn vorhanden) und versucht, ihn als neuen Rekomi-Slug des Affiliates zu registrieren. Die Erhaltung klappt, wenn:

1. Der gelesene Code ein gültiger Alias ist: 3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, kein Bindestrich am Anfang oder Ende.
2. Der Slug global noch frei ist.

Tapfiliate erzeugt standardmäßig kurze alphanumerische Empfehlungscodes, deshalb ist fast jeder Code gültig und kollidiert selten. Marken, die Codes auf wiedererkennbare Namen ändern (alex, growth2024 usw.), haben eine etwas höhere Kollisionsrate, aber der Importer protokolliert jeden Rückfall in der Ergebnisansicht des Jobs.

Hat eine Zeile weder einen lesbaren Empfehlungslink noch eine Code-Spalte, wird ein neuer zufälliger Slug mit 12 Zeichen erzeugt; der bestehende Tapfiliate-Link des Affiliates funktioniert dann nicht mehr.

Umstellung Schritt für Schritt

1. Der Attributionsparameter ref (nichts zu tun)

ref ist einer der 21 Standard-Attributionsparameter von Rekomi und wird immer erkannt, deshalb funktionieren die ?ref=-Links von Tapfiliate sofort. Eigene Parameter erweitern die Liste nur; du musst nichts konfigurieren.

2. Export aus Tapfiliate

Öffne in Tapfiliate Affiliates und klicke auf Select All (oder wähle die gewünschten Zeilen aus). Klicke auf Export. Tapfiliate bietet dir KEINEN direkten Download an, sondern schickt die CSV an die E-Mail-Adresse des Kontoinhabers. Das gibt es nur bei Tapfiliate, und es sorgt bei diesem Umzug am häufigsten für Verwirrung.

Warte auf die E-Mail (meist ein bis zwei Minuten), speichere die angehängte Datei lokal und mach mit dem nächsten Schritt weiter.

3. CSV hochladen

Öffne /dashboard/settings/migrate. Wähle Tapfiliate als Quelle, wähle deine Zielkampagne in Rekomi und lade die CSV hoch.

4. Archivierte Affiliates neu einstufen (falls nötig)

Die Tapfiliate-CSV enthält archivierte Affiliates überhaupt NICHT, und selbst bei nicht archivierten Zeilen bekommst du als Status nur den booleschen Wert program_approved. Wenn du in Tapfiliate Affiliates in den Bereichen „rejected“ oder „blocked“ hattest, dann:

1. Tauchen sie entweder gar nicht in der CSV auf (Tapfiliate schließt sie aus). Dann gibt es nichts zu tun, sie werden nicht übernommen.
2. Oder sie erscheinen in Rekomi als Ausstehend (boolescher Wert leer oder false), und du kannst sie über die Sammelaktion für den Status in /dashboard/affiliates auf Abgelehnt setzen.

Wenn du archivierte Affiliates unbedingt in deiner Rekomi-Organisation brauchst, kontaktiere den Support; beim begleiteten Umzug können wir sie aus den Rohdaten von Tapfiliate wiederherstellen.

5. Automatische Benachrichtigung aktivieren (nur Growth+)

Derselbe Ablauf wie bei jedem anderen Umzug: Hake Affiliates nach dem Import benachrichtigen an, schreib eine persönliche Notiz, schick dir ein Beispiel und lass dann den Massenversand mit 1 E-Mail pro Sekunde laufen.

6. Tracking-Snippet austauschen

Installiere das Tracking-Snippet von Rekomi und entferne das Snippet von Tapfiliate. Sobald der Austausch live ist, wird jeder bestehende Link wie brand.com/?ref=alex über Rekomi zugeordnet.

Was NICHT importiert wird

Typische Stolperfallen

Der Button „Export“ scheint kaputt zu sein, nichts wird heruntergeladen. Das ist zu erwarten. Tapfiliate schickt die CSV per E-Mail. Sieh im Posteingang des Kontoinhabers deines Tapfiliate-Kontos nach.

Einige Affiliates waren in Tapfiliate archiviert, stehen aber nicht in meiner CSV. Archivierte Affiliates sind absichtlich vom Tapfiliate-Export ausgeschlossen. Sie werden nicht übernommen. Wenn du sie brauchst, kontaktiere den Support.

In manchen Zeilen fehlt die Spalte program_approved. Diese Zeilen werden als Ausstehend importiert. Gib sie nach dem Import bei Bedarf über /dashboard/affiliates gesammelt frei.

Die Empfehlungscodes meiner Affiliates enthalten Sonderzeichen. Tapfiliate erlaubt in Empfehlungscodes Bindestriche, und die akzeptiert Rekomi. Unterstriche, Schrägstriche, Punkte oder andere Satzzeichen lassen die Slug-Prüfung scheitern, und der Affiliate bekommt stattdessen einen neuen zufälligen Slug. Die Detailansicht des Jobs zeigt, bei welchen Slugs das passiert ist.

Prüfen, ob der Import sauber durchgelaufen ist

Wenn der Job abgeschlossen ist:

1. Öffne /dashboard/affiliates und prüfe stichprobenartig 3 bis 5 Zeilen darauf, ob Name und E-Mail stimmen.
2. Prüfe stichprobenartig den Tracking-Link eines Affiliates: Er sollte brand.com/?ref={referral_code} lauten und seinem Wert in Tapfiliate entsprechen.
3. Schick dir eine Beispielbenachrichtigung und prüfe, ob der Button Konto übernehmen alles korrekt vorausfüllt.
4. Klicke bei live geschaltetem neuem Snippet auf deinen eigenen Testlink und prüfe, ob innerhalb von Sekunden eine Klickzeile erscheint.

Starte dann den Massenversand der automatischen Benachrichtigung und kündige Tapfiliate, sobald du dich sicher fühlst.

Historie und Einnahmen importieren

Um die bisherigen Ergebnisse jedes Affiliates herüberzuholen, exportiere deine Conversions-CSV aus Tapfiliate (per E-Mail, wie den Affiliate-Export) und lade sie unter Einstellungen > Umzug > Schritt 2 hoch (getrennt von der Affiliate-Liste oben). Im selben Feld in Schritt 2 kannst du auch den Customers-Export von Tapfiliate hochladen: Zeilen mit dem Status trial (das Gegenstück von Tapfiliate zu einem Lead) werden als Lead-Datensätze ohne Betrag importiert und ihrem Affiliate zugeordnet, damit dein Funnel und deine Lead-Zahlen nicht auf null zurückfallen. Zeilen mit aktiven oder gekündigten Kunden werden dort übersprungen (die Historie eines aktiven Kunden kommt stattdessen über den Conversions-Export).

• Frühere Conversions und Provisionen werden dem Affiliate über den Code in Afilliate_id (oder den Anzeigenamen) zugeordnet und mit Betrag und Datum aus deinem Export erfasst. Beträge werden in der Haupteinheit gelesen, mit der Spalte Currency pro Zeile.
• Die Spalte Approved von Tapfiliate ist ein Freigabe-Flag, kein Zahlungsstatus, deshalb wird jede importierte Provision als abgerechnete Historie gesperrt (sie zählt in den Gesamtwerten mit und wird nie von Rekomi ausgezahlt). Abgelehnte Zeilen werden verworfen. Zahle alle letzten offenen Guthaben noch in Tapfiliate aus, bevor du kündigst.
• Die Exporte von Tapfiliate enthalten keine Stripe-Kunden- oder Abo-IDs und keine E-Mail-Adresse des Kunden (die Identität ist deine eigene Customer_id). Eine automatische wiederkehrende Attribution ist mit dieser Datei deshalb nicht möglich; bestehende Abonnements lassen sich bei Bedarf über den begleiteten Umzug neu verknüpfen.
• Eine Vorschau im Probelauf zeigt dir, was importiert wird, bevor du bestätigst. Ein erneuter Lauf ist sicher. Abgelehnte und erstattete Zeilen werden übersprungen.

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

Wie es weitergeht

• Tracking und Attribution: die vollständige Referenz zu ref und den anderen Attributionsparametern.
• Umzug von anderen Plattformen: die Matrix zur URL-Erhaltung für alle Quellen.
• Rekomi vs. Tapfiliate: der direkte Vergleich, falls du noch am Abwägen bist.