Umzug von Partnero

Diese Anleitung ist für Marken, die von Partnero zu Rekomi wechseln. Partnero führt Affiliate-, Empfehlungs- und Newsletter-Programme als getrennte Container. Der Hauptweg ist ein API-Abruf mit einem einzigen Schlüssel, mit einer wichtigen Regel zum Geltungsbereich: Partnero-API-Schlüssel gelten pro Programm. Du führst also für jedes Programm einen eigenen Import mit dem Schlüssel dieses Programms aus.

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)

1. Öffne in Partnero das Programm, das du umziehst, dann Integration → API, und erstelle einen API-Schlüssel. Der Schlüssel wird nur einmal angezeigt und gilt nur für dieses eine Programm.
2. Öffne /dashboard/settings/migrate, wähle Partnero, 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.
3. Lass die Schalter Leads importieren und Provisionshistorie importieren eingeschaltet (oder schalte einen davon aus) und klicke auf Von Partnero abrufen.
4. Konten mit mehreren Programmen: Wiederhole das für jedes Programm mit dessen eigenem Schlüssel, jeweils in die Rekomi-Kampagne deiner Wahl.

Das importiert der Abruf:

• Partner: E-Mail, Vor- und Nachname sowie der Status (active wird als Freigegeben importiert, pending als Ausstehend, archived als Pausiert; ein aktiver, aber nicht freigegebener Partner wird als Ausstehend importiert; gelöschte Partner werden komplett übersprungen).
• Empfehlungscodes und Klickzahlen: Beides steht nur im Detailobjekt jedes einzelnen Partners in Partnero. Der Abruf liest die Partnerdetails deshalb einzeln, begrenzt nach Anzahl und Zeit. Der Empfehlungscode jedes Partners (der ?aff=-Wert aus seinem Standard-Empfehlungslink) bleibt als sein Rekomi-Slug erhalten, wenn er die üblichen Slug-Prüfungen besteht, und seine Gesamtzahl referrals.clicks wird übernommen. Sehr große Listen jenseits dieser Grenze werden mit neuen Slugs und null Klicks importiert, und die Importzusammenfassung nennt die genaue Anzahl.
• Leads: Vermittelte Kunden ohne Transaktion (erfasste Registrierungen, die nie gekauft haben) werden als Lead-Datensätze ohne Betrag importiert und ihrem Partner zugeordnet.
• Provisionshistorie: der Verkaufsbetrag jeder Transaktion plus ihr Reward-Betrag (die Provision), die Währung pro Zeile, das Datum und die Identität des Kunden. Partnero gibt Beträge als Dezimalzahl in der Haupteinheit an (Rewards können drei Nachkommastellen haben, etwa 29.997); Rekomi rechnet mit der echten Zahl der Nachkommastellen der jeweiligen Währung um und rundet halbe Werte von null weg. Durch Erstattungen entfernte Transaktionen, Kontogutschriften, Punkte-Rewards ohne Geldwert sowie abgelehnte Rewards werden nie importiert. Partnero gibt pro Reward keinen Abrechnungsstatus heraus, deshalb wird alles als abgerechnete, gesperrte Historie importiert: Durch den API-Abruf wird nichts auszahlbar.

Das kann der Abruf nicht importieren: die Auszahlungsdaten der Partner (Partnero stellt sie nicht bereit; Affiliates richten ihre Auszahlungen in Rekomi neu ein), auszahlbare Guthaben (nutze dafür den CSV-Ablauf aus Schritt 2 mit seiner Vorschau), Gutscheinzuweisungen, die Warteschlange der von Hand eingereichten Leads in Partnero (eine andere Ressource als die erfassten Registrierungen) und Override-Provisionen aus mehrstufigen Programmen (nur die direkte Provision pro Transaktion wird importiert; Override-Provisionen würden den Verkauf doppelt zählen). 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 Transaktionsschlüssel von Partnero.

Die CSV als Ausweichweg

Der Export unter Reporting and Management in Partnero (Zeilen auswählen, Export, direkter Download) taugt als Ausweichweg für die Affiliate-Liste: Der Importer ordnet E-Mail, Vorname, Nachname, Freigabestatus und die Schlüsselspalte tolerant zu. Kunden und Transaktionshistorie kommen nur über den API-Abruf.

Was der CSV-Importer übernimmt

Status-Zuordnung

Archivieren lässt sich in Partnero rückgängig machen (es gibt eine Wiederherstellung), deshalb werden archivierte Partner als Pausiert importiert, und ihre Historie bleibt importierbar. Nach dem Import kannst du jede Zeile in /dashboard/affiliates über die Sammelaktion für den Status neu einstufen.

So bleiben Slugs erhalten

Partnero-Empfehlungslinks tragen den Empfehlungsschlüssel des Partners als Query-Parameter, meistens ?aff=, je nach Programm auch ?ref= oder ?via=, zum Beispiel brand.com?aff=alex. Alle drei sind eingebaute Attributionsparameter von Rekomi, deshalb werden bestehende Partnero-Links in Rekomi weiter richtig zugeordnet, sobald du das Tracking-Snippet austauschst, überall dort, wo der Empfehlungsschlüssel als Slug erhalten geblieben ist (Bedingungen siehe unten), ganz gleich, welche Parametervariante dein Programm genutzt hat.

Der Importer übernimmt den Schlüssel selbst als Rekomi-Slug, wenn:

1. Der begrenzte Einzelabruf der Partnerdetails diesen Partner erreicht hat (sehr große Listen jenseits der Grenze bekommen neue Slugs, die Zusammenfassung nennt sie).
2. Der Schlüssel ein gültiger Alias ist: 3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, kein Bindestrich am Anfang oder Ende.
3. Der Slug im globalen Rekomi-Namensraum noch frei ist.

Partnero-Links im Subdomain-Stil (alex.yourbrand.com) beruhen auf DNS und lassen sich nicht übernehmen; leite sie bei der Umstellung um oder lege sie still.

Umstellung Schritt für Schritt

1. API-Abruf ausführen (pro Programm)

Erstelle unter Program → Integration → API einen Schlüssel und führe den Abruf unter /dashboard/settings/migrate aus. Bei Konten mit mehreren Programmen wiederholst du das für jedes Programm.

2. Attributionsparameter: nichts zu konfigurieren

aff, ref und via sind alle eingebaute Attributionsparameter von Rekomi, deshalb führen bestehende Links ohne jede Konfiguration zum richtigen Affiliate.

3. Importergebnis prüfen

Der Import läuft synchron und zeigt das Ergebnis Zeile für Zeile, auch wie viele Partner wegen der Grenze beim Detailabruf einen neuen Slug bekommen haben. Jeder Job steht in der Importhistorie und lässt sich dort mit Rückgängig zurücknehmen.

4. Automatische Benachrichtigung aktivieren (nur Growth+)

Partnero-Affiliates müssen ihre Auszahlungen in Rekomi neu einrichten (Partnero gibt keine Auszahlungsdaten heraus), deshalb lohnt sich die Benachrichtigung: Sie gibt jedem Affiliate seinen Link zum Beanspruchen des Kontos, und dort richtet er auch seine Auszahlungen ein. Schick dir vorher selbst ein Beispiel.

5. Tracking-Snippet austauschen

Installiere das Tracking-Snippet von Rekomi und entferne dann das Universal-Skript von Partnero. Bestehende ?aff=-Links werden ab sofort über Rekomi zugeordnet. Lass Partnero noch 24 bis 48 Stunden parallel laufen und kündige es dann.

Was NICHT importiert wird

Typische Stolperfallen

Ein Schlüssel, ein Programm. Ein Abruf mit dem Schlüssel von Programm A sieht Programm B nie. Wenn das Ergebnis leer oder zu klein aussieht, prüfe, welchen Programmschlüssel du eingefügt hast.

Rewards mit drei Nachkommastellen. Partnero-Rewards können drei Nachkommastellen haben (29.997); Rekomi rundet auf die nächste kleinste Währungseinheit, halbe Werte von null weg (3000 Cent).

Sehr große Listen. Empfehlungscodes und Klicks werden pro Partner und begrenzt gelesen (nach Anzahl und Laufzeit), damit der Import reaktionsschnell bleibt. Partner jenseits der Grenze werden mit neuen Slugs importiert, und ihre alten Empfehlungsschlüssel werden nicht mehr zugeordnet (ein bekannter Parametername kann keinen nicht registrierten Schlüssel auflösen). Den Abruf erneut auszuführen behebt das nicht: Bereits importierte Affiliates werden übersprungen, ohne dass ihre Slugs aktualisiert werden. Bitte stattdessen den Support, die Slugs nachträglich zu importieren.

Prüfen, ob der Import sauber durchgelaufen ist

1. Öffne /dashboard/affiliates und vergleiche stichprobenartig 3 bis 5 Zeilen mit den Daten in Partnero.
2. Öffne die Detailseite eines Affiliates und prüfe, ob der Empfehlungsschlüssel erhalten geblieben ist (oder ein neuer Slug, wenn er jenseits der Grenze lag).
3. Klicke bei installiertem neuem Snippet auf einen bestehenden ?aff=-Link eines Affiliates und prüfe, ob innerhalb weniger Sekunden eine Klickzeile erscheint.
4. Schick dir eine Beispielbenachrichtigung, bevor du den Massenversand startest.

Historie und Einnahmen importieren

Der API-Abruf importiert die Transaktionshistorie bereits als gesperrte, abgerechnete Datensätze. Nutze 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 Partnero nutzt die allgemeinen Spalten (E-Mail des Affiliates, Betrag, Provision, Währung, Datum). Die vollständige Referenz findest du im Migrationsüberblick.

Wie es weitergeht

• Tracking und Attribution: die Parameter aff/ref/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.