Ontraport

Die Ontraport-Verbindung von Rekomi erledigt zwei Aufgaben, und jede hat auf der Integrationsseite ihren eigenen Schalter. Affiliates in Ontraport synchronisieren legt jeden freigegebenen Affiliate als Kontakt an oder aktualisiert ihn (Upsert) und setzt Tags. Verkäufe über Ontraport gutschreiben holt deine Ontraport-Verkäufe in Rekomi und schreibt jeden dem Affiliate gut, über dessen Link der Kontakt kam. Dafür nutzt Rekomi die Lead-Quelle (lead source) und die Kampagne, die Ontraport bei jedem Kontakt speichert. Beide Schalter sind standardmäßig an.

Was diese Verbindung kann und was nicht. Sie synchronisiert Affiliates nach Ontraport und ist die Quelle deiner Ontraport-Verkäufe in Rekomi: Ontraport belastet die hinterlegte Karte selbst über deinen Zahlungsanbieter, diese Verkäufe kommen also nie über eine Stripe-Verbindung an, und Rekomi erfährt über die Ontraport-Verbindung davon. Die Verbindung liest die Tracking-Felder von Ontraport und schreibt sie nie. Für einen Kontakt, der von einer Seite ohne das Tracking-Skript von Ontraport auf dein Bestellformular kam, kann sie nichts gutschreiben (siehe die Grenzen unten).

Verkäufe über Ontraport 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 jeweiligen Affiliates. Zum Beispiel: https://newsletter.example.com?via=jane&utm_source=rekomi&utm_campaign=jane.
2. Landet ein Besucher über diesen Link auf einer Seite, auf der das Tracking-Skript von Ontraport läuft (auf Ontraport Pages und PilotPress-Websites automatisch), und sendet ein beliebiges Ontraport-Formular ab, auch ein Bestellformular, speichert Ontraport die Ankunft als Lead-Quelle und Kampagne des Kontakts. Ontraport behält dabei sowohl die erste als auch die letzte Ankunft.
3. Erfasst Ontraport einen Kauf, erfährt Rekomi davon über Kaufereignisse für Produkte, die beim Verbinden registriert werden, und über eine stündliche Prüfung deiner Ontraport-Transaktionen, die alles auffängt, was die Ereignisse verpasst haben. Rekomi liest den Kontakt, prüft, ob die Lead-Quelle rekomi ist, ordnet den Wert der Kampagne einem deiner Affiliates zu und schreibt den Verkauf gut. Zuerst wird die erste Ankunft geprüft, dann die letzte. Ein Rabattcode, der im Bestellformular eingelöst wurde, wird noch vor allem anderen geprüft: Trägt die Transaktion einen Code, den Rekomi für einen deiner Affiliates erzeugt hat, bekommt dieser Affiliate die Gutschrift, auch wenn der Käufer nie auf einen Link geklickt hat.
4. Erstattungen und Stornos erkennt dieselbe stündliche Prüfung des Transaktionsstatus, denn Ontraport sendet kein Ereignis für Erstattungen. Eine Erstattung macht die Provision also innerhalb von etwa einer Stunde rückgängig. Geprüft werden Verkäufe der letzten 120 Tage.
5. Beträge werden in deiner Heimatwährung erfasst, außer die Ontraport-Transaktion trägt einen eigenen Währungscode, denn Ontraport rechnet in der Währung deines Kontos ab.

Was du brauchst

• Die Ontraport-Verbindung auf dieser Seite mit eingeschaltetem Verkäufe über Ontraport gutschreiben. Der Schalter ist ab dem Verbinden an. Für Ontraport-Verkäufe brauchst du in Rekomi keine Verbindung zu einem Zahlungsanbieter.
• Das Tracking-Skript von Ontraport auf den Seiten, auf denen Affiliate-Links landen. Ontraport Pages und PilotPress haben es bereits. Auf einer Seite, die woanders gehostet ist, fügst du den Tracking-Code von Ontraport ein, damit die Ankunft gespeichert wird.

Der Schalter und die Statuszeile

Verkäufe über Ontraport gutschreiben sitzt auf der Integrationsseite neben Affiliates in Ontraport synchronisieren. Darunter zeigt die Seite einen schlichten Satz zum Status: ob die letzte Prüfung von Rekomi erfolgreich war, wann sie lief und wie viele Verkäufe bisher über Ontraport gutgeschrieben wurden. Ein Verkauf wird nur gutgeschrieben, wenn der Kontakt innerhalb des Zeitfensters angelegt wurde, das die Seite anzeigt (standardmäßig 365 Tage).

Schaltest du den Schalter aus, enden die Abfragen, die Kaufereignisse und die stündliche Prüfung, und die beiden Tags verschwinden aus den Links deiner Affiliates. Die Verbindung ist der einzige Weg, auf dem Ontraport-Verkäufe Rekomi erreichen. Solange der Schalter aus ist, werden also keine Ontraport-Verkäufe erfasst. Der Affiliate-Sync läuft weiter.

E-Mail-Adresse eines Abonnenten prüfen

Unter dem Verkaufsbereich nimmt E-Mail-Adresse eines Abonnenten prüfen eine Adresse entgegen und zeigt dir, was Ontraport dazu gespeichert hat: ob der Kontakt existiert, ob seine Lead-Quelle und Kampagne einen deiner Affiliates nennen und ob ein Verkauf von dieser E-Mail-Adresse gutgeschrieben würde. So testest du es: Öffne einen Affiliate-Link, sende ein Formular mit einer neuen Adresse ab und prüfe diese Adresse dann hier.

Benachrichtigungen bei Anmeldungen

Ist der Schalter an, registriert Rekomi außerdem einen Ontraport-Webhook für neue Kontakte. Ein Kontakt, der über einen Affiliate-Link kam, erscheint so sofort als Lead bei diesem Affiliate, noch vor jedem Verkauf.

Grenzen, offen gesagt

• Deine eigenen Kampagnen-Links können die letzte Ankunft überschreiben. Ontraport aktualisiert die letzte Lead-Quelle eines Kontakts bei jedem erfassten Besuch. Klickt ein Kontakt vor dem Kauf in einer deiner eigenen E-Mails auf einen Link mit UTM-Parametern, trägt er deine Kampagne als letzte Ankunft. Deshalb prüft Rekomi zuerst die erste Ankunft, und die erste Ankunft wird nie überschrieben.
• Die Seite muss das Tracking-Skript von Ontraport ausführen. Eine Landingpage ohne das Skript speichert nichts, egal wie der Besucher gekommen ist.
• Das Rate-Limit von Ontraport wird geteilt. Ontraport erlaubt 180 Anfragen pro Minute und Konto. Rekomi braucht ein bis zwei Lesezugriffe pro Verkauf und einen pro Benachrichtigung bei einer Anmeldung, hält einen kurzen Cache pro E-Mail-Adresse, damit derselbe Käufer bei einer Häufung nicht zweimal gelesen wird, und wiederholt einen Lesezugriff für Verkäufe nach zwei Minuten, wenn Ontraport mit 429 antwortet. Der Affiliate-Sync legt eine Pause ein, wenn Ontraport mit 429 antwortet.

Affiliates in Ontraport synchronisieren

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), führt Rekomi zwei bis drei Aufrufe aus:

1. POST /1/objects/saveorupdate mit objectID: 0 (Kontakte), email, firstname, lastname, ignore_blanks: true. Liefert die Kontakt-ID.
2. PUT /1/objects/tag mit objectID: 0, ids: [contactId], add_list: [tagId, ...], um den gewählten Tag und alle zusätzlichen numerischen Tag-IDs anzuhängen.
3. PUT /1/objects/tagByName mit add_names: [...] für alle Tags, die per Name konfiguriert sind; fehlende Tag-Namen legt Ontraport bei diesem Aufruf automatisch an. Dieser Aufruf trägt den System-Tag Rekomi affiliate.

Die Folge mehrerer Aufrufe ist nötig, weil das Speichern des Kontakts und das Anhängen der Tags bei Ontraport getrennte Endpunkte sind. Der Sync rührt die Felder für Lead-Quelle und Kampagne von Ontraport nie an, die Ankunftsdaten, die die Verkaufsaufgabe liest, bleiben also genau so, wie Ontraport sie geschrieben hat.

Zugangsdaten finden

In Ontraport:

1. Administration → Integrations → Ontraport API Instructions and Key Manager.
2. Kopiere deine App ID und deinen API Key.

Ontraport in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte von Ontraport.
3. Füge beides ein. Klicke auf Verbinden.
4. Rekomi prüft die Zugangsdaten, registriert Kaufereignisse für jedes deiner Produkte und prüft, ob es Kontakte lesen kann. So ist die Statuszeile für Verkäufe sofort ausgefüllt. Produkte, die du später hinzufügst, erkennt eine tägliche Produktprüfung.

Tags

Die „Listen“ von Ontraport in unserer Integrationsoberfläche entsprechen Tags in Ontraport (Ontraport hat keine Listen wie im E-Mail-Marketing, sondern arbeitet mit Tags und Sequenzen). Wähle einen Standard-Tag, die Einstellungen pro Kampagne fügen weitere Tags hinzu. Zusätzliche Tags, die du als numerische IDs eingibst, werden direkt angehängt. Tags, die du per Name eingibst, legt Ontraport automatisch an, falls sie fehlen.

Vermittelte Kunden und Leads (optional)

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

• die Kontaktfelder Rekomi referral link, Rekomi campaign, Rekomi referring affiliate, Rekomi referring affiliate code, Rekomi last event, Rekomi last sale amount, die beim ersten Einsatz in einem Abschnitt Rekomi angelegt werden
• den Tag 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 Affiliates in deine E-Mails einfügen kannst. Der hier geschriebene Empfehlungslink trägt dieselben beiden Tags wie die Links, die Rekomi den 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.

Einstellungen pro Kampagne, Sync-Status pro Affiliate, Fehlerbehebung und Trennen

Alles läuft wie bei den anderen CRM-Anbietern. Beim Trennen werden außerdem die Kaufereignisse und der Webhook für neue Kontakte entfernt, die Rekomi in deinem Ontraport-Konto registriert hat.

Anbieterspezifische Hinweise

• Zwei Header: Api-Appid und Api-Key.
• ignore_blanks: true verhindert, dass gefüllte Felder mit leeren Werten überschrieben werden.
• Schlägt das Anhängen des gewählten Tags fehl, wird der Sync wiederholt (der Upsert des Kontakts lässt sich gefahrlos wiederholen, ein erneuter Lauf erzeugt also keine Duplikate). Nur die zusätzlichen Tags per Name laufen nach dem Best-Effort-Prinzip und lassen den Sync nicht scheitern.
• Rate-Limit: 180 Anfragen pro Minute. Header X-Rate-Limit-Remaining.
• Kaufereignisse und der Webhook für neue Kontakte sind bei Ontraport nicht signiert. Rekomi behandelt jedes Ereignis deshalb nur als Hinweis und liest Kontakt und Transaktion selbst nach, bevor es etwas erfasst.

---

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