Auf Vanilla JavaScript installieren

Die einfachste Installation unter den Frameworks: Setz das Rekomi-Script-Tag in den <head> jeder öffentlichen Seite deiner Website, damit Affiliate-Klicks erfasst werden. Keine Framework-Abstraktionen, kein next/script, kein Bundler, nur reines HTML. Der Verkauf selbst wird außerhalb der Seite erfasst (über deinen Zahlungsanbieter, einen Server-to-Server-Aufruf oder einen Gutscheincode), auf der Danke-Seite musst du also nichts auslösen.

Nutzt deine Website ein gemeinsames Header-Partial (_includes/head.html bei Jekyll, layouts/partials/head.html bei Hugo, _includes/head.html bei Eleventy oder die Templates eines beliebigen Static Site Generators), installierst du das Skript einmal im Partial, und jede Seite übernimmt es. Besteht deine Website aus einer einzigen statischen HTML-Datei (oder einer Handvoll Seiten ohne Templates), füge es direkt in den <head> jeder Seite ein.

Das Head-Skript installieren

In deinem gemeinsamen <head>-Partial (oder im <head> jeder Seite, wenn es kein gemeinsames Partial gibt):

<!-- Rekomi tracking -->
<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" width="1" height="1" alt="" referrerpolicy="no-referrer-when-downgrade" />
</noscript>

Kopiere das Snippet mit schon eingesetzter Programm-ID aus dem Installationsrezept deiner Kampagne unter Einrichtung > Installieren im Dashboard.

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.

Durch das Attribut async lädt der Browser Rekomi parallel zum Rest der Seite. Auf Lighthouse hat das keinen messbaren Einfluss. Der <noscript>-Block löst für Besucher mit deaktiviertem JavaScript ein 1x1-Pixel aus, damit die einfache Klickerfassung trotzdem funktioniert.

Den Verkauf erfassen

Das Browser-Pixel erfasst keine Verkäufe mehr, deshalb brauchst du auf der Danke-Seite kein Convert-Snippet. Ein Verkauf wird über einen dieser Wege erfasst:

• Dein Zahlungsanbieter. Rechnest du über einen direkt angebundenen Zahlungsanbieter ab (Stripe, Paddle, Braintree, Shopify, Wix, BigCommerce, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Creem, Dodo Payments oder Mollie), verbinde ihn einmal im Schritt Zahlungsanbieter verbinden unter /dashboard/setup/connect-sales, und jeder Verkauf, jede Erstattung und jede Kündigung wird automatisch erfasst, ohne dass du ein Relay bauen musst.
• Server-to-Server. Hast du irgendein Backend (auch nur eine Serverless-Funktion), sende den Verkauf per POST mit HMAC-Signatur an den S2S-Endpunkt von Rekomi. Das ist der zuverlässigste Weg, weil er nicht vom Browser abhängt. Siehe Server-zu-Server-Tracking.
• Gutscheincodes. Kannst du überhaupt keinen serverseitigen Code ausführen, gib jedem Affiliate einen eigenen Rabattcode (Kampagne > Gutscheincodes). Ein eingelöster Code schreibt dem Affiliate den Verkauf im Checkout gut, ohne dass auf deiner Danke-Seite etwas passieren muss.

Gib die Affiliate-Empfehlung auf dem Weg mit, den du nutzt: window.Rekomi.getReferral() liefert den erfassten Slug, damit du ihn in die Abo-Metadaten einer Checkout Session schreiben (rekomi_affiliate_slug) oder für den S2S-Aufruf an dein Backend weiterleiten kannst.

Leads erfassen (optional)

window.Rekomi.convert() ist jetzt ein Aufruf zur LEAD-Erfassung, kein Verkauf. Nutze ihn auf einer Anmelde- oder Wartelistenseite, um eine Kunden-E-Mail-Adresse vor der Zahlung mit der Empfehlung zu verknüpfen. So wird ein späterer Verkauf auch dann gutgeschrieben, wenn der Klick nicht mehr da ist:

<script>
  window.Rekomi && window.Rekomi.ready(function () {
    window.Rekomi.convert("customer@example.com");
  });
</script>

Die Lead-Erfassung im Browser funktioniert in jedem Plan; der serverseitige Lead-Endpunkt erfordert Starter oder höher. Siehe Leads und Anmeldungen tracken.

So wird die Empfehlung gespeichert

Der Rekomi-Loader speichert den Affiliate-Slug bis zu 90 Tage lang im localStorage deiner Domain. Ob eine Conversion gutgeschrieben wird, entscheidet weiterhin das Attributionsfenster deiner Kampagne. window.Rekomi.getReferral() liest den Slug wieder aus. Ein Cookie _rkmi wird auf der Tracking-Domain von Rekomi gesetzt (Redirect-Links, Klick-Beacons), dein eigener Server kann den Slug also nicht aus einem Request-Cookie lesen. Nutze getReferral() im Browser, oder gib den Slug wie oben gezeigt durch deinen Checkout mit.

Löscht der Besucher zwischen Klick und Kauf die Website-Daten, lässt sich die Attribution trotzdem über einen erfassten Lead retten: Erfasst du die E-Mail-Adresse des Kunden vor dem Kauf als Lead (über window.Rekomi.convert(), die automatische Formularerfassung oder den S2S-Lead-Endpunkt), wird ein späterer Verkauf mit derselben E-Mail-Adresse diesem Affiliate gutgeschrieben. Ohne Lead nutzt du Gutscheincodes oder gibst die Empfehlung in den Checkout mit.

Gut zu wissen

Ohne gemeinsames Partial braucht jede Seite das Skript. Fügst du es nur auf einer Seite ein, werden Klicks auf anderen Seiten nicht erfasst. Der häufigste Fehler ist eine vergessene Seite (die Preisseite oder eine Landingpage für eine bestimmte Aktion). Geh deine Einstiegsseiten durch.

Async blockiert nicht. Durch das Attribut async wartet der Browser nicht, bis Rekomi geladen ist, bevor er den Rest der Seite verarbeitet. Der Critical Rendering Path bleibt unberührt. Die Lighthouse-Werte ändern sich nicht.

<noscript>-Fallback für Besucher ohne JavaScript. Das 1x1-Pixel im <noscript> wird für den kleinen Teil der Besucher ausgelöst, die JavaScript deaktiviert haben, die Klickerfassung funktioniert also trotzdem über die Pixel-Anfrage.

Für die Attribution zählt dieselbe Domain. Installiere das Skript auf derselben Domain, auf die deine Affiliates den Traffic schicken. localStorage gilt pro Origin, eine Empfehlung, die auf www.example.com erfasst wurde, ist auf einer anderen Domain also nicht lesbar.

Wann du serverseitig erfassen solltest

Hat dein Stack irgendein Backend (auch nur eine Serverless-Funktion), ist die serverseitige Erfassung von Verkäufen über die S2S-API von Rekomi der zuverlässigste Weg. Tracking im Browser kann von uBlock Origin, Brave Shields, Pi-hole oder Firmen-Firewalls blockiert werden. Serverseitige Aufrufe umgehen all das.

Das HMAC-Muster findest du unter Server-zu-Server-Tracking. Arbeitest du mit einem Stack mit starkem Backend (Rails, Django usw.), decken die Framework-Seiten in diesem Abschnitt die S2S-Installation für jedes Framework ab.

Fehlerbehebung

window.Rekomi.getReferral() liefert null. Der Loader hat in diesem Browser keine Empfehlung erfasst: Entweder kam der Besucher nicht über einen Affiliate-Link, oder das Skript fehlt auf der Landingpage, die er zuerst aufgerufen hat. Prüfe in der Quelltextansicht jeder Einstiegsseite, ob das Script-Tag vorhanden ist.

Die Empfehlung wurde erfasst, aber der Verkauf nicht zugeordnet. Die Empfehlung ist nicht in deinem Checkout angekommen. Prüfe, ob du window.Rekomi.getReferral() in die Abo-Metadaten der Checkout Session schreibst (rekomi_affiliate_slug) oder an deinen S2S-Aufruf weiterleitest und ob dein Zahlungsanbieter im Schritt Zahlungsanbieter verbinden verbunden ist.

Der Verkauf wurde mit dem falschen Betrag erfasst. Bei S2S muss amountCents eine Ganzzahl in der kleinsten Währungseinheit sein. $49.00 = 4900. Der häufigste Fehler ist ein Dezimalwert oder ein Betrag, der schon in Cent vorliegt und trotzdem mit 100 multipliziert wird.

Verwandte Seiten

• Tracking-Skript und Referenz zu window.Rekomi
• Server-zu-Server-Tracking: das HMAC-Muster für jedes Backend
• Leads und Anmeldungen tracken