Auf Teachable installieren

Die Installation auf Teachable besteht aus einem Schritt plus einer Entscheidung für die Conversions: Ein Head-Code-Snippet auf der Subdomain deiner School erfasst den Affiliate-Klick, und den Verkauf selbst erfasst deine Zahlungsplattform: dein eigenes Stripe-Konto (mit der automatischen E-Mail-Erfassung des Loaders für die Attribution) oder, bei Teachable:Pay, ein Server-to-Server-Relay. Ein entscheidendes Detail: Die Head-Snippets von Teachable laufen nicht auf sso.teachable.com und nicht im Checkout selbst. Affiliate-Links müssen deshalb über eine Marketing-Seite von Teachable führen (die Verkaufsseite des Kurses), bevor der Käufer zum Checkout kommt, und nicht direkt auf eine Checkout-URL.

Voraussetzungen

Du brauchst den Plan Builder von Teachable oder höher; kleinere Pläne bieten den Bereich Site > Code Snippets nicht, den du für die Head-Installation brauchst. Hast du einen Plan ohne diesen Bereich, erfasse Klicks und Leads auf einer Marketing-Website, die du selbst steuerst, und lass Affiliate-Links dorthin führen.

Das Head-Skript installieren

Schritt 1. Öffne im Teachable-Admin Site > Code Snippets und füge den Code im Bereich Head Code Snippets ein.

Schritt 2. Füge den Rekomi-Loader 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>

Speichere. Kopiere das Snippet mit deiner schon eingesetzten Programm-ID in Rekomi unter Einrichtung > Installieren.

Affiliate-Links über deine Marketing-Seiten führen

Die Head-Code-Snippets von Teachable laufen NICHT auf sso.teachable.com (der Subdomain für Login und Checkout). Schickt ein Affiliate einen Besucher direkt auf eine Checkout-URL von Teachable, läuft der Loader nie, der Klick wird nie erfasst, und die Attribution scheitert stillschweigend.

Lösung: Jeder Affiliate-Link zeigt auf eine Marketing-Seite von Teachable (die Verkaufsseite deines Kurses, die Startseite deiner School, eine eigene Landingpage), auf der der Loader läuft. Der Käufer klickt von dort zum Checkout weiter, und die Empfehlung reist in derselben Browser-Sitzung mit.

Im Affiliate-Dashboard von Rekomi führen die Standard-Tracking-URLs auf die Hauptdomain deiner School (zum Beispiel https://courses.yourbrand.com/?via=SLUG), nicht auf eine Checkout-URL. Affiliates kopieren diesen Link direkt. Ändere das Ziel nicht als „Abkürzung“ auf eine Checkout-URL, das macht die Attribution kaputt.

Die Conversion erfassen

Das Head-Skript oben erfasst den Affiliate-Klick und, mit dem Attribut, die E-Mail-Adresse des Käufers als Lead auf den Seiten der School-Domain. Ein Klick allein ordnet keinen Verkauf zu. Es gibt kein Snippet für eine Danke-Seite, das du einfügen müsstest: Der Aufruf convert() im Browser, mit dem ältere Einrichtungen Verkäufe erfasst haben, wurde entfernt, und heute erfasst convert() Leads, die Teil des funktionierenden Wegs unten sind. Wie der Verkauf erfasst wird, hängt von deiner Abrechnungsart ab.

Abrechnung über Stripe (dein eigenes Stripe-Konto). Betreibst du Teachable mit deinem eigenen Stripe-Konto (Settings > Payments), verbinde Stripe in Rekomi (Einrichtung > Zahlungsanbieter verbinden, unter /dashboard/setup/connect-sales), und Verkäufe, Erstattungen und Kündigungen werden automatisch erfasst. Ein Hinweis zum Umfang: Der Stripe-Weg erfasst Abo- und Rechnungsereignisse. Produkte, die als echte Stripe-Abonnements abgerechnet werden (Mitgliedschaften, Ratenzahlungen), kommen also immer an; ein Kurs, den Teachable als einfache einmalige Kartenzahlung abbucht, erzeugt keine Stripe-Rechnung und kommt womöglich nicht an. Gib für jeden Produkttyp eine Testbestellung auf und prüfe die Seite Conversions; was dort nicht erscheint, braucht das unten beschriebene S2S-Relay oder stattdessen eine Lead-Kampagne. Damit ein Erstkäufer dem Affiliate gutgeschrieben wird, braucht es noch einen Baustein. Der Checkout von Teachable kann keine Rekomi-Metadaten an die Stripe-Zahlung hängen, deshalb beruht die Attribution darauf, die E-Mail-Adresse aus dem Checkout mit einem Lead aus den letzten 90 Tagen abzugleichen. 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 in dem Moment, in dem ein vermittelter Besucher fertig ist, eine E-Mail-Adresse in ein beliebiges E-Mail- oder Textfeld auf einer Seite zu tippen, auf der der Loader läuft. Ohne Empfehlung erfasst es nichts, und dieselbe E-Mail-Adresse sendet es in einer Sitzung nie zweimal. Auf Teachable hilft das nur auf Seiten der School-Domain: Der Loader läuft nie auf sso.teachable.com oder im Checkout, was dort eingetippt wird, lässt sich also nicht erfassen. Sorge dafür, dass der Besucher vor dem Checkout irgendwo auf deiner School-Domain eine E-Mail-Adresse eingibt, zum Beispiel in ein Lead-Formular auf der Verkaufsseite oder auf einer Landingpage, die du selbst steuerst. Hast du aus einer früheren Version dieser Seite ein separates Snippet zur Lead-Erfassung eingefügt, lösch es. Entwickler können den Lead auch direkt mit window.Rekomi.convert({ email: "the-signup-email" }) von einer Seite erfassen, die du steuerst, oder einen Anmelde-Webhook aus deinem Backend an POST /api/tracking/lead weiterleiten. Siehe Leads und Anmeldungen tracken.

Teachable:Pay (Server-to-Server). Bei Teachable:Pay ist Teachable der Merchant of Record, es gibt also kein eigenes Stripe-Konto, das Rekomi auslesen könnte. Erfasse Verkäufe, indem du den Kauf-Webhook von Teachable abonnierst (Admin > Settings > Webhooks) und jeden Kauf aus deinem eigenen Backend an den Server-to-Server-Endpunkt von Rekomi weiterleitest. Die Felder der Payload und die Signatur stehen in der Anleitung zum Server-zu-Server-Tracking. Ordne jeden Verkauf über die Empfehlung zu, die du auf der Landingpage erfasst und mit der Bestellung weitergegeben hast; ohne sie kann das Relay keinem Affiliate gutschreiben. S2S und eine aktive Stripe-Verbindung schließen sich aus: Der Endpunkt antwortet mit 409, solange Stripe verbunden ist. Dieser Weg gilt also, wenn Stripe nicht verbunden ist.

Erstattungen hängen von deiner Abrechnungsart ab

Teachable kennt zwei Abrechnungsarten, und der Ablauf bei Erstattungen unterscheidet sich.

Teachable:Pay (Merchant of Record, nur USA). Teachable ist der Händler; Erstattungen lösen auf deinem Stripe KEIN charge.refunded aus (bei dieser Art hast du keins verbunden). Um Provisionen bei Erstattungen zurückzuholen, abonniere den Erstattungs-Webhook von Teachable (Admin > Settings > Webhooks) und leite Erstattungsereignisse mit der passenden externalEventId der ursprünglichen Conversion an den Endpunkt /api/tracking/refund von Rekomi weiter.

Abrechnung über Stripe Connect. Erstattungen lösen charge.refunded an den Stripe-Webhook-Empfänger von Rekomi aus, und die Rückforderung läuft automatisch. Ein Webhook-Relay auf Seiten von Teachable ist nicht nötig.

Welche Art du nutzt, siehst du im Teachable-Admin unter Settings > Payments. Teachable:Pay ist der Standard für Schools in den USA; Stripe Connect musst du ausdrücklich mit deinem eigenen Stripe-Konto einrichten.

Gut zu wissen

Head-Snippets laufen nicht auf der Checkout-Subdomain. Das ist mit Abstand der häufigste Installationsfehler. Lass Affiliate-Links immer auf eine Marketing-Seite der School-Domain führen, nicht auf eine Checkout-URL, damit der Klick (und der Lead) erfasst wird, bevor der Käufer zum Checkout kommt.

Eigene Domain oder *.teachable.com. Nutzt du eine eigene Domain (zum Beispiel courses.yourbrand.com), läuft der Loader dort wie erwartet. Lieferst du direkt über *.teachable.com aus, gilt dasselbe. Ausgenommen sind nur sso.teachable.com und die reine Checkout-Subdomain.

Gutscheine von Teachable sieht Rekomi nicht. Rekomi-Gutscheincodes ordnen nur zu, wenn sie als echte Stripe-Promotion-Codes in einem Checkout eingelöst werden, der über dein mit Rekomi verbundenes Stripe läuft. Die Rabattcodes von Teachable gehören zur Plattform selbst und erreichen Rekomi nie; einen passenden Code in Teachable anzulegen, bringt für die Attribution also nichts. Nutze stattdessen die automatische E-Mail-Erfassung des Loaders (eigenes Stripe) oder das S2S-Relay (Teachable:Pay).

Umgang mit Umsatzsteuer. Leitest du Verkäufe per Server-to-Server weiter, sende den Betrag, auf dem deine Provision beruht. Ist deine Provisionsgrundlage der Nettobetrag (ohne Umsatzsteuer bzw. Mehrwertsteuer), leite den Nettobetrag weiter; gibt es die Provision auf den Bruttobetrag, leite den Bruttobetrag weiter. Bleib bei jedem weitergeleiteten Verkauf einheitlich.

Fehlerbehebung

Nach einem Kauf auf Teachable wird keine Conversion erfasst. Prüfe zuerst: Führt der Affiliate-Link auf eine Marketing-Seite der School (keine direkte Checkout-URL), damit der Klick erfasst wird? Prüfe dann, ob dein Weg für Conversions eingerichtet ist: ob dein eigenes Stripe in Rekomi verbunden ist oder ob dein Kauf-Webhook von Teachable:Pay dein Relay erreicht. Mit eigenem Stripe erscheint ein Kauf, der Rekomi ohne passenden Lead erreicht, nicht als Verkauf. Prüfe deshalb auch zwei Dinge: ob das Loader-Tag data-rkmi-email-capture="auto" enthält und ob der Käufer seine E-Mail-Adresse auf einer Seite der School-Domain eingetippt hat, auf der der Loader läuft.

Falscher Betrag bei der Provision. Leitest du Verkäufe per Server-to-Server weiter, passt der gesendete Betrag nicht zu dem, worauf deine Provision beruhen sollte (wegen einer Rabattaktion, eines Promotion-Codes oder einer Planstufe). Sende den tatsächlich bezahlten Betrag aus der Payload des Kauf-Webhooks.

Erstattungen holen bei Teachable:Pay keine Provision zurück. Teachable:Pay leitet Erstattungen nicht über dein Stripe, der übliche Stripe-Webhook-Weg löst also nicht aus. Richte das Webhook-Relay von Teachable an /api/tracking/refund ein (siehe „Erstattungen hängen von deiner Abrechnungsart ab“ oben).

Der Klick ist erfasst, aber es kommt keine Provision an. Im Moment des Kaufs fehlte die Empfehlung. Wahrscheinlich ist der Besucher direkt auf eine Checkout-URL von Teachable gekommen (an deinen Marketing-Seiten vorbei), deshalb wurde kein Klick erfasst. Prüfe deine Linkführung und stelle sicher, dass jeder Affiliate-Link auf einer Seite beginnt, auf der der Loader läuft. Mit eigenem Stripe erscheint der Kauf erst als Verkauf, wenn es einen Lead mit der E-Mail-Adresse des Käufers gibt. Prüfe, ob das Loader-Tag data-rkmi-email-capture="auto" enthält und ob die E-Mail-Adresse auf einer Seite eingetippt wurde, auf der der Loader läuft, nicht auf sso.teachable.com.

Verwandte Seiten

• Server-zu-Server-Tracking
• Leads und Anmeldungen tracken
• Überblick über Tracking und Attribution
• Umgang mit Erstattungen