Tracking-Skript und window.Rekomi

Das Tracking-Skript von Rekomi (loader.js) erledigt zwei Dinge:

1. Es erfasst den Klick: Es liest den Attributionsparameter des Affiliates aus der URL (?via=, ?ref=, ?fpr= usw.), legt ihn im localStorage auf deiner Domain ab (dazu ein Cookie auf dem Tracking-Host, das zum First-Party-Cookie wird, sobald du eine eigene Tracking-Domain nutzt) und zeichnet den Klick auf.
2. Es stellt window.Rekomi bereit, ein kleines JavaScript-Objekt, mit dem deine Website beim Laden der Seite den Empfehlungskontext (Referral Context) auslesen kann: den Namen des Affiliates und den Namen der Kampagne, nicht nur einen Slug. Damit zeigst du zum Beispiel „Empfohlen von …“ an oder erfasst den vermittelnden Affiliate in Echtzeit in deinem Registrierungsformular.

Installieren

Füge das auf jeder Seite deiner Website in den <head> ein:

<script async
  src="https://api.rekomi.com/api/v1/r/loader.js"
  data-program-id="{your_program_id}"
  data-rkmi-email-capture="auto"></script>
<noscript><img src="https://api.rekomi.com/api/v1/r/c.gif" alt="" width="1" height="1" referrerpolicy="no-referrer-when-downgrade" /></noscript>

Rekomi erfasst eine E-Mail-Adresse, die ein vermittelter Besucher auf den Seiten, auf denen das Tag läuft, in ein beliebiges E-Mail- oder Textfeld tippt (Registrierung, Login, Checkout und andere Formulare), damit der Verkauf auch dann gutgeschrieben werden kann, wenn dein Checkout keine Empfehlung übergibt. Ohne Empfehlung wird nichts erfasst. Entferne das Attribut data-rkmi-email-capture, um das auszuschalten; explizite Aufrufe von Rekomi.convert() funktionieren weiterhin.

Das <noscript>-Beacon zeichnet den Klick bei Besuchern auf, die JavaScript deaktiviert haben. Es nimmt keine Query-Parameter an; das Beacon liest die Empfehlung aus den Attributionsparametern in der URL der verweisenden Seite (dem Referer-Header). Kopiere das exakte Snippet (mit deiner echten data-program-id und allen eigenen Attributionsparametern) unter Dashboard → Einstellungen → Tracking → Website-Snippet. Hast du eine bestätigte eigene Domain, lädt das Snippet von deiner eigenen Subdomain statt von api.rekomi.com.

Das Objekt window.Rekomi

Sobald das Skript geladen ist, definiert es window.Rekomi. Der Slug steht sofort bereit; die Objekte affiliate und campaign werden über eine einzige, schlanke asynchrone Abfrage befüllt, lies sie also innerhalb von ready() aus.

Eigenschaften

Methoden

affiliate.name kann null sein, wenn der Affiliate keinen Anzeigenamen festgelegt hat.

Du kannst den Loader die E-Mail-Adresse auch automatisch aus einem Formular erfassen lassen: Ergänze dein E-Mail-Feld um data-rekomi-email oder setze am Script-Tag ein Attribut data-email-selector, das auf dein Feld zeigt. Der Loader liest dann diesen Wert, wenn er den Lead sendet.

Das Tag, das Rekomi ausgibt, trägt data-rkmi-email-capture="auto" (oder capture=auto in der Skript-URL). In diesem Modus erfasst der Loader den Lead in dem Moment, in dem ein vermittelter Besucher eine E-Mail-Adresse fertig in ein beliebiges E-Mail- oder Textfeld getippt hat (bei Änderung oder beim Verlassen des Felds). Außerdem durchsucht er die Felder jedes abgeschickten Formulars. Damit sind auch ein Checkout direkt auf der Seite und ein Login-Schritt abgedeckt, die nie ein Formular abschicken (beehiiv ist der typische Fall). Ohne Empfehlung erfasst er weiterhin nichts, und er sendet dieselbe E-Mail-Adresse nie zweimal in einer Sitzung. Entferne das Attribut, um das auszuschalten: Ohne das Attribut fällt der Loader auf capture zurück, das nur beim Absenden eines Formulars das Feld ausliest, das data-email-selector oder data-rekomi-email benennt. So verhält sich auch eine Website, die noch ein älteres Tag installiert hat. Bei beehiiv, Kit, MailerLite, Ontraport und GoHighLevel schreibt die Plattformverbindung unter Integrationen dem Affiliate Verkäufe ohne dieses Skript gut, und zwar über den Anmeldedatensatz der Plattform selbst; der Erfassungsmodus deckt dann nur Leser ab, die schon vor ihrem Klick abonniert hatten. Siehe Leads und Verkäufe aus deiner Plattform.

Einstellungen. Jede Einstellung gibt es als URL-Variante und als Attribut. Nutze die URL-Variante immer dann, wenn ein Tag-Manager das Skript einfügt: Google Tag Manager baut das Tag neu und lässt dabei jedes data--Attribut weg, ein Tag nur mit Attributen lädt Rekomi dann ohne Programm-ID und ohne Erfassungsmodus.

Affiliate und Kampagne beim Laden erfassen

So erfasst du am besten, wer eine Anmeldung vermittelt hat: im Browser, in dem Moment, in dem die Seite lädt, ganz ohne Backend-Integration:

<script>
  window.Rekomi.ready(function (R) {
    if (!R.referral) return; // visitor was not referred

    // R.referral  -> "b7pa99hvx7zx"
    // R.affiliate -> { id: "...", name: "Milo Okha" }                (or null)
    // R.campaign  -> { id: "...", name: "Viraly Affiliate Program" } (or null)

    myApp.setReferral({
      referral:      R.referral,
      affiliateName: R.affiliate ? R.affiliate.name : null,
      campaignName:  R.campaign  ? R.campaign.name  : null
    });
  });
</script>

Schicke diese Felder dann bei der Registrierung an dein Backend. Weil ready() auf die Abfrage wartet, sind affiliate.name und campaign.name befüllt, auch wenn du sie direkt nach dem Laden der Seite ausliest.

Alternative auf dem Server

Willst du einen Slug lieber in deinem Backend auflösen, bekommst du dieselben Daten von einem öffentlichen Endpunkt:

GET https://api.rekomi.com/api/v1/r/resolve?via=SLUG[&program=PROGRAM_ID]

{
  "referral": "b7pa99hvx7zx",
  "affiliate": { "id": "6be0bba5-…", "name": "Milo Okha" },
  "campaign":  { "id": "cd1a591e-…", "name": "Viraly Affiliate Program" }
}

Liefert 404 für einen unbekannten oder gesperrten Slug. Der optionale Parameter program ist deine data-program-id; gib ihn mit, damit kontoweite Slugs zur richtigen Kampagne aufgelöst werden.

Was sichtbar ist (und was nicht)

Im Browser sichtbar sind der Anzeigename des Affiliates und der Name der Kampagne, also dieselben Angaben wie auf deinen öffentlichen Anmelde- und Rekrutierungsseiten. Nicht sichtbar sind die E-Mail-Adresse des Affiliates und alle anderen personenbezogenen Daten (PII). Die holst du auf dem Server über die authentifizierte REST-API (der Conversion-Feed liefert zum Beispiel affiliateEmail und stripeCustomerId).

Single-Page-Apps

window.Rekomi bleibt über Routenwechsel im Browser hinweg bestehen und wird deshalb nur einmal beim ersten Laden der Seite initialisiert. Wird dein Registrierungsformular erst nach einem Routenwechsel eingebunden, registriere einen ready()-Callback, wenn diese Komponente eingebunden wird (oder speichere die Werte beim ersten Laden im App-State), statt dich darauf zu verlassen, dass das Skript erneut läuft.

Conversion-Tracking

Dieses Skript kümmert sich nur um die Klick-Attribution und den Empfehlungskontext. Verkäufe erfasst dein Zahlungsanbieter automatisch (Stripe, Paddle, Braintree, Shopify, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Creem, Dodo Payments, Mollie), oder du meldest sie über die S2S-API. Leads (kostenlose Anmeldungen, die vor einer Zahlung erfasst werden) werden bei Stripe, Paddle, Chargebee, Recurly und Creem automatisch und ohne zusätzlichen Code erfasst; bei Polar erfasst ein zugeordneter Start einer Testphase ebenfalls automatisch einen $0-Lead. Nutze Rekomi.convert() für Anmeldungen in Freemium- oder kostenlosen Plänen, die nie ein Abrechnungsobjekt anlegen, für die übrigen Zahlungsanbieter (Braintree, Shopify, Lemon Squeezy, Gumroad, Dodo Payments, Mollie) und für Polar-Anmeldungen ohne Testphase. Es erfasst eine kostenlose Anmeldung als Lead, damit ein späteres Upgrade dem Affiliate auch dann gutgeschrieben wird, wenn das Klick-Cookie weg ist. Übergib bei Mollie außerdem dieselbe E-Mail-Adresse als billingAddress.email an der Zahlung, weil im gehosteten Checkout von Mollie kein Skript läuft und der Verkauf über den Webhook gutgeschrieben wird. Siehe Leads und Anmeldungen tracken. Bei beehiiv, Kit, MailerLite, Ontraport und GoHighLevel ist das Skript für die Attribution optional: Die Plattformverbindung schreibt dem Affiliate Verkäufe über den Anmeldedatensatz der Plattform selbst gut, und das Skript ergänzt die Klickzahlen.