Rekomi Docs
Für MarkenTracking installieren
Brands

Auf Thinkific installieren

Füge den Rekomi-Loader in Thinkific unter Settings > Code & Analytics in den Site Footer Code ein, um Klicks und E-Mail-Adressen zu erfassen, und erfasse Verkäufe dann über dein eigenes Stripe-Konto oder bei Thinkific Payments über ein Server-to-Server-Relay.

Thinkific-Logo

Der Platz für eigenen Code ist bei Thinkific das Feld Site Footer Code unter Settings > Code & Analytics. Es läuft auf deinem Storefront und deinen Landingpages, also genau dort, wo Affiliate-Klicks ankommen. Laut der Dokumentation von Thinkific läuft es standardmäßig nicht im neueren Course Player und nicht im Performance Checkout, und das hat keinen Einfluss auf die Klickerfassung. Der Loader erfasst den Affiliate-Klick; den Verkauf selbst erfasst deine Zahlungsplattform: dein eigenes Stripe-Konto (mit der automatischen E-Mail-Erfassung des Loaders für die Attribution) oder bei Thinkific Payments ein Server-to-Server-Relay.

Das Tracking-Skript installieren

Schritt 1. Öffne im Thinkific-Admin Settings > Site & app settings > Code & analytics > Site Footer Code.

Bei manchen älteren Konten heißt der Pfad Settings > Site & SEO > Site Code. Thinkific benennt diesen Bereich gerade um; beide Pfade führen zum selben Feld.

Schritt 2. Füge den Rekomi-Loader in das Feld Site Footer Code 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>

Der asynchrone Loader läuft aus dem Footer genauso wie aus dem Head, die Klickerfassung funktioniert also identisch, und die Platzierung im Footer bremst die Seite nicht aus. Lass das Attribut data-rkmi-email-capture="auto" stehen; der Weg über Stripe weiter unten braucht es. Kopiere das Snippet mit schon eingesetzter Programm-ID in Rekomi unter Einrichtung > Installieren.

Die Conversion erfassen

Der Loader oben erfasst den Affiliate-Klick und mit dem Attribut auch die E-Mail-Adresse des Käufers als Lead. Ein Klick allein ordnet keinen Verkauf zu. Ein Snippet für die Bestellbestätigung gibt es nicht: Den Aufruf von convert() im Browser, mit dem ältere Setups Verkäufe erfasst haben, gibt es nicht mehr, und heute erfasst convert() Leads (die Alternative für Entwickler im Abschnitt zum Weg über Stripe unten). Wie der Verkauf erfasst wird, hängt von deiner Abrechnungsart ab.

Abrechnung über Stripe (dein eigenes Stripe-Konto). Wenn dein eigenes Stripe-Konto die Zahlungen abwickelt (Settings > Payments), verbinde Stripe in Rekomi (Einrichtung > Zahlungsanbieter verbinden, unter /dashboard/setup/connect-sales), und Verkäufe, Erstattungen und Kündigungen werden automatisch erfasst. Eine Einschränkung: Der Stripe-Weg erfasst Abo- und Rechnungsereignisse. Produkte, die als echte Stripe-Abonnements abgerechnet werden (Mitgliedschaften, Ratenzahlungen), kommen also immer an; ein Kurs, den Thinkific als einfache Einmalzahlung per Karte abbucht, erzeugt keine Stripe-Rechnung und kommt unter Umständen nicht an. Mach für jeden Produkttyp eine Testbestellung und prüfe die Seite Conversions. Was dort nicht erscheint, braucht das unten beschriebene S2S-Relay oder stattdessen eine Lead-basierte Kampagne. Um einem Erstkäufer den Verkauf gutzuschreiben, fehlt noch ein Baustein. Der Checkout von Thinkific kann keine Rekomi-Metadaten an die Stripe-Zahlung hängen, deshalb gleicht die Attribution die E-Mail-Adresse aus dem Checkout mit einem Lead aus den letzten 90 Tagen ab. Varianten mit Plus-Adressierung wie you+test@gmail.com und you@gmail.com zählen als dasselbe Postfach. Das Attribut data-rkmi-email-capture="auto" am Loader-Tag oben erfasst diesen Lead, sobald ein Käufer seine E-Mail-Adresse auf einer Seite mit dem Loader fertig eingetippt hat. Das deckt die Seiten zur Registrierung und zum Login von Thinkific ab und auch jeden Checkout auf der Seite, der nie ein Formular abschickt, solange das Footer-Feld dort läuft. Ohne Empfehlung erfasst es nichts, und dieselbe E-Mail-Adresse sendet es pro Sitzung nie zweimal. Hast du nach einer früheren Version dieser Seite ein separates Snippet zur Lead-Erfassung eingefügt, lösche es. Willst du den Lead stattdessen selbst erfassen, rufe auf einer Seite, die du steuerst, window.Rekomi.convert({ email: "the-signup-email" }) auf, oder leite einen Anmelde-Webhook aus deinem Backend an POST /api/tracking/lead weiter. Siehe Leads und Anmeldungen tracken.

Thinkific Payments (Server-to-Server). Bei Thinkific Payments ist Thinkific der Merchant of Record, es gibt also kein Stripe-Konto von dir, das Rekomi lesen könnte. Erfasse Verkäufe, indem du den Webhook order.created von Thinkific abonnierst (Webhooks legst du bei Thinkific meist über die Webhooks API an) und jede Bestellung aus deinem eigenen Backend an den Server-to-Server-Endpunkt von Rekomi weiterleitest. Die Felder der Payload und die Signatur findest du in der Anleitung zum Server-zu-Server-Tracking. Ordne jede Bestellung über die Empfehlung zu, die du auf der Landingpage erfasst und mit der Bestellung weitergegeben hast; ohne sie kann das Relay keinem Affiliate etwas gutschreiben. S2S und eine aktive Stripe-Verbindung schließen sich gegenseitig aus: Der Endpunkt antwortet mit 409, solange Stripe verbunden ist, dieser Weg gilt also nur, wenn Stripe nicht verbunden ist.

Der Umgang mit Erstattungen hängt von deiner Abrechnungsart ab

Thinkific kennt zwei Abrechnungsarten.

Thinkific Payments (Merchant of Record). Thinkific ist der Händler; Erstattungen lösen auf deinem Stripe KEIN charge.refunded aus (weil Thinkific der Verkäufer ist, nicht du). Damit Provisionen bei Erstattungen zurückgeholt werden, abonniere den Erstattungs-Webhook von Thinkific (er wird genauso angelegt wie der Bestell-Webhook) und leite Erstattungsereignisse an den Endpunkt /api/tracking/refund von Rekomi weiter, mit der passenden externalEventId aus der ursprünglichen Conversion.

Abrechnung über Stripe Connect. Dein eigenes Stripe wickelt die Zahlungen ab. Erstattungen lösen charge.refunded beim Stripe-Webhook-Empfänger von Rekomi aus, und die Provision wird automatisch zurückgeholt.

So prüfst du deine Abrechnungsart: Thinkific-Admin > Settings > Payments. Thinkific Payments ist bei neueren Konten der Standard; Stripe Connect musst du ausdrücklich einrichten.

Setups über mehrere Domains

Die erfasste Empfehlung bleibt im localStorage gespeichert, und zwar genau für den Origin, auf dem der Klick gelandet ist, dazu kommt ein Cookie auf dem Tracking-Host von Rekomi. Die Kopie im localStorage übersteht keinen Wechsel auf einen anderen Hostnamen. Liegen deine Marketing-Website und deine Thinkific-Schule also auf wirklich verschiedenen Domains (etwa das Marketing auf mybrand.com und die Schule auf mybrand-courses.com), ist ein Klick, der auf der Marketing-Website erfasst wurde, auf der Domain der Schule nicht lesbar.

Die verlässliche Lösung: Lass Affiliate-Links auf die Domain zeigen, auf der Registrierung und Checkout stattfinden, meist die Thinkific-Schule selbst. So wird die Empfehlung auf dem Origin erfasst, auf den es ankommt, und der Lead, der dort entsteht, trägt sie mit. Den Loader auf beiden Websites zu installieren lohnt sich trotzdem für die Abdeckung, aber eine Empfehlung, die nur auf dem Marketing-Origin erfasst wurde, folgt dem Käufer nicht über den Sprung hinweg.

Derselbe Rat gilt, wenn beide Websites unter einer registrierbaren Domain liegen (mybrand.com und courses.mybrand.com): Installiere den Loader auf jedem Origin und schick den Affiliate-Traffic auf den, auf dem der Käufer kauft.

Gut zu wissen

Das Footer-Feld läuft nicht im neuen Course Player und nicht im Performance Checkout. Laut der Dokumentation von Thinkific läuft der Site Footer Code dort standardmäßig nicht. Die Klickerfassung ist davon nicht betroffen: Affiliate-Klicks landen auf deinem Storefront und deinen Landingpages, wo das Feld läuft. Betroffen ist die E-Mail-Erfassung nur, wenn ein ganz neuer Käufer seine E-Mail-Adresse zum ersten Mal im Performance Checkout eintippt, wo der Loader sie nicht sehen kann. Käufer, die sich vorher auf einer normalen Seite der Website registrieren oder anmelden, werden normal erfasst; teste das mit einer Bestellung als Neukunde.

Gutscheine von Thinkific sieht Rekomi nicht. Gutscheincodes von Rekomi ordnen nur dann zu, wenn sie als echte Stripe-Promotion-Codes in einem Checkout eingelöst werden, der auf deinem mit Rekomi verbundenen Stripe läuft. Die Rabattcodes von Thinkific gehören zur Plattform selbst und erreichen Rekomi nie; einen passenden Code in Thinkific anzulegen, hilft der Attribution also nicht. Verlass dich stattdessen auf die E-Mail-Erfassung des Loaders (eigenes Stripe) oder das S2S-Relay (Thinkific Payments).

Kein Platz im <head>. Thinkific ist streng, was den Ort für eigenen Code angeht; das Feld Site Footer Code ist der einzige Platz für die ganze Website ohne Programmierung. Der asynchrone Loader von Rekomi funktioniert dort einwandfrei.

Umsatzsteuer bei weitergeleiteten Bestellungen. Leitest du Bestellungen aus Thinkific Payments per Server-to-Server weiter, sende den Betrag, auf dem deine Provision beruhen soll, und prüfe vor der Entscheidung in der Webhook-Payload, ob der Betrag, den du übernimmst, die Steuer enthält. Bleib bei allen weitergeleiteten Bestellungen einheitlich.

Fehlerbehebung

Der Klick wird nicht erfasst. Prüfe, ob der Loader im Feld Site Footer Code steht und ob der Affiliate-Link auf einem Storefront oder einer Landingpage landet, wo das Feld läuft. Der neuere Course Player und der Performance Checkout führen das Feld nicht aus, aber dort sollte ohnehin kein Affiliate-Traffic landen.

Nach einer Bestellung wird keine Conversion erfasst. Prüfe, ob dein Weg für Conversions eingerichtet ist: Dein eigenes Stripe ist in Rekomi verbunden, oder der Bestell-Webhook von Thinkific Payments erreicht dein Relay. Der Loader im Footer erfasst den Klick und die E-Mail-Adresse des Käufers; den Verkauf erfasst er nicht von allein.

Die Erstattung hat bei Thinkific Payments die Provision nicht zurückgeholt. Thinkific Payments leitet Erstattungen nicht über dein Stripe. Richte das Relay für den Thinkific-Webhook an /api/tracking/refund ein (siehe „Der Umgang mit Erstattungen“ oben).

Stripe ist verbunden, aber der Kauf erscheint nicht als Verkauf. Ein Kauf, der Rekomi ohne passenden Lead erreicht, wird übersprungen und erscheint deshalb nie auf der Seite Conversions. Prüfe zwei Dinge: Das Loader-Tag im Site Footer Code enthält data-rkmi-email-capture="auto", und der Käufer hat seine E-Mail-Adresse nach dem Affiliate-Klick auf einer Seite eingetippt, auf der das Footer-Feld läuft. Ein Käufer, der mit einer anderen E-Mail-Adresse bezahlt als der eingetippten, passt ebenfalls nicht. Bei Thinkific Payments kann eine Bestellung, die ohne die erfasste Empfehlung weitergeleitet wird, keinem Affiliate gutgeschrieben werden; gib die Empfehlung also mit jeder Bestellung weiter.