Konnektoren
Schemaobjekte
Die SQL- und Dateibrücke
Das OAuth 2.0 Verfahren
Gesperrte Datensätze

KlickTipp Konnektor

Der KlickTipp Konnektor integriert Syncler mit dem Newsletter- und Marketing-Automation-System KlickTipp.
Das System basiert auf einem Tagging-Konzept, bei dem Kontakte über Tags klassifiziert, segmentiert und automatisiert verarbeitet werden.
Über den Konnektor können Kontakte (Subscriber) sowie Tags und deren Verknüpfungen synchronisiert, angelegt oder aktualisiert werden.

Voraussetzungen

Zur Nutzung des Konnektors werden gültige Zugangsdaten (Benutzername und Passwort) für KlickTipp benötigt.
Die Authentifizierung erfolgt über die API und ermöglicht Zugriff auf die registrierten Kontakte und Tag-Daten.

Einrichtung

1. Neues System anlegen

  • Legen Sie in Syncler ein neues System mit dem Typ „KlickTipp“ an.
  • Geben Sie Name und Beschreibung ein.

2. Verbindung konfigurieren

  • Tragen Sie Ihre KlickTipp-Zugangsdaten ein:
    • Benutzername
    • Passwort
  • Speichern Sie das System, um die Verbindung zu testen.

Nach erfolgreicher Anmeldung wird das Schema automatisch geladen.

Schemaobjekte

Der KlickTipp Konnektor stellt verschiedene Schemaobjekte bereit, die die Datenstruktur des Systems abbilden.

Tag

Das Objekt tag bildet die Grundlage für das Tagging-System.
Über Tags können Kontakte segmentiert und für Marketing-Automatisierungen markiert werden.

  • Lesen:
    • Einzelne Tags über ID oder gesamte Tag-Liste abrufen.
    • Filterung über Feldnotation möglich (z. B. Namenssuche).
  • Schreiben:
    • Tags können angelegt oder aktualisiert werden.

Beispiel für Filter in Feldnotation:

tagid|:|1234|;|
name|:|Newsletter|;|

Subscriber

Das Objekt subscriber repräsentiert die Empfänger (Kontakte) eines Newsletters.
Es enthält sowohl Standardfelder als auch benutzerdefinierte Felder.

  • Lesen:
    • Abfrage einzelner Kontakte per ID oder über Filter (z. B. email|:|user@example.com|;|).
    • Zugeordnete Tags sind als Array-Feld lesend verfügbar.
  • Schreiben:
    • Anlage oder Aktualisierung von Kontakten.
    • Über die Objektgruppe addTag können einem Kontakt mehrere Tags zugeordnet werden (erfordert das Feld email in der Gruppe).

Die Array-Felder enthalten IDs oder ID/Datum-Kombinationen, wobei das Datum als Unix-Timestamp vorliegt.

TagSubscriber

Das Objekt tagsubscriber dient zur Markierung bestehender Kontakte mit bestimmten Tags.

  • Schreiben:
    • Es müssen die Felder email und tagIds übergeben werden.
    • Unterstützt mehrere Tag-Zuweisungen in einem Schritt.

TaggedSubscriber

Das Objekt taggedsubscriber wird für das Auslesen von Tag-Verknüpfungen verwendet.

  • Lesen:
    • Übergabe einer ID oder eines Filters (interpretiert als Tag-ID).
    • Ergebnis: Liste mit subscriberId, tagId und dem Zeitpunkt der Verknüpfung (Datum als Unix-Timestamp).