Die Anbindung der DataEngine über die e-Ident-API stellt die technische Schnittstelle zur Global Group TDA Germany GmbH bereit.
Über diese Schnittstelle kann anschließend der Micro_Data-Service genutzt werden, der deine Kundendaten um mikrogeografische und soziodemografische Merkmale des Datensystems Micro_Data der Global Group TDA Germany GmbH anreichert.
Damit ist e-Ident ausschließlich die technische Verbindung, während der Micro_Data_Service die eigentliche Datenanreicherung der Kundendaten mit Variablen aus dem Datensystem Micro_Data übernimmt.
Um die Integration nutzen zu können, benötigst du eine aktuelle Version deiner MARINI DataEngine-Instanz sowie einen gültigen Micro_Data-Servicevertrag mit der Global Group.
Voraussetzungen
Für die Umsetzung der Integration benötigst du im Admin-Bereich folgende Zugriffsrechte:
- Entwickler Werkzeuge
- Externe Services
Mit Abschluss des Micro_Data-Vertrags erhältst du gültige Zugangsdaten für den e-Ident-Service der Global Group – diese werden ausschließlich für die Einrichtung der Schnittstelle verwendet.
Schritte der Integration
1. Installation der e-Ident-Schnittstelle
Im ersten Schritt installierst du die Applikation, die die API-Anbindung über e-Ident technisch bereitstellt.
- Öffne den Bereich Erweiterungen in der DataEngine unter
Admin > Entwickler Werkzeuge > Erweiterungen verwalten. - Installiere das Paket „eIdent Integration (Global Group)“ aus dem Marini Store.
- Nach erfolgreicher Installation steht die technische Schnittstelle systemweit bereit.
2. Konfiguration des externen Services (e-Ident)
Nach der Installation richtest du die e-Ident-Schnittstelle ein:
- Navigiere zu Administration > External Services > eIdent (Global Group).
- Trage die bereitgestellten Zugangsdaten ein:
URL
Benutzername
Passwort
Client ID - Speichere die Konfiguration.
Damit ist die Schnittstelle e-Ident vollständig eingerichtet und kann in Workflows genutzt werden.
Verwendung im Workflow
Die Datenanreicherung erfolgt über einen speziellen Workflow-Typ, der die e-Ident-Schnittstelle nutzt, um Micro_Data-Ergebnisse abzurufen.
- Erstelle einen neuen Workflow in der DataEngine.
- Definiere den auslösenden Datensatz (z. B. Kontakt, Lead oder ein anderes eigenes Objekt).
- Wähle den Workflow-Typ eIdent – alle Details zur Konfiguration dieser Workflow Action findest du in unserem Help-Center-Beitrag „e-Ident Workflow Action“.
(Grundlegende Informationen zu Workflows findest du im Help-Center.)
Verarbeitung der Ergebnisse
Beim Workflow-Lauf wird über die e-Ident-Schnittstelle eine Anfrage gestellt. Der Micro_Data-Service liefert ein JSON-Objekt zurück, das komplett in deinem definierten Zielfeld gespeichert wird.
Dieses JSON kannst du anschließend z. B. mit der Workflow-Actionn „JSON Path“ weiterverarbeitet werden, um einzelne Werte gezielt in separate Felder zu übernehmen oder es für weitere Automatisierungen zu nutzen.
Beispiel
In unserem Beispiel siehst du ein zurückgegebenes JSON-Object. Die konkreten Werte hängen von deiner Micro_Data-Lizenz und deinem Vertrag mit der Global Group ab, d. h. dein Ergebnis kann von unserem Beispiel abweichen.
{
"ENRICHMENT_RESULT_SET": {
"ENRICHMENT_QUALITY": "0",
"B18_25_H": "0.03674",
"B25_35_H": "0.07371",
"B35_45_H": "0.08012",
"B45_55_H": "0.21033",
"B55_65_H": "0.36189",
"B65UM_H": "0.16946",
"EINKOM_KL": "2",
"HAUSTYP": "1",
"SK_FAM_H": "05",
"SK_KK_IDX": "10"
}
}
Ergebnis
Nach erfolgreichem Workflow-Lauf enthält der Datensatz:
- die ursprünglich bereitgestellten personenbezogenen Daten sowie
- ein strukturiertes JSON mit den angereicherten Micro_Data-Informationen, abgerufen über die e-Ident-Schnittstelle.
Diese Daten können sofort für Auswertungen, Segmentierungen und Automatisierungen verwendet werden.
Hinweise und Tipps
- Die Qualität und Vollständigkeit der Ergebnisse hängt von der Genauigkeit der übermittelten Adress- und Personendaten ab.
- Das Ergebnisfeld sollte ausschließlich für Micro-Data/e-Ident-JSON zu verwenden.
- Möchtest du mehr über Micro_Data-Variablen erfahren? Schau dir den vollständigen Variablenkatalog der Global Group an.