GetResponse

Die GetResponse-Integration von Rekomi fügt jeden freigegebenen Affiliate zu einer GetResponse-Kampagne hinzu (so nennt GetResponse eine Mailingliste).

Was diese Verbindung kann und was nicht. Sie synchronisiert Affiliates nach GetResponse. Verkäufe erfasst sie nicht, auch nicht solche über Landingpages oder den Shop von GetResponse. Um Affiliates dafür Verkäufe gutzuschreiben, verbinde den Zahlungsanbieter dahinter unter Einrichtung und installiere das Rekomi-Skript dort, wo Affiliate-Links landen (siehe die Installationsanleitungen).

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /v3/contacts mit email, einem zusammengesetzten name, der Kampagnen-ID und einem Array der aufgelösten Tag-IDs auf.

GetResponse antwortet mit 202 Accepted, sobald der Kontakt in der Warteschlange steht. Bei Kampagnen mit Single-Opt-in (der Standard im Affiliate-Marketing) landet der Kontakt sofort. Kampagnen mit Double-Opt-in warten, bis der Affiliate in einer Bestätigungs-E-Mail klickt. Ein erneuter Sync einer bestehenden E-Mail-Adresse liefert 409 mit dem Code 1008, Rekomi wertet das als Erfolg.

API-Schlüssel finden

In GetResponse:

1. Öffne https://app.getresponse.com/api
2. Klicke auf Generate API Key und gib ihm den Namen „Rekomi“.
3. Kopiere den Schlüssel.

Wichtig: GetResponse lässt API-Schlüssel nach 90 Tagen ohne Nutzung stillschweigend ablaufen. Wenn dein Sync von Rekomi → GetResponse nach einer längeren Pause nicht mehr läuft, erzeuge den Schlüssel neu und verbinde neu.

GetResponse in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte von GetResponse.
3. Füge deinen API-Schlüssel ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /v3/accounts aus.
5. Wähle eine Standardkampagne.

Du nutzt GetResponse 360 / MAX? Normale GetResponse-Konten können die beiden zusätzlichen Felder leer lassen. Enterprise-Marken auf 360/MAX laufen in einem eigenen Rechenzentrum und müssen sie ausfüllen: Setze API domain (360 / MAX only) auf api3.getresponse360.com (oder api3.getresponse360.pl für die Region Polen) und Account domain (360 / MAX only) auf die Panel-Domain aus den Kontoeinstellungen deines GetResponse 360. Rekomi sendet diese Konto-Domain bei jedem Aufruf im vorgeschriebenen Header X-Domain.

Tags

Tag-Namen in GetResponse müssen zu ^[_a-zA-Z0-9]{2,64}$ passen: nur Buchstaben, Ziffern und Unterstriche, 2 bis 64 Zeichen. Rekomi normalisiert deine Tag-Namen auf diese Regel, statt sie zu verwerfen: Leerzeichen und Bindestriche werden zu Unterstrichen, aus Rekomi affiliate wird in GetResponse also Rekomi_affiliate. Namen, die auch danach nicht passen (zu kurz, zu lang oder mit anderen unzulässigen Zeichen), werden übersprungen.

Jeder normalisierte Tag wird über GET /tags?query[name]= (exakte Übereinstimmung) aufgelöst. Fehlt er, legt Rekomi ihn über POST /tags an. Die aufgelösten Tag-IDs gehen direkt im Aufruf zum Eintragen mit. Existiert der Kontakt schon (der Duplikatfall 409/1008), sucht Rekomi ihn über die E-Mail-Adresse und hängt die Tags stattdessen an den bestehenden Kontakt, nach dem Best-Effort-Prinzip.

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

• die benutzerdefinierten Felder rekomi_referral_link, rekomi_campaign, rekomi_referring_affiliate, rekomi_referring_affiliate_code, rekomi_last_event, rekomi_last_sale_amount, die beim ersten Einsatz 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.

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

• 401 Unauthorized: Der API-Schlüssel ist ungültig ODER abgelaufen (90 Tage ohne Nutzung). Erzeuge ihn neu und verbinde neu. Rekomi markiert die Integration außerdem mit „Aktion nötig“ und schickt dir pro Störung einmal eine E-Mail zum Neuverbinden. Nutze nach dem Neuverbinden Alle erneut synchronisieren auf der Kachel Fehlgeschlagen der Integrationsseite.
• http_409 ... 1008: Wird als Erfolg gewertet (Idempotenz bei doppelten Kontakten).
• 429: GetResponse drosselt bei 80 Anfragen pro Sekunde und 30000 pro 10 Minuten. Rekomi hält sich an X-RateLimit-Reset (Sekunden bis zum Zurücksetzen), wenn der Header mitkommt.
• Kontakt in der Warteschlange, aber nicht sichtbar: Ein 202 von GetResponse kann heißen, dass ein Single-Opt-in noch in der Warteschlange steht oder ein Double-Opt-in auf Bestätigung wartet. Prüfe die Bestätigungseinstellungen der Kampagne.

Verbindung trennen

Klicke auf der Verbindungsseite von GetResponse 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 GetResponse-Integration auf der Website.