ConvertKit (Kit)

Die Verbindung von Rekomi zu ConvertKit (heute unter dem Namen Kit) erledigt zwei Aufgaben, und jede hat auf der Integrationsseite ihren eigenen Schalter. Affiliates in Kit synchronisieren trägt jeden freigegebenen Affiliate in ein Formular in Kit ein, das du auswählst (das Datenmodell von Kit dreht sich um Formulare statt um Listen: Ein Abonnent kommt in dein Konto, indem er einem Formular zugeordnet wird, und Automatisierungen und Sequenzen starten dann von diesem Formular aus). Verkäufe über Kit gutschreiben schreibt Verkäufe dem Affiliate gut, dessen Link den Abonnenten gebracht hat. Dafür nutzt Rekomi die Herkunftsangabe, die Kit bei jedem Abonnenten speichert. Beide Schalter sind standardmäßig an.

Was diese Verbindung kann und was nicht. Sie synchronisiert Affiliates in Kit, schreibt Verkäufe Affiliates gut und holt bei Kit Commerce auch die Verkäufe selbst in Rekomi, weil Kit Commerce über ein von Kit verwaltetes Stripe-Konto abrechnet, das sich nicht mit Rekomi verbinden lässt. Verkaufst du stattdessen über dein eigenes Stripe, kommt der Verkauf von diesem Stripe-Konto, verbunden unter Einrichtung > Zahlungsanbieter verbinden, und die Kit-Verbindung nennt den Affiliate. Einen Käufer, der sich nie über ein Kit-Formular oder eine Kit-Landingpage angemeldet hat, kann sie nicht gutschreiben, weil Kit die Herkunft nur bei diesen Anmeldungen speichert (siehe die Grenzen unten).

Verkäufe über Kit gutschreiben

So funktioniert es

1. 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.
2. Kommt ein Leser über diesen Link und meldet sich über ein Kit-Formular oder eine Kit-Landingpage an (ein Kit-Formular, das in deine eigene Website eingebettet ist, zählt auch), speichert Kit diese Werte beim neuen Abonnenten. Kit schreibt sie einmal, bei dieser ersten Anmeldung.
3. Kauft dieser Abonnent später, erreicht der Verkauf Rekomi auf einem von zwei Wegen. Ein Kauf über Kit Commerce kommt über den Kauf-Feed, den Rekomi beim Verbinden bei Kit registriert. Ein Kauf über dein eigenes verbundenes Stripe kommt über Stripe. In beiden Fällen gilt: Wenn nichts anderes einen Affiliate nennt (ein Gutschein, Checkout-Metadaten, die Historie des Kunden, ein von Rekomi selbst erfasster E-Mail-Lead), fragt Rekomi bei Kit den Abonnenten über seine E-Mail-Adresse ab, liest den gespeicherten Tag und schreibt den Verkauf dem Affiliate gut, den er nennt. Ein Rabattcode, der bei einem Kauf über Kit Commerce angegeben ist, zählt als dieser Gutschein: Ist es ein Code, den Rekomi für einen deiner Affiliates erzeugt hat, wird der Verkauf diesem Affiliate gutgeschrieben, auch wenn sich der Käufer nie über ein Formular angemeldet hat.
4. Für all das läuft nichts im Browser des Käufers. Das Skript pro Landingpage aus der Installationsanleitung für Kit ist optional und ergänzt nur Klickzahlen und frühe Leads.

Was du brauchst

• Die Kit-Verbindung auf dieser Seite mit eingeschaltetem Verkäufe über Kit gutschreiben. Der Schalter ist ab dem Verbinden an, und beim Verbinden wird der Kauf-Feed für Kit Commerce für dich registriert; du musst nichts bauen oder weiterleiten.
• Wenn du über dein eigenes Stripe verkaufst statt über Kit Commerce: dieses Stripe-Konto, verbunden unter Einrichtung > Zahlungsanbieter verbinden.

Der Schalter und die Statuszeile

Verkäufe über Kit gutschreiben steht auf der Integrationsseite neben Affiliates in Kit synchronisieren. Darunter zeigt die Seite den Status in einem einfachen Satz: ob Rekomis letzte Prüfung deines Kontos geklappt hat und wann sie lief, und wie viele Verkäufe bisher über Kit gutgeschrieben wurden. Rekomi führt diese Prüfung beim Verbinden aus. Ein Abonnent wird nur gutgeschrieben, wenn er innerhalb des auf der Seite angezeigten Zeitraums beigetreten ist (standardmäßig 365 Tage, gerechnet ab dem Anmeldedatum, das Kit speichert).

Schaltest du den Schalter aus, stoppen die Abfragen, die beiden Tags verschwinden aus den Links deiner Affiliates, und der Kauf-Feed und die Benachrichtigungen bei Anmeldungen unten werden entfernt. Solange er aus ist, erreichen Käufe über Kit Commerce Rekomi also nicht mehr. 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 Kit 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. Nutze das zum Testen: Öffne einen Affiliate-Link, melde dich mit einer neuen Adresse über dein Kit-Formular an und prüfe diese Adresse dann hier.

Benachrichtigungen bei Anmeldungen

Ist der Schalter an, registriert Rekomi signierte Kit-Webhooks für neue und aktivierte Abonnenten. So erscheint ein Abonnent, der über einen Affiliate-Link kam, sofort als Lead unter diesem Affiliate, noch vor jedem Verkauf. Abonnenten, die Rekomi selbst hinzugefügt hat (deine synchronisierten Affiliates), bleiben außen vor.

Grenzen, offen gesagt

• Kit speichert die Herkunft nur bei Anmeldungen über Formulare und Landingpages. Ein Abonnent, der per Import, über die API, über das Creator Network oder durch eine Bestellung bei Kit Commerce ohne vorherige Anmeldung über ein Formular angelegt wurde, trägt keinen Tag. Ein Käufer, der direkt zum Checkout geht, ohne sich vorher anzumelden, wird über diese Verbindung also nicht gutgeschrieben.
• Kit schreibt die Herkunft einmal. Ein Abonnent, der schon auf deiner Liste war, bevor er auf einen Affiliate-Link geklickt hat, wird über die Abfrage nicht gutgeschrieben. Das optionale Skript aus der Installationsanleitung erfasst einen Lead, wenn so ein Leser seine E-Mail-Adresse auf einer Seite eingibt, auf der es läuft, und dieser Lead schreibt den Verkauf über den Abgleich der E-Mail-Adresse gut.
• Kit hat kein Erstattungsereignis. Bei einem erstatteten Kauf über Kit Commerce wird die Provision nicht automatisch zurückgeholt, weil Kit Rekomi nie über die Erstattung informiert. Wenn du eine Kit-Bestellung erstattest, erkläre den passenden Verkauf auf der Seite Conversions für ungültig, dann wird die Provision storniert.
• Das Rate-Limit von Kit wird geteilt. Kit erlaubt 120 Anfragen pro Minute und Schlüssel. Rekomi macht pro Verkauf eine oder zwei Abfragen, hält einen kurzen Cache pro E-Mail-Adresse, damit derselbe Käufer bei vielen Anfragen auf einmal nicht zweimal abgefragt wird, und wiederholt eine Abfrage nach zwei Minuten, wenn Kit mit 429 antwortet. Die Synchronisierung der Affiliates beachtet Retry-After, ein voller Launch-Tag verlangsamt die Synchronisierung also etwas, statt Verkäufe zu verlieren.

Affiliates in Kit synchronisieren

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), führt Rekomi die Abfolge aus Anlegen und Formular-Zuordnung der Kit-API v4 aus:

1. POST /v4/subscribers legt den Abonnenten über seine E-Mail-Adresse mit email_address, first_name und fields.last_name an oder aktualisiert ihn (der Formular-Endpunkt von Kit v4 akzeptiert nur Abonnenten, die schon existieren, deshalb kommt dieser Schritt immer zuerst).
2. POST /v4/forms/{form_id}/subscribers fügt den Abonnenten deinem gewählten Formular hinzu.
3. Jeder eingerichtete Tag wird über seinen Namen vergeben (fehlende Tags werden in Kit automatisch angelegt).

Das Anlegen eines Abonnenten ist ein dokumentiertes Upsert: Wird dieselbe E-Mail-Adresse erneut eingetragen, entsteht nie ein Duplikat, nur ihre Attribute werden aufgefrischt. Wird ein Abonnent erneut einem Formular hinzugefügt, in dem er schon ist, passiert ebenfalls nichts.

API-Schlüssel finden

In Kit:

1. Öffne Settings → Developer.
2. Klicke auf Generate API Key, um einen API-Schlüssel v4 zu erstellen.
3. Kopiere den Schlüssel. Alte API-Secrets aus v3 funktionieren nicht; wenn du nur ein Secret aus v3 hast, erzeuge einen neuen Schlüssel für v4.

ConvertKit in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte Kit (Kit ist der aktuelle Markenname von ConvertKit).
3. Füge deinen API-Schlüssel v4 ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /v4/account aus, um den Schlüssel zu prüfen, und testet dann, ob es Abonnenten abfragen kann, damit die Statuszeile für Verkäufe sofort ausgefüllt ist.
5. Wähle nach dem Verbinden im Dropdown Formular ein Standardformular. Klicke auf Aktualisieren, nachdem du in Kit ein neues Formular angelegt hast.

Tags

Optional. Kommagetrennte Tag-Namen. Rekomi gleicht jeden Namen mit den Tags in deinem Kit-Konto ab, legt fehlende an (das Anlegen von Tags in Kit lässt sich gefahrlos wiederholen und unterscheidet keine Groß- und Kleinschreibung) und hängt sie dann an den Abonnenten.

Der Standard-System-Tag Rekomi affiliate wird auf dieselbe Weise vergeben, sodass jeder von Rekomi synchronisierte Abonnent in Kit von Anfang an erkennbar ist. Fehler bei Tags sind nicht kritisch: Der Abonnent ist schon in deinem Formular, wenn die Tags vergeben werden, ein Problem mit einem Tag blockiert die Synchronisierung also nie.

Vermittelte Kunden und Leads (optional)

Schalte unter Affiliates in Kit synchronisieren die Option Vermittelte Kunden und Leads synchronisieren ein, dann schreibt Rekomi jeden Verkauf und jeden Lead, den es einem Affiliate zuordnet, auch nach ConvertKit (Kit). 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 Kit 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
• die Tags Rekomi customer oder Rekomi lead
• Affiliates, die über den Abschnitt oben synchronisiert werden, bekommen in denselben Feldern zusätzlich Rekomi referral link, 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. Vermittelte Kunden werden NICHT in dein verbundenes Formular eingetragen (sie bekommen also nie das Incentive oder die Sequenz des Formulars); sie erhalten nur den Tag und die Felder.

Wann synchronisiert wird

• Standard: Nur Affiliates im Status Approved (freigegeben) werden synchronisiert.
• Optional: Aktiviere auf der Einstellungskarte des Anbieters „Bewerber vor der Freigabe einschließen“, um Affiliates im Status Pending (ausstehend) sofort bei der Bewerbung zu synchronisieren.

Einstellungen pro Kampagne

Jede Kampagne kann an ein anderes Kit-Formular gehen oder Kit ganz auslassen. Öffne die Kampagneneinstellungen der Kampagne und suche den Abschnitt CRM-Sync. Dort legst du fest:

• Ein kampagnenspezifisches Formular (überschreibt den Standard des Kontos).
• Zusätzliche Tags (ergänzend zu dem, was auf Kontoebene eingestellt ist).
• Einen Schalter zum Deaktivieren pro Kampagne.

Sync-Status pro Affiliate

Die Detailseite eines Affiliates hat ein Panel CRM-Sync, das jedes verbundene CRM und den letzten Sync-Status für diesen Affiliate zeigt. Der Button Erneut synchronisieren löscht frühere Job-Einträge und startet die Synchronisierung von vorn, praktisch, nachdem du eine falsch eingestellte Tag-ID oder Formularauswahl korrigiert hast.

Fehlerbehebung

• „Kit migrated to API v4...“: Deine Verbindung wurde mit einem alten API-Secret aus v3 erstellt, das sich bei v4 nicht authentifizieren kann. Trenne die Verbindung, erzeuge in Kit einen API-Schlüssel v4 (Settings → Developer → Generate API Key) und verbinde neu.
• „Form not found“: Das Formular wurde in Kit gelöscht, nachdem Rekomi seine ID zwischengespeichert hatte. Aktualisiere die Formularauswahl und wähle ein aktuelles Formular.
• Tags werden nicht vergeben: Fehler beim Vergeben von Tags sind nicht kritisch, der Abonnent landet also trotzdem im Formular. Sieh im Panel CRM-Sync des Affiliates nach dem Tag-Fehler und klicke dann auf Erneut synchronisieren.
• Ein Kauf über Kit Commerce erscheint als Kauf, aber nicht als gutgeschriebener Verkauf: Nutze E-Mail-Adresse eines Abonnenten prüfen mit der Adresse des Käufers. Kein Abonnent bedeutet, dass der Käufer ohne Anmeldung über ein Formular direkt zum Checkout gegangen ist; ein Abonnent ohne Tag bedeutet, dass er vor dem Klick beigetreten ist oder über einen Import, die API oder das Creator Network kam.
• Sync schlägt mit 401/403 fehl, obwohl er vorher lief: 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 für v4 und nutze dann auf der Kachel Fehlgeschlagen der Integrationsseite Alle erneut synchronisieren.

Ein Hinweis zu API-Versionen

Rekomi nutzt die API v4 von Kit mit persönlichen API-Schlüsseln (Authentifizierung über den Header). Kit hat die aktive Entwicklung von v3 eingestellt, und API-Secrets aus v3 sind ein eigenes Paar von Zugangsdaten, getrennt von Schlüsseln für v4. Deshalb müssen bestehende Verbindungen über v3 mit einem Schlüssel für v4 neu verbunden werden; eine automatische Migration gibt es nicht.

Trennen

Klicke auf der Verbindungsseite von Kit auf Trennen. Der Integrationseintrag und alle Einstellungen pro Kampagne werden gelöscht, und der Kauf-Feed und die Anmelde-Webhooks, die Rekomi registriert hat, werden aus deinem Kit-Konto entfernt. Der bisherige Sync-Verlauf bleibt für Prüfzwecke erhalten.

---

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