Umzug von Dub Partners

Diese Anleitung ist für Marken, die von Dub Partners zu Rekomi wechseln. Der Importer liest den CSV-Export von Dub (abgeglichen mit dem Open-Source-Schema), dedupliziert per E-Mail, importiert die Klickzahl jedes Partners seit Beginn, wenn der Export die Spalte Clicks enthält, und ordnet die Statuswerte von Dub den vier Status von Rekomi zu, wenn eine Statusspalte vorhanden ist.

Eine strukturelle Einschränkung vorab: Der Partner-Export von Dub hat keine Link-Spalte (ein Partner kann viele Kurzlinks haben), deshalb bekommen importierte Affiliates neue Tracking-Slugs in Rekomi; was das für bestehende Links bedeutet, steht im URL-Abschnitt weiter unten.

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

Was der Importer übernimmt

Der CSV-Export von Dub enthält Name und E-Mail jedes Partners plus Spalten, die du selbst ein- und ausschalten kannst (Group, Tags, Enrolled, Location, Clicks, Leads, Conversions, Revenue, Commissions, Net Revenue, EPC und weitere; ältere Schemas enthielten auch ID / Country / Status / Enrolled at). Der Importer ordnet unscharf und ohne Rücksicht auf Groß- und Kleinschreibung zu; die Summenspalten werden ignoriert, außer Clicks, die die Klickzahl jedes Partners seit Beginn übernimmt.

Status-Zuordnung

Aktuelle Dub-Exporte haben überhaupt keine Statusspalte; jede Zeile in der Tabelle All Partners ist ein aufgenommener Partner, deshalb werden diese Zeilen als Freigegeben importiert. Wenn deine Datei eine Spalte Status enthält (ältere Exporte oder eine selbst gebaute Datei): Dub hat das detaillierteste Status-Vokabular der 8 unterstützten Plattformen (8 verschiedene Status), und der Importer fasst es auf die 4 Status von Rekomi zusammen:

Groß- und Kleinschreibung spielt beim Abgleich keine Rolle. Die Zuordnung „invited → Freigegeben“ ist Absicht: Ein eingeladener Partner hat in Dub bereits einen funktionierenden Tracking-Link, was dem Status Freigegeben in Rekomi (Link aktiv) näher kommt als Ausstehend (noch kein Link).

Slugs und bestehende Links: das ehrliche Bild

Die Tracking-URL von Dub ist standardmäßig brand.com/?via={key} (mit dem Attributionsparameter via, wie bei Rewardful). Die Tracking-URL von Rekomi ist ebenfalls brand.com/?via={slug}, und via ist einer der 21 Standard-Attributionsparameter von Rekomi, du musst also keinen Parameter konfigurieren.

Der Haken ist der Slug selbst. Der Partner-Export von Dub hat keine Link- oder Key-Spalte (ein Partner kann viele Kurzlinks haben, etwa dub.sh/alex-blog und dub.sh/alex-yt, deshalb kann die Listen-CSV sie nicht auf einen reduzieren). Der Importer kann den Link-Key jedes Partners also nicht aus der Datei lesen, und importierte Affiliates bekommen neue Rekomi-Slugs mit 12 Zeichen.

Wenn du deine eigene CSV baust, liest der Importer eine Spalte partner_link (er wertet den Wert von ?via= / ?ref= aus) oder eine Spalte link_key, falls vorhanden, und übernimmt den Wert, wenn er ein gültiger Alias ist (3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, kein Bindestrich am Anfang oder Ende) und global noch frei ist. Die Links aller Partner über die Dub-API in eine solche Datei zu holen, oder ein nachträglicher Import auf API-Seite durch den Support, ist der Weg, bestehende ?via=-Links in großem Umfang zu erhalten; wende dich an den Support, wenn durchgehend funktionierende Links für deinen Umzug entscheidend sind.

Umstellung Schritt für Schritt

1. Export aus Dub

Öffne in Dub Program → Partners. Klicke oben in der Partnertabelle auf das ⋮-Menü (Kebab-Menü) und wähle Export as CSV. Bei Listen unter 1,000 Partnern startet der Download sofort. Bei Listen über 1,000 Partnern schickt Dub die CSV asynchron per E-Mail, sieh also in deinem Posteingang nach.

Schalte beim Export die Spalte Clicks ein, damit die Klickzahl jedes Partners seit Beginn in Rekomi übernommen wird. Die anderen Summen- und Social-Media-Spalten können für dein lokales Archiv eingeschaltet bleiben; der Importer ignoriert sie.

2. CSV hochladen

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

3. Automatische Benachrichtigung aktivieren (nur Growth+)

Hake Affiliates nach dem Import benachrichtigen an und schreib eine persönliche Notiz. Klicke auf Beispiel an mich selbst senden, um eine Vorschau zu verschicken, und lass dann den Massenversand mit 1 E-Mail pro Sekunde laufen.

4. Tracking-Snippet austauschen

Installiere das Tracking-Snippet von Rekomi und entferne das Snippet von Dub. Weil via einer der Standard-Attributionsparameter von Rekomi ist, wird jeder bestehende Link wie brand.com/?via=alex über Rekomi zugeordnet, sobald der Austausch live ist.

5. Dub kündigen

Lass Dub noch 24 bis 48 Stunden parallel laufen, wenn du die Zahlen vergleichen willst, und kündige es dann. Beachte, dass Dub-Kurzlinks auf der Domain dub.sh nicht mehr funktionieren, sobald Dub gekündigt ist: Affiliates, die diese statt gebrandeter Links geteilt haben, müssen sie aktualisieren.

Was NICHT importiert wird

Typische Stolperfallen

Mein Export dauert lange. Listen über 1,000 Partnern schickt Dub asynchron per E-Mail. Sieh im Posteingang des Kontoinhabers nach; die Datei kommt meist innerhalb von 10 bis 15 Minuten.

Jeder importierte Affiliate hat einen neuen Slug bekommen. Das ist zu erwarten: Der Partner-Export von Dub hat keine Link-Spalte, also gibt es in der Datei nichts zu erhalten. Baue eine CSV mit einer Spalte partner_link oder link_key (aus der Dub-API), wenn durchgehend funktionierende Links wichtig sind, oder wende dich an den Support für einen nachträglichen Import.

Alle sind als Freigegeben gelandet. Das ist bei aktuellen Exporten zu erwarten, denn sie haben keine Statusspalte; jeder Partner in der Tabelle All Partners ist aufgenommen. Stufe in /dashboard/affiliates per Sammelaktion um, falls manche Ausstehend sein sollen.

Manche Affiliates haben mehrere Dub-Kurzlinks. Die CSV von Dub hat eine Zeile pro Partner und enthält überhaupt keine Links. Um alle Links pro Partner zu erhalten, wende dich an den Support für einen nachträglichen Import über die Dub-API.

Meine Partnerlinks nutzen eine eigene Dub-Domain (go.brand.com). Wenn deine eigene Dub-Domain auf einen von Dub gehosteten Endpunkt statt auf brand.com zeigt, richte das DNS nach dem Austausch des Snippets auf Rekomi um, damit die Links weiter funktionieren; die Slugs müssen trotzdem erhalten sein (selbst gebaute CSV oder nachträglicher Import), damit diese Links zugeordnet werden.

Prüfen, ob der Import sauber durchgelaufen ist

Nachdem der Job abgeschlossen ist:

1. Öffne /dashboard/affiliates und prüfe stichprobenartig 5 bis 10 Zeilen darauf, ob Name und E-Mail stimmen.
2. Wenn du Clicks eingeschaltet hast, vergleiche stichprobenartig die Klicksumme eines Affiliates seit Beginn mit seiner Zahl in Dub.
3. Sieh dir das Detailfenster des Jobs an; sofern du keine Slug-Spalte selbst gebaut hast, zeigt jede Zeile einen neuen Slug (das ist zu erwarten, siehe oben).
4. Schick dir eine Beispielbenachrichtigung.
5. Klicke bei live geschaltetem neuem Snippet auf deinen eigenen Testlink und prüfe, ob innerhalb von Sekunden eine Klickzeile erscheint.

Starte dann die automatische Massenbenachrichtigung und kündige Dub.

Historie und Einnahmen importieren

Um die bisherige Leistung jedes Affiliates zu übernehmen, exportiere deine Commissions-CSV aus Dub (Program, Commissions, Export as CSV; mit den Feldern Date, Customer, Partner, Amount, Commission und Status) und lade sie unter Einstellungen > Umzug > Schritt 2 hoch (getrennt von der Affiliate-Liste oben).

• Frühere Conversions und Provisionen werden dem Affiliate per E-Mail (füge die optionale Spalte „Partner email“ hinzu) oder über den Anzeigenamen in der Spalte Partner zugeordnet und mit Betrag und Datum aus deinem Export erfasst. Beträge werden in der Haupteinheit der Währung gelesen; prüfe die Summen auf dem Vorschaubildschirm.
• Die Provisionsarten click und lead sind bei Dub echte Provisionen: Zeilen mit einem Geldbetrag werden wie jede andere Provision importiert; bei Zeilen ohne Geldbetrag gibt es nichts zu erfassen und werden übersprungen.
• Provisionen, die Dub bereits ausgezahlt hat, werden als gesperrte Historie importiert (in den Summen seit Beginn sichtbar, nie erneut ausgezahlt). Noch offene Provisionen werden nur dann für eine Rekomi-Auszahlung vorgemerkt, wenn du das auf dem Vorschaubildschirm autorisierst.
• Wenn dein Export die Stripe-Kunden- oder Abo-ID eines Kunden enthält und dein Stripe verbunden ist, werden bestehende Abonnements bei Verlängerungen weiter demselben Affiliate gutgeschrieben.
• Eine Vorschau im Probelauf zeigt, was importiert wird (und genau wie viel Rekomi gegebenenfalls auszahlen würde), bevor du bestätigst. Ein erneuter Durchlauf ist sicher. Stornierte und erstattete Zeilen werden übersprungen.

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

Wie es weitergeht

• Tracking und Attribution: via und die anderen 18 Standard-Attributionsparameter.
• Umzug von anderen Plattformen: die Übersicht, welche URLs erhalten bleiben.
• Rekomi vs. Dub Partners: Vergleich nebeneinander, falls du noch am Abwägen bist.