Umzug von UpPromote

Diese Anleitung ist für Marken, die von UpPromote zu Rekomi wechseln. Der Hauptweg ist ein API-Abruf mit einem einzigen Schlüssel; für UpPromote-Pläne ohne API-Zugriff gibt es die CSV als Ausweichweg.

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 UpPromote Settings, Integration, API Key und kopiere deinen Schlüssel. Für den API-Zugriff brauchst du bei UpPromote den Professional-Plan oder höher; die Pläne Free und Growth bieten keinen API-Schlüssel und nutzen die CSV als Ausweichweg unten.
2. Öffne /dashboard/settings/migrate, wähle UpPromote, 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 den Schalter Referral-Historie importieren eingeschaltet (oder schalte ihn aus) und klicke auf Von UpPromote abrufen.

Das importiert der Abruf:

• Affiliates: E-Mail, Vor- und Nachname sowie der Status (active wird als Freigegeben importiert, pending als Ausstehend, inactive als Pausiert).
• Tracking-Link: Der Standard-Affiliate-Link von UpPromote trägt ?sca_ref={affiliateId}.{token}, zum Beispiel store.myshopify.com?sca_ref=2011818.HntgvOZGH7q. Rekomi übernimmt den vollständigen Wert id.token als Slug, wenn er die üblichen Slug-Prüfungen besteht.
• Referral-Historie (Conversions): Verkaufsbetrag und Provision jedes Referrals, dem Affiliate über die E-Mail-Adresse zugeordnet. Die UpPromote-API gibt Beträge als Strings ohne Währungsfeld pro Conversion an, deshalb nimmt Rekomi für jede importierte Zeile die Währung deines Shops an. Ausstehende und freigegebene Referrals werden als unbezahlte Historie importiert, bezahlte als abgerechnete, bezahlte Historie; abgelehnte und erstattete Referrals werden verworfen und nie importiert. Provisionskorrekturen (Teilerstattungen) werden mit der importierten Provision verrechnet, und Zeilen, deren Nettoprovision unter null fällt, werden verworfen.
• PayPal-E-Mail: wird aus dem Objekt payment_info des Affiliates gelesen, mit einer toleranten Suche nach den Schlüsseln (paypal_email, email oder paypal), wenn die Auszahlungsmethode des Affiliates PayPal ist.

Den Abruf erneut auszuführen ist sicher: Affiliates werden über die E-Mail-Adresse dedupliziert, Historienzeilen automatisch.

Die CSV als Ausweichweg

Der Export unter Affiliates, Export affiliate in UpPromote (komplett oder gefiltert) taugt als Ausweichweg für Pläne ohne API-Zugriff. UpPromote veröffentlicht die Spaltenüberschriften seiner CSV nicht, deshalb ordnet der Importer die Spalten tolerant und unscharf zu, statt ein festes Schema zu erwarten: Er sucht die beste Übereinstimmung für E-Mail, Name und Status, ganz gleich, wie die Überschrift genau lautet.

Was der CSV-Importer übernimmt

Status-Zuordnung

Nach dem Import kannst du jede Zeile in /dashboard/affiliates über die Sammelaktion für den Status neu einstufen.

So bleiben Slugs erhalten

Der Standard-Affiliate-Link von UpPromote trägt das Empfehlungs-Token als ?sca_ref={affiliateId}.{token} auf der eigenen Shop-Domain des Händlers. sca_ref ist ein eingebauter Attributionsparameter von Rekomi, deshalb werden bestehende UpPromote-Links in Rekomi weiter richtig zugeordnet, sobald du das Tracking-Snippet austauschst, sofern der vollständige Wert id.token beim Import als Slug erhalten geblieben ist.

Eigene Kurzlinks (ein Weiterleitungspfad wie /alex, verfügbar im Professional-Plan von UpPromote) sind Weiterleitungen im Shop, die mit der App wegfallen und sich nicht erhalten lassen; leite sie bei der Umstellung um oder lege sie still.

Umstellung Schritt für Schritt

1. API-Abruf ausführen

Erstelle in UpPromote unter Settings, Integration, API Key einen Schlüssel und führe den Abruf unter /dashboard/settings/migrate aus. Wenn dein UpPromote-Plan keinen API-Zugriff hat, nutze stattdessen die CSV als Ausweichweg.

2. Attributionsparameter: nichts zu konfigurieren

sca_ref ist ein eingebauter Attributionsparameter von Rekomi, deshalb führen bestehende ?sca_ref=-Links ohne jede Konfiguration zum richtigen Affiliate.

3. Importergebnis prüfen

Der Import läuft synchron und zeigt das Ergebnis Zeile für Zeile. Jeder Job steht in der Importhistorie und lässt sich dort mit Rückgängig zurücknehmen.

4. Automatische Benachrichtigung aktivieren (nur Growth+)

Schick den importierten Affiliates einen Link, über den sie ihr Konto beanspruchen und ihre Auszahlungen in Rekomi einrichten. Schick dir vorher selbst ein Beispiel.

5. Tracking-Snippet austauschen

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

Was NICHT importiert wird

Typische Stolperfallen

Die API hängt am Plan. Die UpPromote-API setzt den Professional-Plan oder höher voraus. Wenn du im Plan Free oder Growth bist, nutze die CSV als Ausweichweg.

Die Shop-Währung wird angenommen. Die UpPromote-API gibt kein Währungsfeld pro Conversion heraus, deshalb wird jedes importierte Referral in der Währung deines Shops behandelt. Wenn du über UpPromote in mehreren Währungen verkaufst, prüfe die importierten Beträge, bevor du eine Auszahlung autorisierst.

Unveröffentlichte CSV-Überschriften. Weil UpPromote die genauen Spaltennamen seines Exports nicht dokumentiert, ordnet der CSV-Importer tolerant zu. Wenn eine Zeile unerwartet übersprungen wird, prüfe, ob die E-Mail-Spalte einen Wert hat.

Prüfen, ob der Import sauber durchgelaufen ist

1. Öffne /dashboard/affiliates und vergleiche stichprobenartig 3 bis 5 Zeilen mit den Daten in UpPromote.
2. Öffne die Detailseite eines Affiliates und prüfe, ob der sca_ref-Slug erhalten geblieben ist.
3. Klicke bei installiertem neuem Snippet auf einen bestehenden ?sca_ref=-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 Referral-Historie bereits als Historiendatensätze (bezahlte Referrals abgerechnet, ausstehende und freigegebene unbezahlt). 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 UpPromote 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: der Parameter sca_ref, 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.