Umzug von PartnerStack

Diese Anleitung ist für Marken, die von PartnerStack zu Rekomi wechseln. Der Importer liest den CSV-Export von PartnerStack (du bekommst per E-Mail einen Download-Link, der 30 Minuten gilt), dedupliziert über die E-Mail-Adresse, importiert Zeilen standardmäßig als Freigegeben (archivierte Partner landen als Pausiert) und schickt jedem Affiliate eine Einladung, mit der er sein Konto mit einem Klick beansprucht.

Von den 8 unterstützten Migrationen weicht PartnerStack im Ablauf am stärksten ab. Die CSV enthält außer archived_status keine Statusspalte, und die Tracking-URLs sind pfadbasiert (partner.brand.com/refer/alex) statt über einen Query-String aufgebaut. Die URL-Erhaltung braucht deshalb einen zusätzlichen Schritt. Der Importer bringt die Liste sauber herüber; dass alte Links weiter funktionieren, ist optional und läuft über Weiterleitungen per Reverse Proxy.

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

Was der Importer übernimmt

PartnerStack dokumentiert sein Exportschema nicht offiziell, und die Spalten hängen davon ab, welchen Export du ausgeführt hast. Der Importer ordnet die Spaltenüberschriften unscharf zu (ohne Rücksicht auf Groß- und Kleinschreibung, mit Synonymen, auch für die Überschriften mit Tippfehlern von PartnerStack selbst). Dieselbe CSV funktioniert also, egal ob dein Export partner_email oder email, partner_firstname oder first_name usw. enthält. Andere Spalten (partner_group, partner_tier, partner_joined_date, leads, customers, revenue, Tags, die Summenspalten total_*) werden stillschweigend ignoriert.

Status-Zuordnung: wie es in der Praxis aussieht

Der PartnerStack-Export enthält fast keinen Status. Die Oberfläche verteilt Partner auf Tabs (All Partners / Pending / Declined / Removed), aber das einzige Statussignal im Export ist archived_status: Archivierte Partner werden als Pausiert importiert, und der Importer setzt jede andere Zeile standardmäßig auf Freigegeben.

Das ist das Wichtigste, was du über einen Umzug von PartnerStack wissen musst: Wenn du in PartnerStack Partner hast, die nicht freigegeben sind, hast du zwei Möglichkeiten:

Option A: nach dem Import gesammelt neu einstufen

Führe einen einzigen Import aus dem Tab All Partners aus. Alle Zeilen landen als Freigegeben. Öffne dann in Rekomi /dashboard/affiliates, filtere nach Name oder E-Mail, um die Partner zu finden, die vorher Pending, Declined oder Removed waren, und stufe sie über die Sammelaktion für den Status neu ein. Diesen Weg wählen die meisten Marken.

Option B: Import Tab für Tab

Exportiere jeden PartnerStack-Tab einzeln (All Partners, Pending, Declined, Removed) und führe vier getrennte Importe in Rekomi aus. Der Nachteil: Du kannst den Standardstatus nicht pro Import ändern (alles wird als Freigegeben importiert), musst die nicht freigegebenen Importe also direkt nach jedem Upload gesammelt neu einstufen. Nicht empfohlen, außer du hast pro Tab sehr unterschiedliche Metadaten.

URL-Erhaltung: pfadbasierte Weiterleitungen

PartnerStack nutzt pfadbasierte Tracking-URLs: partner.brand.com/refer/{partner-name} oder brand.com/refer/{partner-name}. Rekomi nutzt URLs mit Query-String: brand.com/?{param}={slug}, passend zu den Attributionsparametern, die du konfiguriert hast.

Der Importer versucht NICHT, die pfadbasierten URLs von PartnerStack zu erhalten, weil es auf Ebene des Query-Strings keine passende Zuordnung gibt. Importe aus dem Standardpaket Export records bekommen neue Rekomi-Slugs mit 12 Zeichen; wenn deine Datei eine Spalte Partner key enthält (der Export Partner performance report hat sie), bleibt dieser Schlüssel als Rekomi-Slug des Affiliates erhalten, was die Weiterleitungsoption unten deutlich einfacher macht.

Damit bestehende PartnerStack-Links nach der Umstellung weiter funktionieren, hast du zwei Möglichkeiten:

Option A: Weiterleitung per Reverse Proxy (jeder Link bleibt erhalten)

Richte an deiner Edge (Cloudflare Worker, Vercel-Rewrite, nginx) eine Weiterleitung ein, die den alten PartnerStack-Pfad auf den neuen Rekomi-Query-String abbildet:

/refer/:partner   →   /?via=:partner   (301 redirect, preserve query string)

Dafür muss jeder PartnerStack-Partnername einem Rekomi-Slug entsprechen. Passe dazu den Slug jedes importierten Affiliates in /dashboard/affiliates/{id} an seinen PartnerStack-Partnernamen an, ODER füge deiner CSV vor dem Upload eine Spalte partner_key hinzu; der PartnerStack-Importer liest nur partner_key als Slug. Bei jedem anderen Spaltenaufbau führst du den Import über die Quelle Eigener Import aus und ordnest dort deine Slug-Spalte zu (das Format findest du in der Anleitung Umzug von anderen Plattformen).

Bei kleinen Migrationen (weniger als 50 Affiliates) melde dich beim Support; wir können ein einmaliges Umschreiben der Slugs als Teil des Onboardings für Early Adopter einplanen.

Option B: Affiliates über ihren neuen Link informieren (bestehende Links aufgeben)

Wenn es für dich in Ordnung ist, dass Affiliates ihre bestehenden PartnerStack-Links durch neue Rekomi-Links ersetzen, lass die Weiterleitung ganz weg. Schick jedem importierten Affiliate über die automatische Benachrichtigung eine E-Mail; sie enthält einen Button Konto übernehmen, und sein neues Rekomi-Dashboard zeigt ihm seinen neuen Tracking-Link.

Option B ist für die Marke deutlich weniger Arbeit. Der Nachteil: Alle externen Links auf Landingpages von Creatorn, in Social-Media-Bios, YouTube-Beschreibungen usw. muss der Affiliate selbst aktualisieren. Bei Programmen mit passiven Affiliates ist das oft ein K.-o.-Kriterium; nimm dann Option A.

Umstellung Schritt für Schritt

1. Export aus PartnerStack

Öffne in PartnerStack Partner Management → All Partners und klicke auf Export. PartnerStack schickt dir eine E-Mail mit einem Download-Link, der nach 30 Minuten abläuft. Speichere die CSV lokal, bevor der Link abläuft.

Wenn du Partner auf Pending, Declined und Removed verteilt hast und sie mit ihrem ursprünglichen Status herüberholen willst, wiederhole den Export für jeden Tab. Für die meisten Marken geht es schneller, All Partners einmal zu exportieren und nach dem Import neu einzustufen.

2. Vor dem Upload die URL-Strategie festlegen

Entscheide dich für Option A (Weiterleitungen) oder Option B (Links aufgeben). Bei Option A bereitest du die Slug-Zuordnung jetzt vor. Der Importer legt die Slugs beim Upload fest; wer sie danach ändern will, muss die Affiliates einzeln bearbeiten oder den Support kontaktieren.

3. CSV hochladen

Öffne /dashboard/settings/migrate. Wähle PartnerStack als Quelle, wähle deine Zielkampagne in Rekomi und lade die CSV hoch. Jede Zeile landet als Freigegeben, außer archivierten Partnern, die als Pausiert landen.

4. Nicht freigegebene Partner neu einstufen

Filtere deine importierte Liste in /dashboard/affiliates und setze über die Sammelaktion für den Status die Partner, die in PartnerStack Pending, Declined oder Removed waren, auf Abgelehnt oder Gesperrt.

5. Slugs anpassen (nur Option A)

Wenn du dich für die Weiterleitung entschieden hast, passe jetzt den Slug jedes importierten Affiliates an seinen PartnerStack-Partnernamen an. Das geht einzeln in /dashboard/affiliates/{id} oder über die öffentliche API. Bei mehr als 50 Affiliates kontaktiere den Support für eine Sammeländerung.

6. Automatische Benachrichtigung aktivieren (nur Growth+)

Hake Affiliates nach dem Import benachrichtigen an und schreib eine persönliche Notiz. Wenn du Option B gewählt hast (keine Weiterleitung), erwähne in der Notiz unbedingt den Linkwechsel, damit Affiliates wissen, dass sie ihre geteilten Links aktualisieren müssen.

7. Tracking austauschen und kündigen

Installiere das Tracking-Snippet von Rekomi auf deiner Marketing-Website, richte bei Option A deine Weiterleitungsregel ein und kündige dann PartnerStack.

Affiliate, Empfehlungspartner oder Reseller: Was wird importiert?

PartnerStack kennt drei Partnertypen auf einer Plattform: Affiliates, Empfehlungspartner (referral partners) und Reseller. Die CSV unterscheidet nicht zwischen ihnen; alles aus demselben Export landet als Affiliates in derselben Rekomi-Kampagne.

Wenn du für jeden Partnertyp ein eigenes Programm führst, exportiere jedes Programm einzeln aus PartnerStack und importiere es in eine eigene Rekomi-Kampagne. Sonst landen Empfehlungspartner und Reseller zusammen mit deinen Affiliates, obwohl sie andere Provisionen erwarten.

Am saubersten wird es so: Lege in Rekomi pro Partnertyp eine Kampagne an, exportiere pro PartnerStack-Programm und führe pro Paar einen Import aus.

Was NICHT importiert wird

Typische Stolperfallen

Der Download-Link in der E-Mail ist abgelaufen. Die Links von PartnerStack laufen 30 Minuten nach dem Erstellen ab. Exportiere erneut.

Meine importierten Affiliates sind alle freigegeben, obwohl einige ausstehend sein sollten. Das ist das Standardverhalten: Die PartnerStack-CSV enthält außer archived_status keinen Status (archivierte Zeilen landen als Pausiert). Stufe sie über /dashboard/affiliates gesammelt neu ein.

Die alten /refer/alex-Links funktionieren nicht mehr. Ohne Weiterleitungsregel ist das zu erwarten. Richte entweder die Weiterleitung ein (Option A) oder informiere die Affiliates über ihren neuen Link (Option B). Siehe den Abschnitt zur URL-Erhaltung oben.

Ich habe aus All Partners exportiert, aber die Zahl der Partner wirkt zu niedrig. Manche PartnerStack-Konten legen inaktive oder archivierte Partner in einem Tab ab, der unter All Partners nicht sichtbar ist. Prüfe die Anzahl in jedem Tab einzeln und exportiere bei Bedarf erneut.

Meine CSV hat Spalten, die der Importer nicht erkennt. Das ist zu erwarten. Der Importer akzeptiert jeden Spaltenaufbau; unbekannte Spalten werden stillschweigend ignoriert. Nur die Pflichtspalte email (oder partner_email) muss vorhanden sein.

Hinweis zur Übernahme durch AppDirect

PartnerStack wurde am 14. April 2026 von AppDirect übernommen. AppDirect hat zugesagt, die Oberfläche und das Produkt für PartnerStack-Kunden kurzfristig nicht zu ändern. Das oben beschriebene Exportformat ist zum Zeitpunkt dieser Anleitung stabil; durch die unscharfe Zuordnung kommt der Importer auch mit umsortierten oder umbenannten Spalten zurecht, falls sich das Format einmal ändert.

Prüfen, ob der Import sauber durchgelaufen ist

Wenn der Job abgeschlossen ist:

1. Öffne /dashboard/affiliates und prüfe stichprobenartig 5 bis 10 Zeilen darauf, ob Name und E-Mail stimmen.
2. Prüfe, ob jede Zeile standardmäßig als Freigegeben importiert wurde (nach Status filtern).
3. Bei Option A: Prüfe, ob die Slugs einiger Affiliates ihren PartnerStack-Partnernamen entsprechen.
4. Richte deine Weiterleitungsregel ein und teste 2 bis 3 bekannte Partner-URLs von Anfang bis Ende.
5. Schick dir eine Beispielbenachrichtigung.

Starte dann den Massenversand der automatischen Benachrichtigung und kündige PartnerStack.

Historie und Einnahmen importieren

Um die bisherigen Ergebnisse jedes Affiliates herüberzuholen, exportiere deine CSV mit Transaktionen und Rewards aus PartnerStack und lade sie unter Einstellungen > Umzug > Schritt 2 hoch (getrennt von der Affiliate-Liste oben).

• Frühere Conversions und Provisionen werden dem Affiliate über die E-Mail-Adresse (oder den erhaltenen Slug) zugeordnet und mit Betrag und Datum aus deinem Export erfasst.
• PartnerStack dokumentiert nicht, in welcher Einheit das Paket Beträge angibt; Rekomi liest sie als Beträge in der Haupteinheit. Vergleiche deshalb immer die Summen in der Vorschau mit PartnerStack, bevor du den Import bestätigst. Die Provisionsdatei hat außerdem keine Währungsspalte (für diese Zeilen gilt die Heimatwährung deines Kontos).
• Provisionen, die PartnerStack bereits ausgezahlt hat, werden als gesperrte Historie importiert (sie zählen in den Gesamtwerten mit und werden nie erneut ausgezahlt). Provisionen, die PartnerStack zurückgehalten hat, werden ebenfalls als gesperrte Historie importiert und nie auszahlbar. Noch offene Provisionen werden nur dann für eine Rekomi-Auszahlung eingeplant, wenn du das auf dem Vorschaubildschirm autorisierst.
• Wenn dein Export die Kunden-ID beim Zahlungsdienstleister enthält (die PartnerStack-Spalte provider_key, bei über Stripe abgerechneten Programmen die Stripe-Kunden-ID) und dein Stripe verbunden ist, zahlen bestehende Abonnements bei Verlängerungen weiter an denselben Affiliate.
• Eine Vorschau im Probelauf zeigt dir, was importiert wird (und genau wie viel Rekomi auszahlen würde, falls überhaupt etwas), bevor du bestätigst. Ein erneuter Lauf ist sicher. Stornierte und abgelehnte Zeilen werden übersprungen.

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

Wie es weitergeht

• Umzug von anderen Plattformen: die vollständige Matrix zur URL-Erhaltung.
• Tracking und Attribution: Standard- und eigene Attributionsparameter.
• Affiliates verwalten: Abläufe, um den Status gesammelt neu einzustufen.
• Rekomi vs. PartnerStack: der direkte Vergleich, falls du noch am Abwägen bist.