Auf Memberstack installieren

Memberstack ist eine Ebene für Authentifizierung und geschützte Inhalte, kein Host. Es liegt über einer Host-Plattform, die du steuerst: Webflow, Duda, eigenes HTML oder ein anderer Website-Baukasten. Rekomi wird im Head des Hosts installiert, nicht in Memberstack selbst, weil der Platz für Head-Skripte zum Host gehört. Memberstack rechnet über dein eigenes Stripe-Konto ab, deshalb wird der Verkauf über Stripe (oder Gutscheincodes) erfasst, nicht über ein Snippet auf der Seite.

Das Head-Skript auf dem Host installieren

Öffne den websiteweiten Head-Code deiner Host-Plattform und füge das Rekomi-Skript ein.

Webflow: Site settings > Custom code > Head code.

Eigenes HTML / statische Website: Füge es in den <head> der gemeinsamen Vorlage ein, vor allen anderen Skripten, die den Mitgliederkontext brauchen.

Duda: Site Overview > Site Settings > Header HTML.

<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>

Deine Programm-ID ist im Snippet in Rekomi unter Einrichtung > Installieren (Memberstack wählen) schon eingesetzt. Dieses Skript erfasst den Affiliate-Klick bei jedem Seitenaufruf auf der Host-Domain. Das Attribut data-rkmi-email-capture="auto" erfasst außerdem einen Lead, sobald ein Besucher auf einer beliebigen Host-Seite eine E-Mail-Adresse fertig eingetippt hat. Über diesen Lead lässt sich ein Stripe-Verkauf dem Affiliate zuordnen (siehe Conversions erfassen unten).

Conversions erfassen

Memberstack wickelt Abonnements über dein eigenes Stripe-Konto ab, deshalb brauchst du kein Snippet auf einer Danke-Seite. Wähle einen dieser Wege:

Stripe Connect (empfohlen). Verbinde Stripe einmal in Rekomi unter Einrichtung > Zahlungsanbieter verbinden. Upgradet ein Mitglied, erfasst Rekomi den Verkauf automatisch und macht Provisionen bei Erstattungen rückgängig. Das Erfassen passiert automatisch, die Gutschrift für einen Neukunden nicht. Ein Stripe-Verkauf wird zugeordnet über einen eingelösten Rekomi-Gutschein, über die Abo-Metadaten rekomi_affiliate_slug oder rekomi_affiliate_id oder über den Abgleich der Checkout-E-Mail mit einem Lead aus den letzten 90 Tagen. Den Klick, den das Head-Skript erfasst hat, liest die Stripe-Anbindung serverseitig nie, er kann den Verkauf also nicht allein gutschreiben. Erstellt dein Ablauf die Checkout Session selbst, schreib window.Rekomi.getReferral() als rekomi_affiliate_slug in die metadata des Abonnements. Wenn nicht, erfasse einen Lead bei der Anmeldung mit window.Rekomi.convert({ email }), damit der Verkauf über die E-Mail-Adresse zugeordnet wird. Willst du keins von beidem programmieren, erfasst das Attribut data-rkmi-email-capture="auto" am Head-Skript den Lead für dich. Es greift, sobald ein Besucher eine E-Mail-Adresse fertig in ein E-Mail- oder Textfeld auf einer Host-Seite mit dem Skript eingetippt hat. Das deckt Formulare zur Anmeldung und zum Login ab, die Memberstack ohne Neuladen der Seite direkt verarbeitet, und erfasst auch jedes Formular, das tatsächlich abgeschickt wird. Ohne Empfehlung erfasst es nichts, dieselbe E-Mail-Adresse sendet es pro Sitzung nie zweimal, und Varianten mit Plus-Adressierung (you+test@gmail.com und you@gmail.com) behandelt es als dasselbe Postfach. Hast du nach einer früheren Version dieser Seite ein separates Snippet zur Lead-Erfassung eingefügt, lösche es.

Gutscheincodes (ohne Programmierung). Erstelle Gutscheincodes pro Affiliate unter Kampagne > Gutscheincodes und gib sie deinen Affiliates. Gutscheine funktionieren mit Memberstack, weil sein Checkout Stripe Checkout auf deinem eigenen Stripe-Konto ist; der Code wird also als echter Stripe-Promotion-Code eingelöst. Dasselbe Stripe-Konto muss mit Rekomi verbunden sein. Ein im Checkout eingelöster Code schreibt den Verkauf dem Affiliate gut. Auf keiner Seite musst du etwas hinzufügen.

Server-to-Server (am robustesten). Leite den Webhook member.created (bezahlt) von Memberstack oder deinen Stripe-Webhook mit HMAC von deinem Backend an den S2S-Tracking-Endpunkt von Rekomi weiter. Dieser Weg überträgt den echten Bestellbetrag, ohne vom Browser abzuhängen. S2S und eine aktive Stripe-Verbindung schließen sich gegenseitig aus: Der Endpunkt antwortet mit 409, solange Stripe verbunden ist, entscheide dich also für einen Weg.

Gut zu wissen

Memberstack läuft auf einer Host-Plattform. Das Rekomi-Skript kommt immer in den Head des Hosts, nie in das Admin-Panel von Memberstack. Eine Option „Rekomi in Memberstack installieren“ gibt es nicht; Memberstack ist die Authentifizierungsebene, nicht der Renderer der Seiten.

Der Verkauf wird außerhalb der Seite erfasst. Weil Conversions über Stripe (oder ein serverseitiges Relay) laufen, schreibst du nie Planpreise fest in ein Snippet und musst beim Auslesen der Mitgliederdaten kein Wettrennen mit der Client-Sitzung von Memberstack gewinnen. Der echte Betrag kommt von Stripe.

Attribution über Links braucht einen Metadaten-Eintrag oder einen Lead. Das Head-Skript erfasst den Klick nur im Browser; die Stripe-Anbindung liest ihn serverseitig nie. Damit Affiliate-Links Verkäufe gutschreiben, schreib entweder window.Rekomi.getReferral() in die Abo-Metadaten, wenn dein Ablauf den Checkout erstellt, oder erfasse einen Lead bei der Anmeldung, damit der Verkauf über die E-Mail-Adresse zugeordnet wird. Das Attribut data-rkmi-email-capture="auto" am Head-Skript ist der Weg ohne Programmierung zu diesem Lead: Es erfasst die E-Mail-Adresse, sobald das Mitglied sie auf einer Host-Seite fertig eingetippt hat. Gutscheincodes ordnen ganz ohne all das zu.

Mitgliederbereiche im SPA-Stil. Werden deine Seiten für Mitglieder direkt an Ort und Stelle gerendert (ohne vollständige Navigation zwischen den Seiten), gilt die erfasste Empfehlung trotzdem, weil sie beim ersten Besuch einer beliebigen Host-Seite gesetzt wurde.

Erstattungen und Abo-Änderungen

Memberstack wickelt die Abrechnung im Hintergrund über Stripe ab. Läuft dein Memberstack-Konto über Stripe Connect mit Webhooks, auf die Rekomi hört, werden Provisionen bei Erstattungen automatisch über die Stripe-Webhooks zurückgeholt. Erfasst du Verkäufe stattdessen über das Server-to-Server-Relay, leite das Erstattungsereignis vom selben Backend an /api/tracking/refund weiter.

Fehlerbehebung

Der Verkauf ist abgeschlossen, aber in Rekomi kommt keine Conversion an. Ein Stripe-Kauf, der Rekomi ohne Gutschein, ohne Metadaten-Eintrag und ohne passenden Lead erreicht, erscheint nicht als Verkauf. Ein leerer Tab Verkäufe auf der Seite Conversions kann deshalb zweierlei bedeuten. Nutzt du Stripe Connect, prüfe zuerst, ob Stripe unter Einrichtung > Zahlungsanbieter verbinden verbunden ist, und sieh dann auf der Seite Conversions in Rekomi nach, wo jede Conversion ihre Quelle zeigt. Stripe-Ereignisse erreichen Rekomi über den eigenen Webhook von Rekomi auf Plattformebene, deshalb erscheinen sie nicht in der Liste der Webhook-Zustellungen deines Stripe-Kontos. Ist Stripe verbunden und ein Testkauf erscheint trotzdem nicht, prüfe zwei Dinge. Erstens, ob das Head-Skript-Tag data-rkmi-email-capture="auto" enthält. Zweitens, ob das Mitglied seine E-Mail-Adresse nach dem Klick auf den Affiliate-Link auf einer Host-Seite mit dem Skript eingegeben hat. Ordnest du per Gutscheincode zu, prüfe, ob das Mitglied den Code des Affiliates im Checkout eingelöst hat.

Ein Affiliate erhält die Gutschrift für den falschen Verkauf. Die Codes zweier Affiliates haben sich überschnitten. Sorge dafür, dass jeder Affiliate unter Kampagne > Gutscheincodes einen eindeutigen Code hat.

Der Klick wird nie registriert. Der Besucher kam über einen Weg auf die Anmeldeseite, der an allen Seiten mit Head-Skript vorbeiführte, deshalb wurde keine Empfehlung erfasst. Prüfe, ob das Head-Skript auf jeder Einstiegsseite des Hosts installiert ist. Ob eine Empfehlung erfasst wurde, prüfst du in der Browser-Konsole mit window.Rekomi.getReferral().

Verwandte Seiten

• Checkout-Tracking ohne Code und ohne Stripe
• Überblick über Tracking und Attribution
• Memberstack-Dokumentation: Custom Code