Maropost

Die Maropost-Integration von Rekomi legt jeden freigegebenen Affiliate über die Contacts API von Maropost an oder aktualisiert ihn (Upsert).

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /accounts/{accountId}/contacts.json mit contact: { email, first_name, last_name, options: { subscribe_list_ids: "{listId}" }, add_tags: [...] } auf. Der Endpunkt arbeitet als Upsert über die E-Mail-Adresse.

Zugangsdaten finden

In Maropost:

1. Account Settings → API. Kopiere deinen Auth Token.
2. Deine Account ID steht in der Dashboard-URL. Die ID bestimmt auch automatisch deine API-Region: EU-Konten liegen bei 4000 bis 4999, CA-Konten ab 5000. Rekomi leitet anhand der ID an den richtigen regionalen Host weiter, eine Regionseinstellung brauchst du nicht.

Maropost in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte Maropost Marketing Cloud (Maropost Commerce Cloud ist ein eigenes Produkt).
3. Füge beides ein. Klicke auf Verbinden.

Tags

Voll unterstützt. add_tags ist ein Array mit Tag-Namen und enthält immer den System-Tag Rekomi affiliate plus alle Standard-Tags, die du konfigurierst, und zusätzliche Tags pro Kampagne. Die Tags müssen in deinem Maropost-Konto schon existieren, Maropost legt sie nicht an. Fehlt ein Tag, lehnt Maropost die Anfrage ab, und Rekomi versucht es einmal ohne Tags, damit wenigstens das Eintragen klappt (die fehlenden Tags werden verworfen und protokolliert). Lege deine Tags in Maropost an, bevor du sie in Rekomi konfigurierst.

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 Maropost. 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 (wird für dich angelegt, falls er fehlt)
• 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.

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

Alles läuft wie bei den anderen CRM-Anbietern.

Anbieterspezifische Hinweise

• Authentifizierung über den Header authorization: ApiKey {token} (der Token steht nie in der URL).
• Die regionale Basis-URL ergibt sich aus der Account ID (unter 4000 = US, 4000 bis 4999 = EU, 5000+ = CA).
• subscribe_list_ids ist ein KOMMAGETRENNTER STRING, kein JSON-Array (eine Eigenheit von Maropost).
• Add_tags IST ein echtes JSON-Array, die Tag-Namen müssen aber im Konto schon existieren.
• Kein öffentliches Rate-Limit dokumentiert; bei 429 hält sich Rekomi an Retry-After.

---

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