Auf beehiiv installieren

Auf beehiiv hängt die Attribution nicht von einem Skript im Browser des Lesers ab: Leser, die sich auf deiner Website eintragen, werden über den Datensatz von beehiiv gutgeschrieben, und Leser, die direkt zum bezahlten Checkout gehen, über den Checkout-Weg weiter unten. beehiiv selbst hält fest, wie jeder Abonnent zu dir gekommen ist, und jeder Affiliate-Link, den Rekomi ausgibt, trägt einen Tag, den beehiiv bei der Anmeldung speichert. Bezahlt ein Abonnent später eine Premium Subscription, liest Rekomi diesen Datensatz aus und schreibt den Verkauf dem Affiliate gut. Die ganze Installation besteht aus zwei Verbindungen in Rekomi, auf der Seite von beehiiv ist nichts zu tun. Ein Tag in Google Tag Manager (GTM) ist optional: Es liefert Klickzahlen und deckt den einen Fall ab, den der Datensatz nicht abdeckt (Leser, die schon vor dem Klick auf deiner Liste standen).

Schritt 1: Das Stripe-Konto verbinden, über das beehiiv abrechnet

beehiiv rechnet Premium Subscriptions über ein Standard-Stripe-Konto ab, das es unter deinem eigenen Stripe-Login anlegt, getrennt von allen anderen Stripe-Konten, die du betreibst. Dieses Konto meldet Rekomi den Verkauf, also ist es das Konto, das du verbindest.

1. Öffne in Rekomi Einrichtung > Zahlungsanbieter verbinden und klicke auf Stripe verbinden.
2. Wähle im Zustimmungsbildschirm von Stripe das Konto, das beehiiv für deine Publikation angelegt hat. Siehst du nach der Anmeldung bei Stripe mehrere Konten, ist es das Konto, dessen Zahlungen deine Newsletter-Abos sind.
3. Bestätige die Rekomi-App. Verkäufe und Erstattungen aus diesem Konto kommen jetzt bei Rekomi an.

Läuft dein beehiiv-Plan über ein verwaltetes Stripe-Konto, für das du das vollständige Stripe-Dashboard nicht öffnen kannst, lässt sich der Weg über Stripe nicht verbinden. Betreibe dann stattdessen ein Programm auf Lead-Basis (siehe Lead-Tracking).

Schritt 2: beehiiv unter Integrationen verbinden

1. Öffne in Rekomi Integrationen, klicke auf die beehiiv-Karte und füge deinen beehiiv-API-Schlüssel und deine Publication ID ein (beides findest du in beehiiv unter Settings → Integrations → API Keys).
2. Klicke auf Verbinden. Rekomi prüft den Schlüssel und testet, ob es Abonnenten nachschlagen kann.
3. Lass Verkäufe über beehiiv gutschreiben eingeschaltet. Der Schalter ist ab dem Verbinden an. Affiliates in beehiiv synchronisieren ist der zweite Schalter auf derselben Seite und trägt deine freigegebenen Affiliates in die Publikation ein; lass ihn an oder schalte ihn aus, ganz wie du willst.

Das ist die ganze Installation. Die beehiiv-CRM-Seite beschreibt den Schalter, die Statuszeile, die Anmeldebenachrichtigungen und die Grenzen im Detail.

Testen

1. Melde dich als einer deiner Affiliates an (oder nutze einen Test-Affiliate) und kopiere seinen Link. Er sieht etwa so aus: https://newsletter.example.com?via=jane&utm_source=rekomi&utm_campaign=jane. Die letzten beiden Parameter sind der Tag, den beehiiv speichert.
2. Öffne den Link in einem privaten Fenster und trag dich mit einer neuen E-Mail-Adresse ein.
3. Gib zurück auf der beehiiv-Integrationsseite in Rekomi diese Adresse unter E-Mail-Adresse eines Abonnenten prüfen ein. Dort sollte stehen, dass der Abonnent existiert, dass der Tag deinen Affiliate nennt und dass ein Verkauf von dieser E-Mail-Adresse gutgeschrieben würde.
4. Führe mit dieser Adresse ein Upgrade auf deiner beehiiv-Website durch. Der Kauf erscheint in der Ansicht Aktivität der Kampagne als gutgeschriebener Verkauf, mit beehiiv als Quelle.

So funktioniert die Attribution

1. Jeder Affiliate-Link, den Rekomi für deine Kampagne erzeugt, trägt zusätzlich zum üblichen Parameter ?via= auch utm_source=rekomi und utm_campaign mit dem Link-Slug des Affiliates.
2. Kommt ein Leser über diesen Link auf deine beehiiv-Website und trägt sich ein, speichert beehiiv diese Werte am Abonnenten. beehiiv schreibt sie einmal, bei der Anmeldung, und überschreibt sie nie.
3. Wechselt der Abonnent zu einer Premium Subscription, läuft die Zahlung über das verbundene Stripe-Konto, und Stripe sendet customer.subscription.created und invoice.paid an Rekomi, das den Verkauf erfasst. Einmalige digitale Produkte, die über dasselbe Konto verkauft werden, werden noch nicht erfasst; das kommt auf demselben Weg, sobald das Update der Rekomi-App für Stripe live ist.
4. Rekomi versucht es zuerst mit allem, was es schon über den Verkauf weiß (ein Gutschein, Checkout-Metadaten, der Verlauf des Kunden, ein selbst erfasster E-Mail-Lead). Erst wenn nichts davon einen Affiliate nennt, fragt es beehiiv per E-Mail-Adresse nach dem Abonnenten und schreibt dem Affiliate gut, den der gespeicherte Tag nennt. Ein Upgrade, das der Leser im eingeloggten Zustand startet, wird genauso gutgeschrieben, weil nichts eingetippt werden muss.
5. Verlängerungen werden über den Verlauf des Kunden weiter demselben Affiliate gutgeschrieben, und Erstattungen werden automatisch zurückgeholt (siehe unten).

Den einen Fall deckt das nicht ab: einen Leser, der schon auf deiner kostenlosen Liste stand, bevor er auf einen Affiliate-Link geklickt hat. beehiiv hat für ihn schon einen Herkunftsdatensatz und ersetzt ihn nicht. Das optionale GTM-Tag für Klickstatistiken weiter unten erfasst einen Lead, sobald ein solcher Leser nach dem Klick irgendwo auf deiner Website seine E-Mail-Adresse eintippt, und dieser Lead schreibt den Verkauf über den Abgleich der E-Mail-Adresse innerhalb von 90 Tagen gut.

Leser, die direkt zum bezahlten Checkout gehen: der Checkout-Weg

beehiiv schreibt den Affiliate-Tag nur, wenn ein Leser seine E-Mail-Adresse in ein Anmeldeformular auf deiner Website tippt. Ein Leser, der über einen Affiliate-Link auf deiner Upgrade-Seite landet, einen Plan wählt, seine E-Mail-Adresse in das Feld „Confirm your email“ von beehiiv eingibt und bei Stripe bezahlt, wird auf den Servern von beehiiv ohne Tag angelegt, und beehiiv überträgt den Besuch nicht auf diesen Abonnenten. Ist das Cookie-Banner an, lädt beehiiv Google Tag Manager außerdem erst beim nächsten Seitenaufruf nach dem Akzeptieren, also kann auch kein Skript diese erste Seite sehen. Der Checkout-Weg deckt genau diesen Leser ab, ohne dass auf beehiiv überhaupt etwas läuft.

Schalte ihn in den Einstellungen der Kampagne ein, im Tab Tracking unter „Verkäufe über einen Rekomi-Link nachverfolgen“. Zwei Dinge ändern sich:

1. Jeder Affiliate-Link wird zu https://rekomi.link/{code}?p={campaign}. Der Klick wird bei Rekomi erfasst, ein Cookie auf rekomi.link gesetzt, und der Leser wird mit dem Code des Affiliates und dem Tag direkt weiter auf deine Seite geschickt, genau wie vorher. Links auf eine bestimmte Seite funktionieren weiter: Der Link-Generator und die Produktlinks laufen über denselben Zwischenschritt.
2. Setze in beehiiv unter Settings, Paid subscriptions die Weiterleitung nach dem Kauf auf die URL, die dir die Einstellungsseite zeigt: https://rekomi.link/thanks?p={campaign}&session_id={CHECKOUT_SESSION_ID}. Lass die geschweiften Klammern genau so stehen; Stripe setzt die Session-ID ein, wenn es den Käufer zurückschickt. Diese Seite liest das Cookie und die Stripe-Session auf deinem verbundenen Konto, erfasst den Käufer, schreibt den Verkauf gut (egal, ob Stripe uns zuerst informiert hat oder der Browser des Käufers), zeigt ein kurzes Dankeschön und schickt den Käufer weiter auf deine Seite oder die Dankeseite, die du festgelegt hast.

Lässt beehiiv die geschweiften Klammern nicht speichern, stell den Linkmodus auf „Erst nach der E-Mail-Adresse fragen“. Leser sehen dann vor deiner Upgrade-Seite eine Rekomi-Seite mit einem einzigen Feld; Rekomi erfasst sie und schreibt den Affiliate-Tag über deine beehiiv-Verbindung in ihren Abonnenten-Datensatz bei beehiiv, sodass der Kauf über die Verbindung selbst gutgeschrieben wird. Der Leser tippt kurz darauf dieselbe E-Mail-Adresse in das Feld von beehiiv, und beehiiv verknüpft die Zahlung mit diesem Datensatz.

Ohne Session-ID und ohne den E-Mail-Schritt schreibt die Dankeseite einen Kauf trotzdem gut, wenn er der einzige nicht zugeordnete Verkauf auf deinem Konto in den letzten fünf Minuten ist und in diesem Zeitraum kein anderer Käufer zurückgekommen ist. Alles, was nicht eindeutig ist, bleibt ohne Gutschrift, statt geraten zu werden.

Verlängerungen werden über den Verlauf des Kunden gutgeschrieben, sobald die erste Zahlung gutgeschrieben ist. Erstattungen machen die Provision rückgängig, wie bei jedem anderen Weg.

Optional: Klickstatistiken mit Google Tag Manager

Für die Gutschrift von Verkäufen brauchst du das nicht. Füge es hinzu, wenn du Klickzahlen im Dashboard sehen willst oder Leser abdecken möchtest, die schon vor dem Klick abonniert hatten.

beehiiv bietet keinen Platz für <head>-HTML auf der ganzen Website (auf Website-Seiten gibt es HTML-Blöcke pro Seite, aber nichts, was alle Seiten auf einmal abdeckt, und Newsletter-Beiträge entfernen Skripte). Der unterstützte Weg, eigenes JS auf der ganzen beehiiv-Website zu laden, ist Google Tag Manager: beehiiv hat ein Feld für die GTM-Container-ID, und jedes Tag, das du in diesem Container veröffentlichst, läuft auf allen Seiten, die beehiiv ausliefert. Du brauchst ein Google-Tag-Manager-Konto; ein kostenloser Container unter tagmanager.google.com gibt dir eine ID im Format GTM-XXXXXXX.

Trag deine GTM-Container-ID in beehiiv ein. Gehe in beehiiv zu Website > Builder > Settings (Zahnrad-Symbol oben rechts) > All general settings > Pixels > Google Tag Manager. Füge deine Container-ID ein. Speichere.

Lege in GTM ein Custom-HTML-Tag an. Öffne deinen Container und gehe zu Tags > New > Tag Configuration > Custom HTML. Füge das Rekomi-Skript ein:

<script async src="https://api.rekomi.com/api/v1/r/loader.js?program=YOUR_PROGRAM_ID&capture=auto"></script>

Die Einstellungen stehen absichtlich in der URL. Google Tag Manager baut ein Script-Tag beim Einfügen neu auf und behält dabei nur die Adresse, alles, was als data--Attribut geschrieben ist (zum Beispiel data-program-id), fällt also stillschweigend weg. Programm-ID und capture=auto in der URL überstehen das. Kopiere das Snippet mit bereits eingesetzter Programm-ID in Rekomi unter Einrichtung > Installieren.

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 der Checkout keine Empfehlung übergibt. Ohne Empfehlung wird nichts erfasst. Entferne capture=auto aus der Adresse, um das auszuschalten; explizite Aufrufe von Rekomi.convert() funktionieren weiterhin.

Setze den Trigger auf All Pages und veröffentliche. Wähle unter Triggering die Option All Pages. Klicke dann auf Submit (oben rechts), benenne die Version und klicke auf Publish. beehiiv-Seiten laden Rekomi ab dem nächsten Seitenaufruf.

Dein Cookie-Banner steuert jedes Tag. Ist das Cookie-Banner von beehiiv eingeschaltet, lädt Google Tag Manager (und damit Rekomi, Meta, GA4 und jedes andere Pixel) erst, wenn der Leser auf Accept klickt, und auch dann erst ab dem nächsten Seitenaufruf. Leser, die ablehnen oder das Banner ignorieren, werden von nichts erfasst. Das betrifft nur dieses optionale Tag; Verkäufe werden unabhängig vom Banner über die Verbindung gutgeschrieben.

Wenn du aus einer früheren Version dieser Seite ein separates Custom-HTML-Tag für die „Lead-Erfassung“ installiert hast, lösche es; die Einstellung capture=auto ersetzt es.

beehiiv Boost, Premium Subscriptions und Referral Program im Vergleich

beehiiv hat drei Funktionen zum Geldverdienen, die leicht zu verwechseln sind. Rekomi erfasst eine davon; die anderen beiden sind eigene Produkte.

Premium Subscriptions (erfasst Rekomi). Bezahlte Newsletter-Abos, die über Stripe Connect von beehiiv laufen. Die Attribution funktioniert wie oben beschrieben.

beehiiv Boost (erfasst Rekomi NICHT). Boost ist das Werbenetzwerk von beehiiv, in dem ein Publisher einen anderen für Newsletter-Empfehlungen bezahlt. Ausgaben für Boost laufen mit beehiiv als Merchant of Record (beehiiv kassiert beim Käufer und zahlt nach Abzug seines Anteils an den Empfehlenden aus). Boost lässt sich bewusst nicht über Rekomi zuordnen; Affiliates können keine Provision auf Boost-Ausgaben verdienen.

Natives Referral Program (erfasst Rekomi NICHT; läuft parallel). beehiiv hat eine eingebaute Empfehlungsfunktion, bei der Leser Freunde werben und dafür Prämien bekommen (T-Shirts bei bestimmten Meilensteinen, Merch usw.). Das ist ein Werkzeug für das Wachstum kostenloser Newsletter, KEINE Umsatzbeteiligung für Affiliates. Es kommt Rekomi nicht in die Quere; beide können auf derselben Publikation laufen. Rekomi vergütet bezahlte Premium Subscriptions, das native Referral Program belohnt kostenlose Anmeldungen mit Merch.

Gut zu wissen

Nur Seiten, die beehiiv hostet, speichern den Tag. Ein beehiiv-Anmeldeformular, das auf einer anderen Website eingebettet ist, erfasst die Herkunft nur, wenn auf dieser Seite das Attributionsskript von beehiiv läuft. Schick den Traffic deiner Affiliates direkt auf deine beehiiv-Website.

Der Tag wird einmal geschrieben. beehiiv behält den ersten Herkunftsdatensatz und überschreibt ihn nie. Deshalb ist ein Leser, der sich vor dem Klick eingetragen hat, der eine Fall, den die Verbindung nicht gutschreiben kann.

Anmeldebenachrichtigungen brauchen beehiiv Scale oder höher. Ist der Schalter für das Gutschreiben von Verkäufen an, registriert Rekomi einen Webhook, damit markierte Anmeldungen schon vor einem Verkauf als Leads erscheinen. beehiiv bietet Webhooks ab Scale an; in anderen Plänen steht auf der Integrationsseite unter dem Verkaufsstatus eine Zeile dazu, und Verkäufe werden trotzdem gutgeschrieben.

Die GTM-Container-ID gilt pro Publikation, nicht pro Konto. Wenn du das optionale Tag nutzt und mehrere beehiiv-Publikationen betreibst, füge dieselbe GTM-Container-ID in die Einstellungen jeder Publikation ein.

Die GTM-Container-ID ist kein Rekomi-Schlüssel. Du stellst beehiiv so ein, dass es DEINEN Google-Tag-Manager-Container lädt; mit dem GTM-Container selbst hat Rekomi nichts zu tun.

Erstattungen

Wird die Zahlung für eine Premium Subscription erstattet, sendet Stripe charge.refunded, und die Provision wird automatisch zurückgeholt. Eine Kündigung (customer.subscription.deleted) stoppt künftige Provisionen auf Verlängerungen, holt aber bereits verdiente Provision nicht zurück. Für beides musst du auf der Seite von beehiiv nichts einstellen.

Fehlerbehebung

Ein Testkauf erscheint als Kauf, aber nicht als gutgeschriebener Verkauf. Gib die Adresse des Käufers auf der beehiiv-Integrationsseite unter E-Mail-Adresse eines Abonnenten prüfen ein. Hat beehiiv dafür keinen Abonnenten, hat der Leser bezahlt, bevor er sich eingetragen hat, oder er hat sich auf einer Seite eingetragen, die nicht von beehiiv gehostet wird. Existiert der Abonnent, hat aber keinen Tag, stand er schon vor dem Klick auf deiner Liste; diesen Fall deckt das optionale Tag oben ab. Ist der Tag da und der Verkauf wurde trotzdem nicht gutgeschrieben, prüfe, ob das unter Einrichtung > Zahlungsanbieter verbinden verbundene Stripe-Konto das ist, über das beehiiv abrechnet, und ob Verkäufe über beehiiv gutschreiben eingeschaltet ist.

Käufe erscheinen überhaupt nicht. Das verbundene Stripe-Konto ist nicht das, über das beehiiv abrechnet. Verbinde unter Einrichtung > Zahlungsanbieter verbinden neu und wähle das Konto, das beehiiv für deine Publikation angelegt hat.

Das optionale Tag lädt auf beehiiv-Seiten nicht. Prüfe drei Dinge der Reihe nach: Die GTM-Container-ID ist in beehiiv unter Settings > Pixels korrekt eingefügt; das Custom-HTML-Tag in GTM hat den Trigger „All Pages“; der GTM-Container ist veröffentlicht (nicht nur als Entwurf gespeichert). Am häufigsten wurde in GTM schlicht nicht auf Publish geklickt. Teste zuerst im Preview-Modus von GTM und denk an das Cookie-Banner: Klicke auf Accept und lade die Seite dann neu.

Boost-Ausgaben erscheinen in beehiiv, aber nicht in Rekomi. Das ist zu erwarten. Boost lässt sich bewusst nicht über Rekomi zuordnen (siehe „beehiiv Boost, Premium Subscriptions und Referral Program im Vergleich“ oben).

Anmeldungen über das native Referral Program kollidieren mit Affiliate-Empfehlungen. Tun sie nicht; das sind getrennte Dinge. Das native Referral Program belohnt kostenlose Anmeldungen mit Merch (Wachstum auf der Leserseite). Rekomi vergütet Upgrades auf bezahlte Premium Subscriptions. Ein und derselbe Leser kann gleichzeitig kostenlose Anmeldungen für Merch vermitteln UND über Rekomi bezahlten Affiliate-Umsatz bringen.

Verwandte Seiten

• beehiiv-CRM-Verbindung: die beiden Schalter, die Statuszeile, Anmeldebenachrichtigungen und Grenzen
• Checkout-Tracking ohne Code und ohne Stripe
• Überblick über Tracking und Attribution
• Dokumentation zu Google Tag Manager