Umzug von Affonso

Diese Anleitung ist für Marken, die von Affonso zu Rekomi wechseln. Der Hauptweg ist ein API-Abruf mit nur einem Schlüssel: Füge einen Affonso-API-Schlüssel ein, und Rekomi importiert in einem Durchlauf deine Affiliate-Liste (jede bestehende Tracking-ID bleibt als Rekomi-Link-Code erhalten), deine Leads und Trials und deine Provisionshistorie, dazu die Programmdaten, die du brauchst, um deine Kampagne nachzubilden. Ein CSV-Upload bleibt als zweiter Weg für die Datei, die du ursprünglich in Affonso importiert hast, oder für einen Export vom Affonso-Support.

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)

Affonso hat keinen CSV-Export zum Selbermachen für Affiliates, Referrals oder Commissions (das Hilfe-Center verweist für einen „comprehensive export“ an den Support), deshalb ist der API-Abruf der einfachste und zugleich vollständigste Weg. Die API ist in jedem Affonso-Plan enthalten.

1. Öffne in Affonso Connect, API (affonso.io/app/affiliate-program/connect/api), klicke auf Create Key, gib dem Schlüssel Leseberechtigungen für Affiliates, Referrals, Commissions und Payouts (und für die Programmeinstellungen, wenn deine Rolle das erlaubt) und kopiere ihn. Er wird nur einmal angezeigt. Seit September 2026 bestimmt auch deine Teamrolle, was ein Schlüssel lesen darf, erstelle ihn also als Admin.
2. Öffne /dashboard/settings/migrate, wähle Affonso, wähle deine Zielkampagne in Rekomi und füge den Schlüssel ein. Er wird einmal im Arbeitsspeicher verwendet und nie gespeichert, protokolliert oder erneut angezeigt.
3. Lass die Schalter Leads und Trials importieren und Provisionshistorie importieren an (oder schalte einen davon aus) und klicke auf Von Affonso abrufen.

Ein Affonso-Schlüssel deckt ein Affonso-Programm ab. Wenn du mehrere Programme betreibst, erstelle in jedem einen Schlüssel und führe pro Programm einen Abruf in eine eigene Rekomi-Kampagne aus.

Was der Abruf importiert:

• Affiliates: E-Mail, Name, Status (APPROVED wird als Freigegeben importiert, PENDING als Ausstehend, REJECTED als Abgelehnt; ein Affiliate, der das Onboarding nie abgeschlossen hat, landet als Ausstehend, damit du ihn freigeben kannst), die PayPal-E-Mail, wenn PayPal seine Auszahlungsmethode ist, sein Registrierungsdatum bei Affonso (wird zum Beitrittsdatum in Rekomi), sein angegebenes Rechnungsland und die Tracking-ID, die als Rekomi-Link-Slug erhalten bleibt, damit bestehende Links weiter funktionieren.
• Gruppen: Jede Affonso-Gruppe wird zu einer Rekomi-Partnergruppe mit demselben Namen (eine bereits vorhandene wird zugeordnet), und jeder Affiliate landet in seiner Gruppe. Eine Gruppe, deren einziger Anreiz für alle Verkäufe über die gesamte Kundenlaufzeit gilt, übernimmt diesen Satz; alle anderen behalten den Standard deiner Kampagne.
• Individuelle Sätze pro Affiliate: Ein Override, der für alle Pläne und Produkte über die gesamte Kundenlaufzeit gilt, als einfacher Prozentsatz oder Festbetrag, wird in Rekomi zur individuellen Provision des Affiliates. Eingeschränkte (Jahrespläne, bestimmte Produkte, Registrierungen, Trials), zeitlich oder auf Zahlungen begrenzte, dynamische, nicht monetäre oder mehrfache Overrides werden nicht übernommen; die Zeilennotizen beschreiben sie, damit du entscheiden kannst.
• Zeilennotizen: Gutscheincodes (Affonso erstellt echte Promotion-Codes beim Zahlungsanbieter; lege sie als Rekomi-Kampagnengutscheine neu an), Auszahlungswege außer PayPal (Wise, Payoneer, Überweisung und so weiter, mit der E-Mail, falls vorhanden), Firmenname und die Beschreibung des Overrides.
• Klickzahlen: Affonso stellt keine Klickliste bereit, deshalb kommen die Klicks seit Beginn aus einer Analytics-Abfrage pro Affiliate. Diese Schleife ist begrenzt (500 Affiliates, 75 Sekunden); Affiliates jenseits der Grenze werden mit null Klicks importiert, die Zusammenfassung nennt ihre Anzahl, und ihre Link-Codes bleiben trotzdem erhalten.
• Leads und Trials: Referrals im Affonso-Status lead oder trialing (registriert oder Testphase gestartet, nie bezahlt) werden als Lead-Datensätze ohne Geldbetrag importiert und ihrem Affiliate zugeordnet, mit Name, E-Mail (wenn das E-Mail-Tracking in Affonso aktiv ist) und Stripe-Kunden-ID des Kunden.
• Provisionshistorie: Verkaufsbetrag und Provisionsbetrag jeder Provision (Dezimalbeträge in der Währung deines Affonso-Programms), Währung, Datum und Status. Provisionen mit paid werden als abgerechnete Historie importiert; Provisionen mit pending, pending_manual_approval, ready_for_payment und processing_payout werden ebenfalls als gesperrte Datensätze importiert (aus dem API-Abruf wird nichts auszahlbar), und ihre Summe pro Währung erscheint in der Zusammenfassung als bei Affonso noch offen, damit du sie dort vor der Umstellung auszahlen kannst. Provisionen mit declined, refunded und dispute sowie erstattete oder fehlgeschlagene Verkäufe werden übersprungen; ein teilweise erstatteter Verkauf behält die reduzierte Provision, die Affonso bereits erfasst hat. Abonnements werden als wiederkehrend importiert, inklusive Stripe-Kunden- und Abo-IDs, sodass bestehende Abonnements bei Verlängerungen weiter demselben Affiliate gutgeschrieben werden. Anreize in Form von Guthaben, Gratismonaten oder Punkten sind kein Geld und werden übersprungen (in der Zusammenfassung gezählt).
• Programmdaten: Die Link-Parameter, die dein Affonso-Programm genutzt hat (via, ref, aff, atp, affonso, jeder davon ein Rekomi-Standard), und seine Zahlungsbedingungen (Provisionsart und Satz, Laufzeit, Haltetage, Auszahlungsschwelle, Auszahlungsrhythmus, Cookie-Laufzeit) erscheinen in der Zusammenfassung, damit du deine Kampagneneinstellungen in Rekomi angleichen kannst.

Was der Abruf nicht importieren kann: auszahlbare Guthaben (begleiche sie in Affonso oder nutze den CSV-Ablauf aus Schritt 2 mit seiner Vorschau, wenn du eine Datei hast), Logs auf Klickebene, Auszahlungsdatensätze (abgebildet durch den Bezahlt-Status der Provisionen), Steuerformulare, Verknüpfungen zu übergeordneten Affiliates bei Sub-Affiliates (nicht in der Affonso-API), Onboarding-Antworten, Werbemittel und Portaleinstellungen. Von jeder Liste werden bis zu 5,000 Zeilen abgerufen, und Affonso begrenzt die Anfragen je nach Plan (300 Anfragen pro Minute bei Launch), ein großer Abruf kann also ein bis zwei Minuten dauern; das Ergebnis sagt dir, ob ein Abruf abgeschnitten wurde.

Den Abruf erneut auszuführen ist sicher: Affiliates werden per E-Mail dedupliziert, Historienzeilen über die IDs von Affonso, und Gruppen werden über den Namen zugeordnet.

Die CSV als Ausweichweg

Wenn du die Datei noch hast, die du in Affonso importiert hast (ihr Format ist Name, Email, Tracking Parameter, PayPal Email, getrennt durch Komma oder Semikolon), oder wenn dir der Affonso-Support einen Export geschickt hat, nimmt der CSV-Importer sie an.

Was der CSV-Importer übernimmt

Die Überschriften werden tolerant zugeordnet (Groß- und Kleinschreibung, Leerzeichen und Unterstriche spielen keine Rolle).

Status-Zuordnung

Groß- und Kleinschreibung spielt beim Abgleich keine Rolle. Bei freigegebenen Importen wird ApprovedAt auf das Registrierungsdatum bei Affonso gesetzt (oder auf den Importzeitpunkt, wenn die Datei keines enthält), damit die Berechnung der Auszahlungsberechtigung stimmt.

So bleiben Slugs erhalten

Deine Affiliates müssen keine neuen Links teilen.

Die Tracking-URL von Affonso ist standardmäßig brand.com/?via={tracking_id}, und ein Programm kann zusätzlich ref, aff, atp oder affonso aktivieren. Die Standard-Tracking-URL von Rekomi ist brand.com/?via={slug}, und alle fünf Affonso-Parameter sind eingebaute Attributionsparameter, sodass jede Variante sofort erkannt wird. Der Importer registriert die Tracking-ID jedes Affiliates (in Kleinbuchstaben) als Rekomi-Slug des neuen Affiliates.

Der Slug bleibt genau dann erhalten, wenn:

1. Die Tracking-ID ein gültiger Alias ist: 3 bis 64 Zeichen, Buchstaben, Ziffern und Bindestriche, kein Bindestrich am Anfang oder Ende. Affonso erlaubt dieselbe Form, das ist also fast immer erfüllt.
2. Der Slug im globalen Namensraum von Rekomi noch frei ist (Slugs sind plattformweit eindeutig, nicht pro Organisation).

Sind beide Bedingungen erfüllt, funktioniert jeder bestehende Link wie brand.com/?via=alex (oder ?ref=alex, ?atp=alex) in Rekomi weiter, sobald du das Tracking-Snippet austauschst. Kollisionen werden pro Zeile im Ergebnis des Importjobs protokolliert; der Affiliate wird trotzdem importiert, mit einem neuen Slug.

Umstellung Schritt für Schritt

1. API-Abruf ausführen

Erstelle den Schlüssel in Affonso unter Connect, API und führe den Abruf unter /dashboard/settings/migrate aus (siehe Import per API oben). Lies die Zusammenfassung: Sie nennt die importierten Zeilen, angelegte oder zugeordnete Gruppen, übernommene individuelle Sätze, was bei Affonso noch offen ist, und die Programmbedingungen.

2. Kampagneneinstellungen angleichen

Nutze die Programmbedingungen aus der Zusammenfassung (Satz, Laufzeit, Haltetage, Auszahlungsschwelle, Auszahlungsrhythmus, Cookie-Laufzeit), um in deiner Rekomi-Kampagne dieselben Regeln festzulegen, oder nutze die Gelegenheit, sie zu ändern. Lege Affiliate-Gutscheincodes als Rekomi-Kampagnengutscheine neu an, wenn dein Programm welche genutzt hat.

3. Attributionsparameter: nichts zu konfigurieren

via, ref, aff, atp und affonso gehören alle zu den 21 eingebauten Attributionsparametern von Rekomi; es gibt nichts zu konfigurieren.

4. Begleichen, was Affonso noch schuldet

Provisionen, die in Affonso ausstehend, in manueller Prüfung, freigegeben oder in Bearbeitung sind, wurden als gesperrte Historie importiert. Die Zusammenfassung summiert sie pro Währung: Erstelle und bezahle diese Auszahlungen in Affonso, bevor du das Affonso-Pixel abschaltest, damit niemand doppelt bezahlt und niemand vergessen wird.

5. 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 sie vor dem Massenversand anzusehen. Der Massenversand ist auf eine E-Mail pro Sekunde gedrosselt; ein Import mit 500 Zeilen dauert insgesamt etwa 8 Minuten.

6. Tracking-Snippet austauschen

Installiere das Tracking-Snippet von Rekomi auf deiner Marketing-Website und verbinde deinen Zahlungsanbieter, entferne dann das Affonso-Pixel. Sobald das neue Snippet live ist, wird jeder bestehende Affiliate-Link über Rekomi statt über Affonso zugeordnet. Lass Affonso noch 24 bis 48 Stunden parallel laufen, wenn du auf Nummer sicher gehen willst, und kündige es dann.

Was NICHT importiert wird

Typische Stolperfallen

Der Abruf meldet, dass der Schlüssel abgelehnt wurde. Affonso-Schlüssel werden nur einmal angezeigt und können ablaufen; erstelle einen neuen mit Leseberechtigungen. Seit September 2026 übernimmt ein Schlüssel die Teamrolle der Person, die ihn erstellt hat, ein Schlüssel von einem Mitglied ohne die passende Berechtigung wird an diesen Endpunkten also abgewiesen.

Gruppen kamen mit dem Standardsatz meiner Kampagne herüber. Eine Gruppe mit eingeschränkten, begrenzten, dynamischen oder mehreren Anreizen lässt sich nicht als ein einziger Gruppensatz in Rekomi abbilden. Die Gruppe wird deshalb mit dem Kampagnenstandard angelegt, und die Zeilennotizen der Affiliates beschreiben die ursprünglichen Anreize. Lege den gewünschten Gruppensatz unter Affiliates, Partnergruppen fest.

Ein Affiliate wurde mit null Klicks importiert. Sehr große Listen stoßen an die Grenze der Analytics-Abfragen pro Affiliate (die Zusammenfassung nennt die Anzahl); ihre Link-Codes bleiben trotzdem erhalten, und neue Klicks zählen ab dem ersten Tag.

Einige Provisionen wurden als „kein Geld“ übersprungen. Affonso kann Anreize als Guthaben, Gratismonate oder Punkte auszahlen; diese Zeilen haben keine Währung und werden nie importiert. Die Zusammenfassung zählt sie.

Prüfen, ob der Import sauber durchgelaufen ist

Nachdem der Importjob abgeschlossen ist:

1. Öffne /dashboard/affiliates und prüfe stichprobenartig 3 bis 5 Zeilen. Prüfe, ob Name, E-Mail, Status, Gruppe und Beitrittsdatum mit Affonso übereinstimmen.
2. Öffne die Detailseite eines Affiliates und prüfe, ob der Tracking-Link brand.com/?via={original-tracking-id} lautet und, wo du eine erwartest, die individuelle Provision stimmt.
3. Klicke bei installiertem neuem Snippet auf deinen eigenen Affiliate-Testlink und prüfe, ob innerhalb weniger Sekunden eine Klickzeile unter diesem Affiliate erscheint.
4. Vergleiche die in der Zusammenfassung genannte Summe, die bei Affonso noch offen ist, mit der Seite für ausstehende Auszahlungen in Affonso, bevor du sie dort bezahlst.

Historie und Einnahmen importieren

Der API-Abruf importiert deine Provisionshistorie (und Leads) bereits als gesperrte, abgerechnete Datensätze. Nutze stattdessen den CSV-Ablauf aus Schritt 2, wenn du einen Provisionsexport vom Support im API-Vokabular von Affonso hast (affiliate_email oder tracking_id, sale_amount, commission_amount, commission_currency, status, sales_status, created_at) oder wenn unbezahlte Provisionen in Rekomi auszahlbar werden sollen: Nur der CSV-Ablauf zeigt vorab das genaue unbezahlte Guthaben und bittet dich, es zu autorisieren.

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

Wie es weitergeht

• Tracking und Attribution: Attributionsparameter anpassen, Cookie-Laufzeit und Stickiness (Bindung eines Kunden an einen Affiliate) einstellen.
• Umzug von anderen Plattformen: die umfassendere Übersicht, welche URLs erhalten bleiben, falls du auch Affiliates auf anderen Plattformen hast.
• Pläne und Testphasen: was jede Stufe enthält und wie die 14-tägige kostenlose Testphase funktioniert.
• Rekomi vs. Affonso: Funktionsvergleich nebeneinander, falls du noch am Abwägen bist.