beehiiv

Verbinde beehiiv einmal, und die Verbindung erledigt zwei Aufgaben. Freigegebene Affiliates landen in deiner Publikation, und bezahlte Abonnements werden dem Affiliate gutgeschrieben, dessen Link den Leser gebracht hat, ganz ohne Skript im Browser des Lesers.

Die beehiiv-Verbindung von Rekomi erledigt zwei Aufgaben, und jede hat auf der Integrationsseite ihren eigenen Schalter. Affiliates in beehiiv synchronisieren trägt jeden freigegebenen Affiliate als Abonnenten in deine Publikation ein. Verkäufe über beehiiv gutschreiben schreibt bezahlte Abonnements dem Affiliate gut, dessen Link den Leser gebracht hat. Dafür nutzt Rekomi die Angaben, die beehiiv selbst darüber speichert, wie jeder Abonnent gekommen ist. Beide Schalter sind standardmäßig an.

Was diese Verbindung kann und was nicht. Sie synchronisiert Affiliates in beehiiv und nennt den Affiliate bei Verkäufen, die über das Stripe-Konto eingehen, das beehiiv für deine bezahlten Abonnements angelegt hat. Die Verkäufe selbst erfasst sie nicht: Dieses Stripe-Konto muss unter Einrichtung > Zahlungsanbieter verbinden verbunden sein, denn von dort kommt der Verkauf. Einen Leser, der schon auf deiner Liste war, bevor er auf einen Affiliate-Link geklickt hat, kann sie nicht gutschreiben, weil beehiiv die Herkunft nur einmal speichert, bei der Anmeldung (siehe die Grenzen unten).

Verkäufe über beehiiv gutschreiben

So funktioniert es

Jeder Affiliate-Link, den Rekomi für deine Kampagne ausgibt, trägt zwei zusätzliche Parameter: utm_source=rekomi und utm_campaign mit dem Link-Slug des Affiliates. Zum Beispiel: https://newsletter.example.com?via=jane&utm_source=rekomi&utm_campaign=jane. Links, die deine Affiliates schon geteilt haben, funktionieren weiter; Rekomi ergänzt die Tags nur in den Links, die es erzeugt.
Kommt ein Leser über diesen Link auf deine beehiiv-Website und abonniert, speichert beehiiv diese beiden Werte beim neuen Abonnenten. beehiiv schreibt sie einmal, bei der Anmeldung, und überschreibt sie nie.
Bezahlt dieser Abonnent später ein Premium-Abonnement, meldet Stripe Rekomi den Verkauf. Rekomi versucht zuerst alles, was es schon weiß (einen Gutschein, Checkout-Metadaten, die Historie des Kunden, einen selbst erfassten E-Mail-Lead). Nur wenn nichts davon einen Affiliate nennt, fragt es bei beehiiv den Abonnenten über seine E-Mail-Adresse ab, liest den gespeicherten Tag und schreibt den Verkauf dem Affiliate gut, den der Tag nennt. Der Verkauf erscheint dann in deinem Dashboard wie jeder andere, mit beehiiv als Quelle.
Für all das läuft nichts im Browser des Lesers. Kein Skript, kein Cookie-Banner, kein Tag-Manager.

Was du brauchst

Das Stripe-Konto, das beehiiv für bezahlte Abonnements angelegt hat, verbunden unter Einrichtung > Zahlungsanbieter verbinden. beehiiv legt dieses Konto unter deinem eigenen Stripe-Login an, getrennt von allen anderen Stripe-Konten, die du nutzt. Achte also darauf, im Zustimmungsbildschirm von Stripe genau dieses auszuwählen. Ohne dieses Konto erreicht kein Verkauf Rekomi, und es gibt nichts gutzuschreiben.
Die beehiiv-Verbindung auf dieser Seite mit eingeschaltetem Verkäufe über beehiiv gutschreiben. Der Schalter ist ab dem Verbinden an.

Mehr nicht. Das optionale Klickstatistik-Tag aus der Installationsanleitung für beehiiv ergänzt Klickzahlen und einen Lead, sobald ein Leser eine E-Mail-Adresse eingibt, was auch die Leser abdeckt, die unter den Grenzen unten beschrieben sind. Für die Gutschrift von Verkäufen brauchst du es aber nicht.

Der Schalter und die Statuszeile

Verkäufe über beehiiv gutschreiben steht auf der Integrationsseite neben Affiliates in beehiiv synchronisieren. Darunter zeigt die Seite den Status in einem einfachen Satz: ob Rekomis letzte Prüfung deiner Publikation geklappt hat und wann sie lief, und wie viele Verkäufe bisher über beehiiv gutgeschrieben wurden. Rekomi führt diese Prüfung beim Verbinden aus, die Seite sagt dir also sofort, ob alles bereit ist, statt auf den ersten Verkauf zu warten. Ein Abonnent wird nur gutgeschrieben, wenn er innerhalb des auf der Seite angezeigten Zeitraums abonniert hat (standardmäßig 365 Tage, gerechnet ab dem Anmeldedatum, das beehiiv speichert).

Schaltest du den Schalter aus, stoppen die Abfragen, die beiden Tags verschwinden aus den Links deiner Affiliates, und die Benachrichtigungen bei Anmeldungen unten fallen weg. Sonst ändert sich an der Verbindung nichts; die Synchronisierung der Affiliates läuft weiter.

E-Mail-Adresse eines Abonnenten prüfen

Unter dem Verkaufsblock nimmt E-Mail-Adresse eines Abonnenten prüfen eine Adresse entgegen und sagt dir, was beehiiv dazu gespeichert hat: ob die Person Abonnent ist, ob der Herkunfts-Tag einen deiner Affiliates nennt und ob ein Verkauf von dieser E-Mail-Adresse gutgeschrieben würde, in einem Satz. Nutze das zum Testen ohne Support-Ticket: Öffne einen Affiliate-Link, abonniere mit einer neuen Adresse und prüfe diese Adresse dann hier. Varianten mit Pluszeichen desselben Postfachs (you+test@gmail.com und you@gmail.com) werden als dieselbe Person geprüft.

Ist der Schalter an, registriert Rekomi außerdem einen Webhook in deiner Publikation. So erscheint ein neuer Abonnent, der über einen Affiliate-Link kam, sofort als Lead unter diesem Affiliate, noch vor jedem Verkauf. beehiiv bietet Webhooks ab dem Plan Scale an. In anderen Plänen zeigt die Integrationsseite unter dem Verkaufsstatus eine Zeile, dass Benachrichtigungen bei Anmeldungen Scale oder höher brauchen. Verkäufe werden trotzdem gutgeschrieben; es fehlt nur der frühe Lead.

beehiiv schreibt den Tag nur über ein Anmeldeformular. Ein Leser, der von einem Affiliate-Link direkt auf die Upgrade-Seite geht, seine E-Mail-Adresse in das Checkout-Feld von beehiiv eingibt und bezahlt, wird ohne Tag angelegt. Diesen Verkauf kann die Verbindung allein also nicht gutschreiben. Schalte für diese Leser in den Tracking-Einstellungen der Kampagne den Checkout-Weg ein; die Installationsseite für beehiiv führt dich durch die zwei Schritte. Beide Wege laufen parallel: Die Verbindung schreibt Abonnenten gut, der Checkout-Weg Käufer, die direkt zum Checkout gehen.

Grenzen, offen gesagt

beehiiv speichert die Herkunft einmal, bei der Anmeldung. Ein Leser, der schon auf deiner kostenlosen Liste war, bevor er auf einen Affiliate-Link geklickt hat, und später upgradet, wird über diese Verbindung nicht gutgeschrieben. Für diese Leser erfasst das optionale Klickstatistik-Tag aus der Installationsanleitung trotzdem einen Lead, sobald sie nach dem Klick ihre E-Mail-Adresse auf deiner Website eingeben, und dieser Lead schreibt den Verkauf über den Abgleich der E-Mail-Adresse gut.
Nur von beehiiv gehostete Seiten speichern den Tag. Ein beehiiv-Anmeldeformular, das in eine andere Website eingebettet ist, erfasst die Herkunft nicht, es sei denn, auf dieser Seite läuft das eigene Attributionsskript von beehiiv.
Einmalige digitale Produkte, die über dasselbe Stripe-Konto verkauft werden, werden noch nicht gutgeschrieben. Premium-Abonnements werden heute gutgeschrieben; einmalige Produkte auf diesem Konto werden auf dieselbe Weise gutgeschrieben, sobald das Update der Rekomi-App für Stripe live ist. Ausgaben für beehiiv Boost und das eingebaute Referral Program sind eigene Funktionen von beehiiv, die Rekomi nie erfasst (die Installationsanleitung stellt alle drei nebeneinander).

Affiliates in beehiiv synchronisieren

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /v2/publications/{publicationId}/subscriptions mit email, reactivate_existing: true und send_welcome_email: false auf.

beehiiv kennt keine Listenauswahl; Abonnenten gelten für die ganze Publikation.

Einschränkung der Plattform: Die Abonnement-API von beehiiv hat keine Felder für Vor- und Nachnamen, Affiliates kommen also als Abonnenten nur mit E-Mail-Adresse an. Rekomi füllt bei jedem Affiliate aber eigene Felder: Rekomi referral link, Rekomi referral slug, Rekomi campaign und Rekomi affiliate status, die bei der ersten Synchronisierung in deiner Publikation angelegt werden.

API-Schlüssel und Publication ID finden

In beehiiv:

Settings → Integrations → API Keys.
Erzeuge einen neuen API-Schlüssel. Kopiere den Schlüssel.
Auf derselben Seite steht deine Publication ID (beginnt mit pub_).

beehiiv in Rekomi verbinden

Öffne Integrationen in der Seitenleiste des Dashboards.
Klicke auf die Karte beehiiv.
Füge deinen API-Schlüssel und die Publication ID ein. Klicke auf Verbinden.
Rekomi führt einen Testaufruf gegen GET /v2/publications/{publicationId} aus, um beides zu prüfen, und testet dann, ob es Abonnenten abfragen kann, damit die Statuszeile für Verkäufe sofort ausgefüllt ist.

Das Verbindungsformular für beehiiv in Rekomi mit den Feldern für API-Schlüssel und Publication ID und dem Button Verbinden

Vermittelte Kunden und Leads (optional)

Schalte unter Affiliates in beehiiv synchronisieren die Option Vermittelte Kunden und Leads synchronisieren ein, dann schreibt Rekomi jeden Verkauf und jeden Lead, den es einem Affiliate zuordnet, auch nach beehiiv. Der Abgleich läuft über die E-Mail-Adresse, bestehende Kontakte werden also aktualisiert statt doppelt angelegt. Verkäufe, die über die Abfrage oben über beehiiv gutgeschrieben wurden, sind eingeschlossen. Jeder Eintrag enthält:

die eigenen Felder Rekomi referral link, Rekomi campaign, Rekomi referring affiliate, Rekomi referring affiliate code, Rekomi last event und Rekomi last sale amount, angelegt beim ersten Einsatz
keine Tags (beehiiv hat keine); filtere stattdessen nach Rekomi last event
Affiliates, die über den Abschnitt oben synchronisiert werden, bekommen in denselben Feldern zusätzlich Rekomi referral link, Rekomi referral slug, Rekomi campaign und Rekomi affiliate status, damit du den Link eines Partners in deine E-Mails einbauen kannst. Der hier geschriebene Empfehlungslink trägt dieselben zwei Tags wie die Links, die Rekomi Affiliates anzeigt.

Erstattete, abgelehnte und wegen Betrugsverdacht in Quarantäne gestellte Conversions werden nie übertragen, importierte historische Conversions werden übersprungen. Die Option ist standardmäßig ausgeschaltet. Wenn du sie einschaltest, werden vermittelte Kunden als Abonnenten in deine Publikation eingetragen. Lass sie aus, wenn du nur Affiliates in beehiiv haben willst.

Wann synchronisiert wird

Standard: Nur Affiliates im Status Approved (freigegeben) werden synchronisiert.
Optional: Schalte „Bewerber vor der Freigabe einschließen“ ein, um auch Pending (ausstehend) zu synchronisieren.

Einstellungen pro Kampagne

Jede Kampagne kann die Konfiguration auf Kontoebene überschreiben. Öffne auf der Detailseite einer Kampagne den Tab Kampagneneinstellungen und scrolle zum Abschnitt CRM-Sync.

Sync-Status pro Affiliate

Öffne die Detailseite eines beliebigen Affiliates. Das Panel CRM-Sync zeigt den Status pro CRM. Erneut synchronisieren verwirft frühere Jobs und startet den Sync neu.

Fehlerbehebung

404 beim Test: Die Publication ID ist falsch, oder der API-Schlüssel hat keinen Zugriff auf diese Publikation.
publication_id_invalid: Die Publication ID hat nicht das Format pub_*. Kopiere sie noch einmal aus Settings → Integrations.
429: beehiiv drosselt bei 180 Anfragen pro Minute. Die Synchronisierung der Affiliates beachtet den Header RateLimit-Reset. Die Abfrage für Verkäufe teilt sich dieses Kontingent: etwa eine Abfrage pro Verkauf, mit einem kurzen Cache pro E-Mail-Adresse, damit derselbe Käufer bei vielen Anfragen auf einmal nicht zweimal abgefragt wird. Eine Abfrage, die ein 429 bekommt, wird nach zwei Minuten wiederholt.
Ein Testkauf erscheint als Kauf, aber nicht als gutgeschriebener Verkauf: Nutze E-Mail-Adresse eines Abonnenten prüfen mit genau der Adresse, mit der du gekauft hast. Hat beehiiv keinen Abonnenten dazu, hat der Leser vor dem Abonnieren bezahlt oder auf einer Seite abonniert, die nicht von beehiiv gehostet wird. Gibt es den Abonnenten, aber ohne Tag, war er schon vor dem Klick auf deiner Liste (siehe Grenzen). Ist der Tag da und der Verkauf wurde trotzdem nicht gutgeschrieben, prüfe, ob das unter Einrichtung verbundene Stripe-Konto das ist, über das beehiiv abrechnet.
Sync schlägt mit 401/403 fehl, obwohl er vorher lief: Der API-Schlüssel wurde widerrufen. Rekomi markiert die Integration mit „Aktion nötig“ und schickt dir pro Störung einmal eine E-Mail mit der Bitte, neu zu verbinden. Verbinde dich mit einem neuen Schlüssel und nutze dann auf der Kachel Fehlgeschlagen der Integrationsseite Alle erneut synchronisieren.

Trennen

Klicke auf der Verbindungsseite von beehiiv auf Trennen. Der Integrationseintrag und die Einstellungen pro Kampagne werden gelöscht, und der Anmelde-Webhook wird aus deiner Publikation entfernt. Der Sync-Verlauf bleibt erhalten.

Anwendungsfälle, passende Zielgruppen und besondere Automatisierungsmuster findest du im Überblick zur beehiiv-Integration auf der Website.

On this page