Systeme

Maileon Konnektor

Der Maileon Konnektor stellt die Schnittstelle zwischen Maileon und Syncler dar.
Die Anbindung erfolgt über die offizielle REST API von Maileon und ermöglicht den Austausch von Kontakten, Verteilerlisten, benutzerdefinierten Feldern und Reports.

Zusätzlich wird ein dynamisches Datenschema erzeugt, das automatisch um angelegte Felder erweitert wird.
Für Integrationen mit anderen Systemen können Universal Syncs verwendet werden.

Voraussetzungen

Um den Konnektor nutzen zu können, wird ein gültiger API-Key aus dem Maileon-Portal benötigt.

Melden Sie sich bei Maileon an.
Öffnen Sie den Bereich Einstellungen → Konto → API-Keys.
Lesen Sie einen bestehenden API-Key aus oder legen Sie einen neuen an.
Tragen Sie den API-Key in den Systemeinstellungen des Konnektors ein.

Einrichtung

1. Neues System anlegen

Legen Sie in Syncler ein neues System mit dem Konnektor „Maileon“ an.

2. API-Key hinterlegen

Geben Sie den ermittelten API-Key ein.
Speichern Sie das System, um die Verbindung zu testen.

Nach erfolgreicher Einrichtung lädt Syncler das Schema und ermittelt automatisch die verfügbaren Datenobjekte und benutzerdefinierten Felder.

Objekte

Der Maileon Konnektor stellt mehrere Schemaobjekte bereit, die über Syncs gelesen oder beschrieben werden können.

Kontakt (`contact`)

Lesen, Anlegen, Aktualisieren oder Löschen von Kontakten.
Benutzerdefinierte Felder sind im Abschnitt custom_fields enthalten.
Das Löschen erfordert einen Lösch-Sync.

Unterstützte Felder (Auszug):

Feld	Verwendung	Beschreibung
`src`	Insert/Update	Beschreibt die Quelle des Kontakts.
`subscription_page`	Insert	Kennzeichnet die Anmeldeseite (für Reporting).
`doi`	Insert	Startet den Double-Opt-In-Prozess (`true`/`false`).
`doiplus`	Insert	Erweiterter DOI mit Tracking (Öffnungen/Klicks).
`triggerdoi`	Update	Startet DOI-Prozess, wenn `true` gesetzt ist.
`doimailing`	Insert/Update	Referenz auf das zu verwendende DOI-Mailing.

Filtern und Suchen

Nach E-Mail-Adresse:
emails|:|info@domain.de|;|
Nach externer ID:
externalid|:|ext_id|;|
Nach Kontaktfilter-ID:
contactfilterid|:|1234|;|

Benutzerdefiniertes Feld (`customfield`)

Dient zur Anlage oder Umbenennung von benutzerdefinierten Feldern.
Lesen wird nicht unterstützt (liefert immer leeres Ergebnis).

Feld	Beschreibung
`name`	Neuer Name des Feldes
`oldname`	Aktueller Name (bei Umbenennung erforderlich)
`type`	Datentyp (`string`, `integer`, `float`, `date`, `boolean`)

Nach erfolgreichem Schreiben wird das Schema automatisch aktualisiert.

Kontaktfilter (`contactfilter`)

Lesen und Aktualisieren möglich.
Anlage nur indirekt über Verteilerlisten.
Löschung erfordert einen Lösch-Sync.

Sonderfeld:

Feld	Beschreibung
`refresh_contacts`	`true` löst eine Aktualisierung der Kontakte im Filter aus (alle 10 Minuten möglich).

Filtern:
Filterung über Namen oder ID des Kontaktfilters.

Verteilerliste (`targetgroup`)

Lesen und Anlegen unterstützt.
Aktualisieren nicht möglich.
Löschung über Lösch-Sync.

Optionen zur Anlage:

Feld	Beschreibung
`contact_filter_name`	Verknüpft Verteilerliste mit bestehendem Kontaktfilter (per Name).
`contact_filter_id`	Verknüpft Verteilerliste mit bestehendem Kontaktfilter (per ID).
`create_contact_filter`	Erstellt automatisch neuen Kontaktfilter.
`contact_filter_fieldname`	Definiert das Feld für den Kontaktfilter.

Hinweis: Wird create_contact_filter verwendet, erhält die Verteilerliste den Feldnamen als Namen, der später nicht geändert werden kann.

Berichte

Über diese Objekte können Mailings und deren Ergebnisse abgerufen werden.
Folgende Objekte stehen zur Verfügung:

open, unique_open
bounce, unique_bounce
click, unique_click
block
unsubscription
subscriber
recipient

Eigenschaften:

Nur Lesen von Listen (keine Einzelabfragen oder Schreibvorgänge).
Jeder Bericht enthält:
- Das zugehörige Kontaktobjekt.
- Den Namen des Mailings (mailing_name).

Filterparameter (werden an URL angehängt):

mailing_id
from_date (automatisch angefügt)
to_date
standard_field