Leads und Anmeldungen tracken

Ein Lead ist eine kostenlose, identifizierte Anmeldung: eine E-Mail-Adresse, die mit einer Empfehlung verknüpft ist und vor jeder Zahlung erfasst wird. Ein erfasster Lead bringt dir zwei Dinge:

1. Dauerhafte Attribution über die E-Mail-Adresse. Zahlt dieselbe E-Mail-Adresse später, wird der Verkauf dem vermittelnden Affiliate gutgeschrieben, auch wenn das Klick-Cookie in der Zwischenzeit gelöscht, blockiert oder abgelaufen ist.
2. Einen Trichter Besucher → Lead → Verkauf. Kostenlose Anmeldungen werden in deinem Dashboard und deinen Auswertungen zu einer echten Stufe der Kundengewinnung, statt dass du nur Klicks und Verkäufe siehst.

Ein Lead erzeugt keine Provision für sich allein. Er hält email + name zur Empfehlung fest; die Provision entsteht weiterhin erst, wenn der bezahlte Verkauf über deinen Zahlungsanbieter oder die S2S-API eingeht.

Standardmäßig aktiv

Lead-Tracking ist für jede Marke standardmäßig aktiv. Die automatische Erfassung unten und die Endpunkte für Browser und S2S funktionieren, sobald der Tracking-Loader installiert ist.

Automatisch bei Stripe, Paddle, Chargebee, Recurly und Creem

Bei Stripe, Paddle, Chargebee, Recurly und Creem werden Leads automatisch erfasst, ganz ohne Code auf deiner Seite. Du brauchst nichts außer dem, was du schon hast:

• den normalen Tracking-Loader (loader.js) auf deiner Website und
• die bestehende Verbindung zu deinem Zahlungsanbieter.

Wenn sich ein vermittelter Besucher für ein Abonnement oder eine kostenlose Testphase anmeldet, erfasst Rekomi den Lead direkt aus dem Webhook, den deine Marke ohnehin von ihrem Zahlungsanbieter bekommt. Kein convert()-Aufruf, keine Verdrahtung im Anmeldeformular. Die erste echte Zahlung wird dann als Verkauf erfasst und demselben Affiliate zugeordnet (die bezahlte Abbuchung findet den Lead über die Kundenhistorie).

Welche Zahlungsanbieter erfassen Leads automatisch?

Bei Stripe, Paddle, Chargebee, Recurly und Creem werden Leads automatisch und ohne Code erfasst: Startet ein vermittelter Besucher ein Abonnement oder eine Testphase, erfasst der Webhook des Zahlungsanbieters den Lead. Bei Braintree, Shopify, Lemon Squeezy, Gumroad, Dodo Payments und Mollie gibt es keine automatische Lead-Erfassung; Rekomi bekommt von ihnen kein brauchbares Anmelde-Event vor der Zahlung, also erfasst du diese Leads stattdessen mit Rekomi.convert() im Browser. Übergib bei Mollie außerdem dieselbe E-Mail-Adresse als billingAddress.email an Einmalzahlungen (oder setze metadata.rekomi_ref darauf): Im gehosteten Checkout läuft kein Skript, der Verkauf kommt also über den Webhook, und die E-Mail-Adresse ordnet ihn dem Lead zu. Eine Zahlung, die zu einem Mollie-Kunden gehört, wird stattdessen über die E-Mail-Adresse dieses Kundendatensatzes zugeordnet. Polar liegt dazwischen: Ein zugeordnetes Abonnement, das mit einer Testphase startet, erfasst automatisch einen $0-Lead (die $0-Bestellung der Testphase trägt die Empfehlung), aber Checkouts ohne Testphase haben kein Anmelde-Event vor der Zahlung, also erfasst du diese mit Rekomi.convert(). Der S2S-Lead-Endpunkt ist Organisationen ohne native Verbindung zu einem Zahlungsanbieter vorbehalten: Solange Stripe (über die Rekomi-App für Stripe), Paddle, Braintree, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Creem, Dodo Payments, Mollie oder die Shopify-App verbunden ist, gibt er 409 (*_connect_active) zurück, damit es bei einer Conversion-Quelle pro Workspace bleibt.

Im Browser: Rekomi.convert()

Der Browser-Aufruf Rekomi.convert() erfasst einen Lead bei der Kontoerstellung. Mit Stripe, Paddle, Chargebee, Recurly und Creem brauchst du ihn für Anmeldungen zu Abonnement oder Testphase nicht, die laufen schon automatisch. In den folgenden Fällen ist er der wichtigste Weg zum Lead.

Freemium und kostenlose Pläne

Hat dein Produkt einen kostenlosen Plan, bei dem die Anmeldung kein Abonnement und keinen Kunden in Stripe oder Paddle anlegt, gibt es kein Event des Zahlungsanbieters, aus dem Rekomi automatisch einen Lead machen könnte. Das betrifft etwa die Hälfte aller SaaS-Produkte, und bei ihnen ist Rekomi.convert() der Hauptweg zur Lead-Erfassung, kein Fallback.

Rufe Rekomi.convert({ email }) bei der Kontoerstellung auf, also in dem Moment, in dem das kostenlose Konto angelegt wird:

Rekomi.convert({ email: "user@example.com" });

Übergib dieselbe E-Mail-Adresse, die der Kunde für die Abrechnung nutzen wird. Wechselt dieser kostenlose Nutzer später auf einen bezahlten Plan, ordnet Rekomi den Verkauf diesem Lead über die E-Mail-Adresse zu (die Attribution über die E-Mail-Adresse weiter unten), und der vermittelnde Affiliate bekommt die Gutschrift, obwohl das Klick-Cookie längst weg ist. Genau das trägt die Attribution über die Lücke zwischen kostenlos und bezahlt, die Wochen oder Monate dauern kann:

Besucher (Klick) -> kostenlose Anmeldung (Lead über convert) -> späteres Upgrade (Verkauf, über die E-Mail-Adresse dem Lead zugeordnet)

Weitere Fälle für convert()

Rekomi.convert() ist außerdem das richtige Werkzeug für:

• Braintree, Shopify, Lemon Squeezy, Gumroad, Dodo Payments und Mollie, wo Rekomi Leads nicht automatisch erfasst; dort hältst du die Anmeldung mit convert() fest (übergib bei Mollie dieselbe E-Mail-Adresse als billingAddress.email an Einmalzahlungen, damit der Verkauf zum Lead passt). Bei Polar erfasst der Start einer Testphase bereits automatisch einen $0-Lead; convert() deckt Anmeldungen ohne Testphase ab.
• Den Lead früher oder mit mehr Daten erfassen: im Anmeldeformular, vor dem Checkout oder zusammen mit einem name.

Kannst du auf der Seite keinen eigenen Code ausführen (eine gehostete Plattform wie beehiiv), nutze stattdessen das Loader-Attribut aus Drei Wege, einen Lead im Browser zu erfassen. Bei beehiiv, Kit, MailerLite, Ontraport und GoHighLevel brauchst du unter Umständen gar keinen Lead: Die Plattformverbindung schreibt Verkäufe anhand des plattformeigenen Anmeldedatensatzes gut und überträgt markierte Anmeldungen als Leads an Rekomi; siehe Leads und Verkäufe aus deiner Plattform.

Er ist auch der direkte Ersatz für Rewardfuls rewardful('convert', { email }) und damit der einfache Weg für Teams, die von Rewardful umziehen.

Sobald das Tracking-Skript (loader.js) installiert ist, rufe Rekomi.convert(...) bei der Anmeldung auf, in dem Moment, in dem ein Nutzer ein Konto anlegt:

Rekomi.convert({ email: "user@example.com", name: "Jane Doe" });

name ist optional. Es gibt außerdem den Alias identify und eine Kurzform mit einem String, alle gleichwertig:

Rekomi.identify({ email: "user@example.com", name: "Jane Doe" });
Rekomi.convert("user@example.com");

Der Aufruf sendet an /api/v1/r/lead/signup und tut nichts, wenn kein Empfehlungskontext oder keine E-Mail-Adresse vorliegt. Du kannst ihn also bedenkenlos immer aufrufen. Willst du es ausdrücklich machen und ihn nur für vermittelte Besucher auslösen, packe ihn in einen ready()-Callback:

Rekomi.ready(function (R) {
  if (!R.referral) return; // visitor was not referred, nothing to record

  Rekomi.convert({
    email: signupForm.email,
    name: signupForm.name,
  });
});

ready() wartet, bis der Empfehlungskontext aufgelöst ist, sodass du R.referral zuverlässig lesen kannst, bevor du entscheidest, ob du den Lead erfasst. Zu referral, affiliate, campaign und ready() siehe die vollständige window.Rekomi-API.

Drei Wege, einen Lead im Browser zu erfassen

Alle drei setzen auf dem Tracking-Loader auf. Wähle den, der dazu passt, wo die E-Mail-Adresse eingetippt wird.

1. window.Rekomi.convert({ email }) aus deinem eigenen Code. Nutze ihn, wenn du den Anmeldeablauf selbst steuerst: Rufe ihn in dem Moment auf, in dem das Konto angelegt wird, wie oben gezeigt. Das ist die genaueste Option und die einzige, die einen name übergeben kann.
2. data-email-selector am Loader-Tag, für ein klassisches HTML-Formular mit Submit. Richte es auf dein E-Mail-Feld aus oder setze data-rekomi-email direkt an das Feld. Der Loader liest den Wert beim Absenden des Formulars, du schreibst also keinen Code.
3. data-rkmi-email-capture="auto" am Loader-Tag, im Tag von Rekomi standardmäßig gesetzt. Der Loader erfasst den Lead in dem Moment, in dem ein vermittelter Besucher eine E-Mail-Adresse fertig in ein E-Mail- oder Textfeld eingetippt hat (bei Änderung oder beim Verlassen des Felds). Zusätzlich liest er die Felder jedes abgeschickten Formulars aus. Damit deckt er gehostete Plattformen und Checkouts direkt auf der Seite ab, bei denen nie ein Formular abgeschickt wird: einen Login-Schritt einer Plattform, der nur ein einfaches Textfeld ist, oder einen Checkout, der in einem Preisblock läuft. Genau das sorgt dafür, dass ein Verkauf auch dann gutgeschrieben werden kann, wenn dein Checkout keine Empfehlung mitgibt. Entferne das Attribut, um es abzuschalten; ausdrückliche Rekomi.convert()-Aufrufe funktionieren weiter, und der Loader greift auf die Erfassung beim Absenden aus Option 2 zurück. Bei beehiiv und Kit ist das optional, sobald in der Plattformverbindung Verkäufe gutschreiben aktiv ist: Dann deckt es nur noch Leser ab, die schon vor ihrem Klick abonniert hatten.

<script async
  src="https://api.rekomi.com/api/v1/r/loader.js"
  data-program-id="{your_program_id}"
  data-rkmi-email-capture="auto"></script>

Hast du aus einer früheren Version einer Rekomi-Installationsanleitung ein separates Snippet zur Lead-Erfassung eingebaut, lösche es; das Attribut ersetzt es.

Für alle drei gelten dieselben Garantien. Ohne Empfehlung wird nichts erfasst, jede E-Mail-Adresse wird pro Browsersitzung einmal gesendet, und der Server entfernt Duplikate. Varianten mit Plus-Adressierung desselben Postfachs (you+test@gmail.com und you@gmail.com) gelten beim Abgleich als dieselbe Person.

Auf einer gehosteten Plattform ohne Verbindung mit „Verkäufe gutschreiben“ erscheint ein Kauf, der ohne passenden Lead bei Rekomi ankommt, nicht als Verkauf. Passiert das, prüfe zwei Dinge: ob der Loader-Tag das Attribut trägt und ob die E-Mail-Adresse auf einer Seite eingetippt wurde, auf der der Loader läuft. Bei beehiiv, Kit, MailerLite, Ontraport und GoHighLevel läuft die Abfrage bei der Plattform nach dem Lead-Abgleich, der Verkauf kann also auch ohne Lead gutgeschrieben werden.

Server-zu-Server (S2S)

Finden Anmeldungen in deinem Backend statt, erfasst du den Lead stattdessen serverseitig:

POST /api/tracking/lead

Der Endpunkt nutzt dieselbe Authentifizierung wie das S2S-Postback für Verkäufe: einen API-Schlüssel per Authorization: Bearer rk_live_* plus einen HMAC-SHA256-Header X-Rekomi-Signature. Die Signatur wird genauso berechnet wie beim Verkaufs-Endpunkt, du kannst also denselben Helper wiederverwenden. Details zur Signatur und Code für Node.js, Python und andere Sprachen findest du unter Server-zu-Server-Tracking.

Der Endpunkt setzt den Plan Starter oder höher voraus (14-tägige Testphasen werden akzeptiert; niedrigere Stufen bekommen 402 plan_tier_required) sowie einen freigegebenen Affiliate (ein nicht freigegebener Affiliate führt zu 400 affiliate_not_active). Ein optionales Feld programId im Anfrageinhalt macht kontoweite Slugs eindeutig, die mehrere Kampagnen umfassen.

Anfrageinhalt:

{
  "affiliateSlug": "jane-recommends",
  "email": "user@example.com",
  "name": "Jane Doe",
  "externalEventId": "signup_abc123"
}

• affiliateSlug (Pflicht): der Affiliate, dem der Lead gutgeschrieben wird. Steht in der Tracking-URL des Affiliates. Groß- und Kleinschreibung spielt keine Rolle, SERKAN und serkan landen also beim selben Affiliate.
• email (Pflicht): die E-Mail-Adresse des Kunden. Mit ihr wird ein späterer Verkauf abgeglichen.
• name (optional): der Anzeigename des Kunden.
• externalEventId (optional): deine eindeutige ID für diese Anmeldung. Dient der Deduplizierung, Wiederholungen sind also sicher. Lass sie weg, solange du keinen eigenen Schlüssel für Wiederholungen brauchst: Ohne sie fallen doppelte Anmeldungen für denselben Affiliate und dieselbe E-Mail-Adresse über Browser, Server und Webhook hinweg zu einem Lead zusammen. Gibst du eine eigene ID mit, hängt der Lead stattdessen an dieser ID, und dieselbe Person kann zu zwei Lead-Zeilen werden, wenn sie einmal über den Browser und einmal per Backend-Aufruf mit eigener ID erfasst wird.

Nutze den S2S-Weg, wenn die Anmeldung auf deinem Server entsteht, du dort ein Secret sicher aufbewahren kannst und dein Workspace keine native Verbindung zu einem Zahlungsanbieter hat. Solange Stripe (über die Rekomi-App für Stripe), Paddle, Braintree, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Creem, Dodo Payments, Mollie oder die Shopify-App verbunden ist, gibt dieser Endpunkt 409 mit dem passenden Fehler *_connect_active zurück (eine Conversion-Quelle pro Workspace); erfasse Leads dort stattdessen mit Rekomi.convert(). Für Zahlungsanbieter, die du komplett über S2S anbindest, ist er der richtige Weg.

Über MCP

Für Abläufe mit KI-Assistenten und Automatisierungen stellt der MCP-Server das Tool record_lead bereit. Eingaben: affiliateSlug, email, optional name und optional campaignId. Es erfasst einen Anmelde-Lead genauso wie der Browser- und der S2S-Weg.

So funktioniert die Attribution

Der Abgleich über die E-Mail-Adresse ist nur ein Fallback. Er überschreibt nie eine Zuordnung, die Rekomi schon hat. Die Zuordnung geht der Reihe nach durch:

1. Override über einen Gutscheincode
2. Metadaten des Zahlungsanbieters (z. B. die Stripe-rekomi_affiliate_id) oder eine andere Empfehlung, die an der Zahlung mitgegeben wird
3. Frühere Conversion über die Kundenhistorie
4. Gutschein
5. Ein Abgleich der E-Mail-Adresse mit einem erfassten Lead (diese Seite)
6. Die Abfrage bei der Plattform, bei Verbindungen zu beehiiv, Kit, MailerLite, Ontraport und GoHighLevel mit aktivem Verkäufe gutschreiben (der Abschnitt unten)

Erst wenn alle Schritte 1 bis 4 nichts finden, gleicht Rekomi die E-Mail-Adresse des Verkaufs mit einem erfassten Lead ab, und erst wenn auch das nichts findet, fragt Rekomi die Plattform. Schritt 5 läuft gleich bei jedem Zahlungsanbieter, von dem Rekomi Verkäufe über dessen API bekommt (Stripe, Paddle, Braintree, Chargebee, Polar, Recurly, Creem, Dodo Payments, Lemon Squeezy, Gumroad und Mollie), und bei den Verbindungen zu beehiiv, Kit, MailerLite, Ontraport und GoHighLevel. Für den Lead-Abgleich gilt:

• Eine mitgegebene Empfehlung geht vor. Eine Empfehlung, die die Zahlung schon trägt, gewinnt immer. Der Abgleich über die E-Mail-Adresse springt nur ein, wenn der Verkauf ohne Empfehlung ankommt.
• Auf deinen eigenen Workspace beschränkt. Ein Lead aus einem Workspace führt nie zu einer Gutschrift für einen Verkauf in einem anderen.
• Höchstens 90 Tage alt. Ein Verkauf wird nur mit einem Lead abgeglichen, der in den letzten 90 Tagen erfasst wurde; der neueste passende Lead gewinnt.
• Nicht für Käufe des Affiliates selbst. Ist die E-Mail-Adresse des Käufers die des Affiliates, auf den der Lead verweist, wird der Abgleich übersprungen und der Verkauf nicht gutgeschrieben. Zwei Wege behalten ihr bisheriges Verhalten bei und schreiben diesen Verkauf gut: Stripe und Verkäufe, die über die Plattformverbindungen erfasst werden (Käufe über Kit Commerce, Transaktionen in Ontraport und Bestellungen in GoHighLevel).
• Aus dem Mollie-Kunden gelesen, wenn die Zahlung keine E-Mail-Adresse hat. Eine Mollie-Zahlung ohne billingAddress.email wird stattdessen über die E-Mail-Adresse im zugehörigen Mollie-Kundendatensatz abgeglichen, sofern die Zahlung zu einem Mollie-Kunden gehört. Zum Lesen braucht es die Berechtigung customers.read, eine der sieben, die die Mollie-Verbindung anfragt. Ein Token, das erstellt wurde, bevor customers.read dazukam, hat sie nicht. Eine Marke, die früher verbunden hat, verbindet sich deshalb mit einem frischen Token mit allen sieben Berechtigungen neu und übergibt bis dahin billingAddress.email an den Zahlungen, die sie selbst erstellt.

Weil der Abgleich nach jedem nativen Schritt des Zahlungsanbieters läuft, bleibt jede bestehende Zuordnung unverändert, und Verkäufe werden nie falsch gutgeschrieben. Auf dem automatischen Weg über den Zahlungsanbieter (Stripe, Paddle, Chargebee, Recurly, Creem) wird die spätere bezahlte Abbuchung bereits über die Kundenhistorie zugeordnet (Schritt 3 findet die Lead-Zeile über die Kunden-ID), für denselben Kunden ist der Abgleich über die E-Mail-Adresse also gar nicht nötig. Marken, die keine Leads nutzen, merken keinen Unterschied.

Leads und Verkäufe aus deiner Plattform

Bei beehiiv, Kit, MailerLite, Ontraport und GoHighLevel erledigt die CRM-Verbindung unter Integrationen zwei Aufgaben, jede mit eigenem Schalter: Affiliates in die Plattform synchronisieren und Verkäufe über die Plattform gutschreiben. Ist der zweite Schalter an (standardmäßig ist er das), gilt:

• Jeder Affiliate-Link, den Rekomi ausgibt, trägt utm_source=rekomi und utm_campaign mit dem Link-Slug des Affiliates, zum Beispiel https://newsletter.example.com?via=jane&utm_source=rekomi&utm_campaign=jane. Die Plattform speichert diese Werte bei der Anmeldung an der Person: beehiiv, Kit, Ontraport und GoHighLevel von Haus aus, MailerLite in einem eigenen Feld namens Rekomi affiliate tag, das der Rekomi-Loader aus dem Link befüllt.
• Kommt ein Verkauf bei Rekomi an, ohne dass die Schritte 1 bis 5 oben einen Affiliate liefern, sucht Rekomi den Käufer über die E-Mail-Adresse auf der Plattform, liest das gespeicherte Tag und schreibt dem Affiliate den Verkauf gut. Das ist der letzte Schritt der Zuordnung, er läuft innerhalb eines Zeitbudgets von drei Sekunden und kann den Verkauf selbst nie verzögern oder scheitern lassen. Ist die Plattform langsam oder hat sie die Person noch nicht angelegt, versucht Rekomi es in den nächsten zwei Stunden noch ein paar Mal und schreibt den Verkauf höchstens einmal gut.
• Wo die Plattform sie senden kann, kommen markierte Anmeldungen auch als Leads bei Rekomi an: von beehiiv (ab dem Plan Scale), Kit, MailerLite und Ontraport über Webhooks, die Rekomi beim Verbinden registriert, von GoHighLevel über einen Workflow-Webhook, den du hinzufügst. Diese Leads fallen mit einem Lead aus dem Loader oder dem S2S-Endpunkt in dieselbe Zeile zusammen, nichts wird doppelt gezählt.
• Ein Lead, den du selbst erfasst hast, gewinnt weiterhin: Schritt 5 läuft vor der Abfrage bei der Plattform.

Woher der Verkauf selbst kommt, hängt von der Plattform ab. Verkäufe aus beehiiv und MailerLite kommen über das Stripe-Konto, das du unter Einrichtung verbindest (bei beehiiv das Konto, das beehiiv für bezahlte Abonnements angelegt hat). Verkäufe aus Kit Commerce kommen über einen Kauf-Feed, den Rekomi bei Kit registriert. Verkäufe aus Ontraport kommen über die Ontraport-Verbindung selbst. Wiederkehrende Produkte in GoHighLevel kommen über dein verbundenes Stripe, Bestellformulare für Einmalkäufe oder Zahlungsanbieter außer Stripe über einen Workflow-Webhook.

Flodesk hat keinen Ort, an dem das Tag gespeichert werden kann, deshalb hat diese Verbindung keinen Schalter „Verkäufe gutschreiben“; nutze dort den Loader und einen verbundenen Zahlungsanbieter. Voraussetzungen, Statuszeile, das Feld E-Mail-Adresse eines Abonnenten prüfen und die Grenzen (die wichtigste: beehiiv und Kit speichern die Herkunft nur einmal, der Kauf eines Abonnenten, der sich schon vor dem Klick angemeldet hatte, wird über die Abfrage also keinem Affiliate gutgeschrieben) stehen auf der Seite der jeweiligen Plattform: beehiiv, Kit, MailerLite, Ontraport, GoHighLevel.

Wo Leads auftauchen

Sobald Leads einlaufen, zeigt das Dashboard einen Trichter Besucher → Lead → Verkauf und die Zahl der Leads neben Klicks und Conversions, im Tab Performance der Kampagne, im Abschnitt Leads und unter Berichte. Die Trichterstufe erscheint nur bei Bedarf: Marken, die nie einen Lead erfassen, sehen keine leere Lead-Zeile.