Iterable

Die Iterable-Integration von Rekomi trägt jeden freigegebenen Affiliate in eine Iterable-Liste ein und schreibt Vor- und Nachname sowie Tags zur Segmentierung in die dataFields des Nutzers.

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /api/lists/subscribe mit diesem Inhalt auf:

{
  "listId": 12345,
  "subscribers": [{
    "email": "...",
    "dataFields": {
      "firstName": "...",
      "lastName": "...",
      "tags": ["Rekomi affiliate"]
    }
  }]
}

Iterable antwortet auch bei teilweisem Fehlschlag mit HTTP 200. Rekomi wertet deshalb den Antwortinhalt aus (successCount, failCount, invalidEmails, failedUpdates): Ist failCount größer als null oder enthalten invalidEmails/failedUpdates Einträge, wird der Sync mit Begründung als Fehlgeschlagen markiert.

API-Schlüssel finden

In Iterable:

1. Integrations → API Keys.
2. Klicke auf Create new API Key. Wähle Server-side (NICHT JS-Web SDK, denn JS-Schlüssel bekommen am Subscribe-Endpunkt ein 401).
3. Kopiere den Schlüssel.

Region

Beide Rechenzentren von Iterable funktionieren: Gib beim Verbinden im Feld Region us für Konten in den USA (api.iterable.com) oder eu für Konten im European Data Center (api.eu.iterable.com) ein. Schlüssel von Iterable gelten nur für ihre Region: Ein EU-Schlüssel funktioniert nicht in der US-Region und umgekehrt.

Iterable in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte von Iterable.
3. Gib deine Region (us oder eu) ein und füge deinen API-Schlüssel ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /api/lists aus.

Tags

Iterable hat keine eigenen Tags. Rekomi schreibt das Tags-Array in dataFields.tags, damit du Segmente mit Regeln wie dataFields.tags contains "Rekomi affiliate" bauen kannst. Beachte, dass ein erneuter Sync das gesamte Array dataFields.tags ersetzt (das Bulk-Update von Iterable überschreibt Array-Felder). Speichere in diesem Feld also keine eigenen Werte.

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 Iterable. Der Abgleich läuft über die E-Mail-Adresse, bestehende Kontakte werden also aktualisiert statt doppelt angelegt. Jeder Eintrag enthält:

• ein Objekt rekomi in den Datenfeldern des Nutzers (rekomi.referral_link, rekomi.campaign, rekomi.referring_affiliate, rekomi.referring_affiliate_code, rekomi.last_event, rekomi.last_sale_amount)
• das Datenfeld rekomi_tags mit Rekomi customer oder Rekomi lead (dein Feld tags bleibt unberührt)
• 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.

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 mit dem Status Approved (freigegeben) werden synchronisiert.
• Optional: Schalte „Bewerber vor der Freigabe einschließen“ ein, um auch Affiliates mit dem Status 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

• iterable_partial_failure: Iterable hat 200 geliefert, im Antwortinhalt aber einen Fehler gemeldet (failCount oder ein Bucket mit fehlgeschlagenen Updates). Den Auszug aus der Antwort findest du im Panel CRM-Sync des Affiliates.
• iterable_invalid_email: Die Prüfung von Iterable hat die E-Mail-Adresse abgelehnt (sie kam in der Liste invalidEmails der Antwort zurück).
• iterable_failed_update:{bucket}: Iterable hat das Update in einem Bucket von failedUpdates gemeldet (der Name des Buckets wird angehängt, z. B. notSignedUp). Prüfe das Panel CRM-Sync des Affiliates und starte das Eintragen erneut.
• 401 mit Server-side-Schlüssel: Prüfe, ob du einen SERVER-SIDE-Schlüssel kopiert hast (keinen JS-Web-SDK-Schlüssel) und ob die Region zu der passt, in der der Schlüssel ausgestellt wurde. Wiederholte Authentifizierungsfehler markieren die Integration mit „Aktion nötig“ und lösen eine E-Mail zum Neuverbinden aus. Nutze nach der Korrektur Alle erneut synchronisieren auf der Kachel Fehlgeschlagen.

Verbindung trennen

Klicke auf der Verbindungsseite von Iterable auf Trennen. Der Integrationseintrag und die Einstellungen pro Kampagne werden gelöscht. Der Sync-Verlauf bleibt erhalten.

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