Customer.io

Die Customer.io-Integration von Rekomi identifiziert jeden freigegebenen Affiliate in deinem Customer.io-Workspace (legt ihn an oder aktualisiert ihn). Customer.io arbeitet kontoweit ohne Listenauswahl; segmentiert wird über die Segmentregeln von Customer.io.

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi PUT /api/v1/customers/{url-encoded-email} auf track.customer.io auf (oder auf track-eu.customer.io bei Workspaces in der EU), mit:

• email
• first_name
• last_name
• created_at (Unix-Zeitstempel)
• rekomi_tags (kommagetrennte Tag-Namen, mit Präfix, damit sie nicht mit reservierten Namen kollidieren)

Der Endpunkt lässt sich gefahrlos wiederholen: Eine erneute Synchronisierung desselben Affiliates aktualisiert den bestehenden Kunden, ohne ein Duplikat anzulegen.

Umgang mit Regionen

Customer.io hat Rechenzentren in den USA und in der EU. Rekomi prüft zuerst die US-Region; liegt dein Workspace in der EU, wechselt der Testaufruf automatisch dorthin. In Rekomi musst du keine Region einstellen.

Zugangsdaten finden

In Customer.io:

1. Account Settings → API Credentials → Track API Keys (URL: https://fly.customer.io/settings/api_credentials).
2. Kopiere die Site ID und den Track API Key des Workspace, in den Rekomi synchronisieren soll.

Achte darauf, den Track API Key zu kopieren, nicht den App API Key. Rekomi nutzt die Track API, um Kunden zu identifizieren, nicht die App API für den Versand von Nachrichten.

Customer.io in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte Customer.io.
3. Füge deine Site ID und den Track API Key ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /api/v1/accounts/region aus.

Tags über eigene Attribute

Customer.io hat keine eigenen Tags. Rekomi speichert die Tags des Affiliates als kommagetrennten Text in einem eigenen Attribut namens rekomi_tags. Um das für die Segmentierung zu nutzen, legst du in Customer.io ein Segment mit einer Regel wie dieser an:

rekomi_tags contains "Rekomi affiliate"

Der System-Tag Rekomi affiliate wird immer gesetzt.

Vermittelte Kunden und Leads (optional)

Schalte auf der Integrationsseite Vermittelte Kunden und Leads synchronisieren ein, dann schreibt Rekomi jeden Verkauf und jeden Lead, den es einem Affiliate zuordnet, auch nach Customer.io. Der Abgleich läuft über die E-Mail-Adresse, bestehende Kontakte werden also aktualisiert statt doppelt angelegt. Jeder Eintrag enthält:

• die Personenattribute rekomi_referral_link, rekomi_campaign, rekomi_referring_affiliate, rekomi_referring_affiliate_code, rekomi_last_event und rekomi_last_sale_amount
• die Attribute rekomi_customer: true oder rekomi_lead: true, dazu ein Ereignis rekomi_sale oder rekomi_lead, mit dem du Kampagnen auslösen kannst
• 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.

Erstattete, abgelehnte und wegen Betrugsverdacht in Quarantäne gestellte Conversions werden nie übertragen, importierte historische Conversions werden übersprungen. Die Option ist standardmäßig ausgeschaltet.

Wann synchronisiert wird

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

Einstellungen pro Kampagne

Jede Kampagne kann die Konfiguration auf Kontoebene überschreiben. Öffne auf der Detailseite einer Kampagne die Kampagneneinstellungen und nutze den Abschnitt CRM-Sync, um kampagnenspezifische Tags zu ergänzen oder Customer.io für diese Kampagne zu deaktivieren.

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

• 401 in den USA und in der EU: Die Zugangsdaten sind ungültig. Kopiere sie noch einmal von der Seite API Credentials in Customer.io und verbinde neu. Wiederholte Fehler bei der Authentifizierung markieren die Integration mit „Aktion nötig“ und lösen pro Störung einmal eine E-Mail mit der Bitte aus, neu zu verbinden; nutze nach dem erneuten Verbinden auf der Kachel Fehlgeschlagen der Integrationsseite Alle erneut synchronisieren.
• Der Kunde erscheint nicht in deinem Workspace: Kunden in Customer.io gehören immer zu einem Workspace. Prüfe, ob du Site ID und API-Schlüssel aus DEMSELBEN Workspace kopiert hast, in dem du den Kunden erwartest.
• Warnungen zu reservierten Attributen in Customer.io: Rekomi nutzt beim Tag-Attribut das Präfix rekomi_, damit es nie mit reservierten Namen von Customer.io kollidiert (email, id, created_at, cio_id).

Trennen

Klicke auf der Verbindungsseite von Customer.io auf Trennen. Der Integrationseintrag und die Einstellungen pro Kampagne werden gelöscht. Der bisherige Sync-Verlauf bleibt für Prüfzwecke erhalten.

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