Eine Integration der DataEngine über die e-Ident API mit dem Micro_Data-Service der Global Group TDA Germany GmbH ermöglicht es dir, deine vorhandenen Kundendaten um mikrogeografische und soziodemografische Informationen anzureichern.
Um die Integration zu realisieren, benötigst du eine aktuelle Version deiner MARINI DataEngine Instanz und einen Micro_Data-Service-Vertrag mit der Global Group.
Voraussetzungen
Um die Integration umzusetzen, benötigst du im Admin-Bereich folgende Zugriffsrechte:
- Entwickler Werkzeuge
- Externe Services
Über den Micro_Data-Vertrag werden dir gültige Zugangsdaten für den e-Ident-Service der Global Group zur Verfügung gestellt, die du für die Konfiguration benötigst.
Die Integration erfolgt in zwei Schritten:
1. Installation
Der erste Schritt umfasst die Installation deiner neuen Applikation.
- Öffne dafür den Bereich Erweiterungen in der DataEngine. Du findest ihn unter Admin > Entwickler Werkzeuge > Erweiterungen verwalten.
- Installiere dort das Paket „eIdent Integration (Global Group)“, welches du unter den verfügbaren Installierungen des Marini Stores findest.
Nach erfolgreicher Installation steht dir der Service systemweit zur Verfügung.
2. Konfiguration
Nach der erfolgreichen Installation kannst du mit der Konfiguration des externen Services beginnen. Navigiere dafür zu Administration > External Services > eIdent der Global Group und trage dort die erforderlichen Zugangsdaten der Global Group ein:
- URL
- Benutzername
- Passwort
- Client ID
Speichere die Konfiguration. Die Integration ist damit technisch eingerichtet und du kannst sie in Workflows verwenden.
Verwendung im Workflow
Die Datenabfrage erfolgt über einen dedizierten Workflow-Typ innerhalb der DataEngine, den du wie folgt anlegen kannst:
- Erstelle einen neuen Workflow in der DataEngine.
- Definiere den auslösenden Datensatz (z. B. Kontakt, Lead oder ein anderes benutzerdefiniertes 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 Ausführen des Workflows wird eine Anfrage an den e-Ident-Service gesendet. Das Ergebnis wird als JSON-Objekt vollständig in das von dir konfigurierte Zielfeld gespeichert.
Dieses JSON kann anschließend mit der Workflow-Action „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 angegebenen Werte sind von der jeweiligen Micro_Data-Lizenz abhängig und dein Ergebnis kann von unserem Beispiel abweichen – je nachdem, welchen Service-Vertrag du mit der Global Group geschlossen hast.
{
"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 angereicherten e-Ident-Informationen.
Diese Daten stehen sofort für Auswertungen, Segmentierungen oder weitere Automatisierungen zur Verfügung.
Hinweise und Tipps
- Die Qualität und Vollständigkeit der Ergebnisse hängt direkt von der Genauigkeit der übermittelten Adress- und Personendaten ab.
- Wir empfehlen dir, das Ergebnisfeld ausschließlich für e-Ident-JSON-Daten zu verwenden.