Umzug von PromoteKit
Bring dein PromoteKit-Programm mit einem einzigen API-Abruf zu Rekomi. Rekomi importiert deine Affiliates (mit ?via=-Empfehlungscodes, Auszahlungs-E-Mails und Klickzahlen), deine registrierten Leads und deine Provisionshistorie direkt aus der PromoteKit-API.
Diese Anleitung ist für Marken, die von PromoteKit zu Rekomi wechseln. PromoteKit ist eine Stripe-native Affiliate-Plattform für SaaS. Der Hauptweg ist ein API-Abruf mit einem einzigen Schlüssel: Füge deinen PromoteKit-API-Schlüssel ein, und Rekomi importiert in einem Durchgang deine Affiliate-Liste (mit dem ?via=-Empfehlungscode, der Auszahlungs-E-Mail und der Klickzahl seit Beginn jedes Affiliates), deine registrierten 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)
Die Dashboard-Exporte von PromoteKit sind reine Auszahlungsdateien (im Format für Sammelzahlungen über PayPal und Wise), deshalb ist der API-Abruf der vollständige Migrationsweg. Die PromoteKit-API gibt es ab dem Pro-Plan; der Free-Plan hat keinen API-Schlüssel.
- Öffne in PromoteKit Settings → API Keys und kopiere deinen API-Schlüssel.
- Öffne
/dashboard/settings/migrate, wähle PromoteKit, 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. - Lass die Schalter Leads importieren und Provisionshistorie importieren eingeschaltet (oder schalte einen davon aus) und klicke auf Von PromoteKit abrufen.
Das importiert der Abruf:
- Affiliates: E-Mail, Vor- und Nachname, Auszahlungs-E-Mail (PayPal oder Wise) und Status. PromoteKit bildet den Status mit zwei booleschen Werten ab: Gesperrte Affiliates werden als Gesperrt importiert, freigegebene als Freigegeben und nicht freigegebene Bewerbungen als Ausstehend.
- Empfehlungscodes: Der erste Link-Code jedes Affiliates (der
?via=-Wert) bleibt als sein Rekomi-Slug erhalten, wenn er die üblichen Slug-Prüfungen besteht (3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, noch nicht vergeben). Links mit dem erhaltenen Code funktionieren unverändert weiter, weilviaeiner der eingebauten Attributionsparameter von Rekomi ist. Affiliates mit mehreren PromoteKit-Links bekommen einen Rekomi-Link; die Importzusammenfassung sagt dir, wie viele das betrifft. - Klickzahlen: Die Gesamtzahl
clicksjedes Affiliates wird in seinen Klickzähler in Rekomi übernommen, damit Ranglisten und die EPC-Rechnung nicht auf null zurückfallen. - Leads: Referrals im PromoteKit-Status
signed_up(über einen Affiliate registriert, nie mit dem Bezahlen begonnen) werden als Lead-Datensätze ohne Betrag importiert und ihrem Affiliate zugeordnet, mit der E-Mail-Adresse des Kunden und, falls vorhanden, der Stripe-Kunden-ID, die für die wiederkehrende Attribution mitgenommen wird. - Provisionshistorie: Provisionen mit Verkaufsbetrag, Provisionsbetrag, Währung pro Zeile und Datum. PromoteKit gibt Beträge als Dezimalzahl in der Haupteinheit an („99.0“ bedeutet $99.00); Rekomi rechnet mit der echten Zahl der Nachkommastellen der jeweiligen Währung um, sodass Währungen ohne Nachkommastellen wie JPY korrekt bleiben. Zeilen, die PromoteKit als
paidmarkiert hat, 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 den CSV-Ablauf aus Schritt 2 mit seiner Vorschau, wenn offene Guthaben auszahlbar werden sollen), die Attribution über Promo-Codes (Gutscheine; erstelle stattdessen neue Gutscheincodes in Rekomi), die Kampagnenstruktur und Protokolle einzelner Klicks (PromoteKit stellt nur Summen bereit). 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 PromoteKit.
Die CSV als Ausweichweg
Im PromoteKit-Dashboard gibt es keinen Export der Affiliate-Liste, aber eine vom Support bereitgestellte oder aus der API erzeugte Datei funktioniert mit dem CSV-Importer unten.
Was der CSV-Importer übernimmt
| Feld | Quellspalte | Hinweise |
|---|---|---|
email | Pflichtfeld. Kleingeschrieben und getrimmt. Primärer Schlüssel für die Duplikatprüfung. | |
| Vollständiger Name | name oder first_name + last_name | Wenn name vorhanden ist, hat es Vorrang; sonst werden die beiden Teile mit einem Leerzeichen zusammengesetzt. |
| Status | Boolesche Werte approved + banned oder status | Siehe Zuordnungstabelle unten. |
| Auszahlungs-E-Mail | payout_email oder paypal_email | Optional. Bleibt als Auszahlungsziel des Affiliates erhalten, wenn vorhanden. |
| Tracking-Slug | ref_code, referral_code, code oder ?via= aus einer Link-Spalte | Siehe So bleiben Slugs erhalten. |
| Klickzahl | clicks oder click_count | Optionale Gesamtzahl seit Beginn. |
Status-Zuordnung
PromoteKit bildet den Affiliate-Status mit zwei booleschen Werten ab statt mit einer Aufzählung:
| PromoteKit | Rekomi |
|---|---|
banned = true | Gesperrt |
approved = true (nicht gesperrt) | Freigegeben |
approved = false | Ausstehend |
| keiner von beiden lesbar | Ausstehend |
PromoteKit-Kampagnen können eine Freigabe verlangen (approval_needed), deshalb wird ein nicht freigegebener Affiliate als ausstehende Bewerbung behandelt. Nach dem Import kannst du jede Zeile in /dashboard/affiliates über die Sammelaktion für den Status neu einstufen.
So bleiben Slugs erhalten
Die Empfehlungslinks von PromoteKit nutzen den Query-Parameter ?via=, zum Beispiel brand.com?via=alex. via ist einer der eingebauten Attributionsparameter von Rekomi und funktioniert sofort, deshalb werden die ?via=-Links deiner Affiliates in Rekomi weiter richtig zugeordnet, sobald du das Tracking-Snippet austauschst, überall dort, wo der Code als Slug erhalten geblieben ist (Bedingungen siehe unten).
Der Importer übernimmt den Slug selbst, wenn:
- Der Abruf (oder die Datei) den Link-Code des Affiliates enthält.
- Der Wert ein gültiger Alias ist: 3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, kein Bindestrich am Anfang oder Ende.
- 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. Andernfalls bekommt er einen neuen zufälligen Slug mit 12 Zeichen; sein Konto wird trotzdem sauber importiert.
Umstellung Schritt für Schritt
1. API-Abruf ausführen
Kopiere deinen API-Schlüssel in PromoteKit unter Settings → API Keys und führe den Abruf unter /dashboard/settings/migrate aus (siehe Import per API oben). Ein Durchgang bringt deine Liste, Empfehlungscodes, Leads und Historie.
2. Attributionsparameter: für via nichts zu konfigurieren
via ist einer der eingebauten Attributionsparameter von Rekomi und wird immer erkannt, deshalb führen bestehende PromoteKit-Links in Rekomi ohne jede Konfiguration 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. 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 eine kurze persönliche Notiz. Klicke auf Beispiel an mich selbst senden, um dir die E-Mail vor dem gedrosselten Massenversand (eine E-Mail pro Sekunde) anzusehen.
5. Tracking-Snippet austauschen
Installiere das Tracking-Snippet von Rekomi auf deiner Marketing-Website und entferne dann das Script-Tag von PromoteKit samt dem Eintrag in die Stripe-Metadaten. Sobald das neue Snippet live ist, wird jeder bestehende Link wie brand.com?via=alex über Rekomi statt über PromoteKit zugeordnet. Lass PromoteKit noch 24 bis 48 Stunden parallel laufen, wenn du auf Nummer sicher gehen willst, und kündige es dann.
Was NICHT importiert wird
| Daten | Status | Lösung |
|---|---|---|
| Historische Klickzahlen | Nur per API-Abruf | Die Gesamtzahlen clicks werden über den API-Abruf importiert; Protokolle einzelner Klicks lassen sich nicht übertragen. |
| Leads | Nur per API-Abruf | PromoteKit hat keinen Referral-Export; der Abruf bringt Referrals im Status signed_up als Lead-Datensätze ohne Betrag. |
| Attribution über Promo-Codes | Nicht importiert | Die Gutscheine von PromoteKit laufen über Stripe-Promotion-Codes; erstelle stattdessen neue Gutscheincodes in Rekomi. |
| Welche Guthaben offen sind | Teilweise | Alles wird als gesperrte Historie importiert; das paid-Flag von PromoteKit entscheidet, welche Zeilen ein Zahlungsdatum bekommen. Damit offene Guthaben auszahlbar werden, brauchst du den CSV-Ablauf aus Schritt 2 mit seiner Vorschau. |
| Eigene Provisionsregeln | Nicht importiert | Richte die Provisionsmodelle von Rekomi direkt ein. |
Typische Stolperfallen
Mein PromoteKit-Plan hat keinen API-Schlüssel. API-Zugriff gibt es ab dem Pro-Plan von PromoteKit. Im Free-Plan bittest du den PromoteKit-Support um einen Datenexport und nutzt die CSV als Ausweichweg, oder du stufst für einen Monat hoch, um den Abruf auszuführen.
Ein Affiliate hatte mehrere Links. Er wird einmal mit dem Code seines ersten Links importiert; Links mit diesem erhaltenen Code werden weiter zugeordnet, Links mit seinen anderen Codes werden nach der Umstellung nicht mehr aufgelöst (ein bekannter Parametername kann keinen nicht registrierten Code auflösen).
Korrekturen durch Erstattungen. Negative Provisionszeilen (Korrekturen durch Erstattungen) werden beim Import übersprungen, statt als negative Historie importiert zu werden.
Prüfen, ob der Import sauber durchgelaufen ist
- Öffne
/dashboard/affiliatesund vergleiche stichprobenartig 3 bis 5 Zeilen mit den Daten in PromoteKit. - Öffne die Detailseite eines Affiliates und prüfe, ob der
?via=-Slug erhalten geblieben ist (oder andernfalls ein neuer Slug vergeben wurde). - Klicke bei installiertem neuem Snippet auf einen bestehenden
?via=-Link eines Affiliates und prüfe, ob innerhalb weniger Sekunden eine Klickzeile bei diesem Affiliate erscheint. - Schick dir eine Beispielbenachrichtigung, bevor du den Massenversand startest.
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 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 PromoteKit nutzt die allgemeinen Spalten (E-Mail des Affiliates, Betrag, Provision, Währung, Datum, bezahlt). Die vollständige Referenz findest du im Migrationsüberblick.
Wie es weitergeht
- Tracking und Attribution: der Parameter
via, die Cookie-Laufzeit und die 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.
Umzug von impact.com
Bring deine Partnerliste aus impact.com zu Rekomi. Rekomi holt Partner, bis zu 3 Jahre Conversion-Historie und die Klicksummen seit Beginn über die Advertiser-API von impact.com; du musst nichts exportieren.
Umzug von LeadDyno
Bring dein LeadDyno-Programm mit einem einzigen API-Abruf zu Rekomi. Rekomi importiert deine Affiliates (mit ?afmc=-Codes, PayPal-E-Mails und Besucherzahlen seit Beginn), deine registrierten Leads und deine Provisionshistorie direkt aus der LeadDyno-API.