Umzug von Lemon Squeezy
Bring deine Affiliate-Liste aus Lemon Squeezy zu Rekomi. Lemon Squeezy hat keinen Affiliate-CSV-Export, deshalb holt Rekomi deine Liste (Namen, E-Mails, Status) über deren API, mit einer optionalen Zuordnung zum Einfügen, damit bestehende ?aff=-Links weiter funktionieren.
Diese Anleitung ist für Marken, die den eingebauten Affiliate-Bereich von Lemon Squeezy nutzen und zu Rekomi wechseln. Lemon Squeezy unterscheidet sich in einem wichtigen Punkt von jeder anderen Quelle, aus der Rekomi importiert: Es gibt nirgends im Produkt einen Affiliate-CSV-Export. Der einzige Weg zu deiner gesamten Liste ist die schreibgeschützte Affiliates-API, deshalb lädst du keine Datei hoch, sondern Rekomi holt deine Affiliates für dich direkt aus Lemon Squeezy.
Der Umzug ist ab Starter verfügbar, die automatische Benachrichtigung ab Growth.
Was der Importer übernimmt
Der Abruf liest den Endpunkt GET /v1/affiliates von Lemon Squeezy und importiert:
| Feld | Quellattribut | Hinweise |
|---|---|---|
user_email | Pflichtfeld. Kleingeschrieben und getrimmt. Primärer Schlüssel für die Duplikatprüfung. Zeilen ohne E-Mail werden übersprungen (missing_email). | |
| Vollständiger Name | user_name | Optional; manche ausstehenden Affiliates füllen ihr Profil nie aus und kommen ohne Namen an. |
| Status | status | Siehe Zuordnungstabelle unten. |
| Tracking-Slug | deine optional eingefügten Zeilen email,aff_code | Die API stellt den ?aff=-Code nicht bereit, deshalb sind die Slugs neu und zufällig, sofern du keine Zuordnung einfügst (siehe unten). |
Große Programme werden automatisch seitenweise abgerufen (100 pro Seite, bis zu 5,000 Affiliates pro Abruf; wende dich an den Support, wenn du mehr hast).
Was sich aus Lemon Squeezy NICHT importieren lässt
Behalte diese Punkte im Blick, bevor du die Umstellung planst. Keiner davon ist eine Grenze von Rekomi; die Daten lassen sich schlicht auf keinem Weg aus Lemon Squeezy exportieren (kein API-Endpunkt, kein Export-Button, und Bestellungen enthalten keinen Verweis auf den Affiliate):
| Daten | Grund | Lösung |
|---|---|---|
| Referral-, Conversion- und Auszahlungshistorie | Nirgends bereitgestellt. | Keine. Schritt 2 (Historienimport) ist für Lemon Squeezy deaktiviert; deine Affiliates starten mit frischen Statistiken. Zahle alle letzten offenen Einnahmen noch in Lemon Squeezy aus, bevor du das Programm dort abschaltest. |
| Provisionssätze pro Affiliate | Nicht gesammelt abrufbar. | Richte dein Provisionsmodell in Rekomi pro Kampagne ein; für Sonderkonditionen nutzt du individuelle Sätze pro Affiliate. |
Die ?aff=-Empfehlungscodes, gesammelt | Jeder Code ist nur auf der Profilseite des jeweiligen Affiliates im Lemon-Squeezy-Dashboard sichtbar. | Die optionale Zuordnung Bestehende ?aff=-Links beibehalten zum Einfügen: eine Zeile email,aff_code pro Affiliate, dessen Link weiter funktionieren soll. Lässt du sie weg, bekommt jeder einen neuen Rekomi-Link. |
| Auszahlungs-E-Mails (PayPal) | Nicht bereitgestellt. | Affiliates verbinden ihr eigenes Auszahlungskonto, wenn sie ihr Rekomi-Dashboard beanspruchen. |
Status-Zuordnung
Affiliates in Lemon Squeezy haben genau drei Status, die den Status von Rekomi zugeordnet werden:
Lemon Squeezy status | Rekomi |
|---|---|
active | Freigegeben |
pending | Ausstehend |
disabled | Gesperrt |
| alles Unerwartete | Ausstehend (damit du es prüfst, statt dass es automatisch freigegeben wird) |
Bei freigegebenen Importen wird der Zeitstempel ApprovedAt auf den Importzeitpunkt gesetzt, damit die Berechnung der Auszahlungsberechtigung stimmt. Wie bei jedem Importer kannst du über die Status-Kontrollkästchen im Importbildschirm ganze Status überspringen (die meisten Marken lassen Gesperrt weg).
Schritt für Schritt
Öffne /dashboard/settings/migrate und wähle Lemon Squeezy als Quelle. Es gibt zwei Wege, den Abruf auszuführen, je nachdem, ob dein Store schon verbunden ist:
Weg A: Dein Store ist über Lemon Squeezy Connect verbunden
Wenn du Conversions bereits über Lemon Squeezy Connect erfasst, musst du nichts einfügen. Wähle deine Zielkampagne und klicke auf Affiliates von Lemon Squeezy abrufen; Rekomi nutzt den API-Schlüssel und die Store-ID deines verbundenen Stores. Ein Export ist nicht nötig.
Weg B: API-Schlüssel einfügen
Wenn du Lemon Squeezy nicht verbunden hast (zum Beispiel, weil du gleichzeitig deine Abrechnung von Lemon Squeezy wegziehst):
- Öffne in deinem Lemon-Squeezy-Dashboard Settings, API und erstelle einen API-Schlüssel.
- Füge ihn in das Schlüsselfeld im Importbildschirm ein. Der Schlüssel wird live geprüft, einmal zum Lesen deiner Affiliate-Liste verwendet und nie gespeichert, protokolliert oder wieder angezeigt.
- Wenn der Schlüssel mehr als einen Store sieht, fragt Rekomi, aus welchem Store abgerufen werden soll; wähle einen aus und führe den Abruf erneut aus.
Bestehende ?aff=-Links erhalten (optional, auf beiden Wegen)
Rekomi erkennt aff von Haus aus als einen seiner Standard-Attributionsparameter, ein Link wie your-site.com/?aff=alex kann nach dem Umzug also weiter zuordnen, WENN der Slug des Affiliates erhalten bleibt. Da die API von Lemon Squeezy die Codes nicht gesammelt bereitstellt, kann der Importer sie nicht automatisch übernehmen. So hältst du bestimmte Links am Laufen:
- Öffne in Lemon Squeezy das Profil des Affiliates; dort wird sein Code angezeigt.
- Klappe im Importbildschirm Bestehende ?aff=-Links beibehalten auf und füge pro Affiliate eine Zeile
email,aff_codeein (eine Kopfzeile ist optional). - Führe den Abruf aus. Jeder eingefügte Code durchläuft die üblichen Slug-Prüfungen (3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, global eindeutig): Gültige, eindeutige Codes werden zum Rekomi-Slug dieses Affiliates, ungültige oder vergebene fallen auf einen neuen zufälligen Slug zurück, und Zuordnungszeilen, deren E-Mail zu keinem abgerufenen Affiliate passt, werden im Jobdetail pro Zeile als
mapping_unmatchedgemeldet (nie als Fehler).
Zwei ehrliche Einschränkungen. Erstens hilft das nur bei Links, die auf deiner Website landen, wo das Rekomi-Snippet läuft; Links, die direkt auf deine *.lemonsqueezy.com-Storefront zeigen, kann kein Migrationstool übernehmen. Zweitens lassen die meisten Marken mit mehr als einer Handvoll Affiliates diesen Schritt weg, geben allen einen neuen Rekomi-Link und verteilen die neuen Links dann über die automatische Benachrichtigung.
Status, Benachrichtigung und alles andere
Die Status-Kontrollkästchen, die Option zur Benachrichtigung nach dem Import (Growth+), die persönliche Notiz und die Beispielvorschau funktionieren genau wie bei den CSV-Importern; das gemeinsame Verhalten beschreibt der Migrationsüberblick.
Rückgängig machen
Ein Lemon-Squeezy-Abruf erzeugt denselben umkehrbaren Importjob wie jede andere Quelle. Rückgängig in der Importhistorie entfernt die Affiliates, die der Job angelegt hat (und gibt erhaltene Slugs wieder frei), damit du sauber neu starten kannst; Affiliates, die sich bereits angemeldet haben oder Conversions haben, bleiben erhalten und werden gemeldet. Ein erneuter Durchlauf ohne vorheriges Rückgängig ist ebenfalls sicher: Bestehende E-Mails werden als Duplikate übersprungen.
Prüfen, ob der Import sauber durchgelaufen ist
- Öffne
/dashboard/affiliatesund vergleiche stichprobenartig ein paar Zeilen mit der Affiliate-Ansicht in Lemon Squeezy: Name, E-Mail, Status. - Wenn du eine Link-Zuordnung eingefügt hast, öffne einen dieser Affiliates und prüfe, ob der Tracking-Link mit seinem ursprünglichen Code endet; sieh dann im Jobdetail nach Zeilen mit
mapping_unmatched(Tippfehler in den eingefügten E-Mails).affist einer der eingebauten Attributionsparameter von Rekomi, erhaltene Codes funktionieren also ohne zusätzliche Konfiguration. - Klicke bei installiertem Rekomi-Snippet auf einen Testlink und prüfe, ob eine Klickzeile erscheint.
Wie es weitergeht
- Lemon Squeezy Connect: verkaufe weiter über Lemon Squeezy, während Rekomi die Conversions erfasst und dein Affiliate-Programm betreibt.
- Tracking und Attribution: der Parameter
aff, die Cookie-Laufzeit und die Stickiness (Bindung eines Kunden an einen Affiliate). - Umzug von anderen Plattformen: die umfassendere Übersicht, welche URLs erhalten bleiben.
- Pläne und Testphasen: was jede Stufe enthält und wie die 14-tägige kostenlose Testphase funktioniert.
Umzug von Tolt
Bring dein Tolt-Programm mit einem einzigen API-Abruf zu Rekomi. Tolt hat keinen Dashboard-Export, deshalb importiert Rekomi deine Partner (mit Link-Slugs und Klickzahlen), deine Leads und deine Provisionshistorie direkt aus der Tolt-API.
Umzug von Gumroad
Bring dein Gumroad-Affiliate-Programm zu Rekomi. Die Affiliate-Liste kommt aus dem Affiliates-CSV-Export von Gumroad, die Verkaufshistorie und die Zuordnung zu den einzelnen Affiliates aus der Gumroad-API. Die Historie wird als abgerechnete Datensätze importiert und schreibt nie nachträglich Guthaben gut.