External Data Service Micro_Data (e-Ident)

An integration of the DataEngine via the e-Ident API with the Micro_Data service of Global Group TDA Germany GmbH enables you to enrich your existing customer data with micro-geographic and socio-demographic information.

To implement the integration, you require a current version of your MARINI DataEngine instance and a Micro_Data service contract with Global Group.

Prerequisites

To implement the integration, you need the following access rights in the admin area:

• Application Loader
• External Services

Through the Micro_Data contract, you will receive valid access credentials for the Global Group e-Ident service, which are required for configuration.

The integration is carried out in two steps:

1. Installation

The first step involves installing your new application.

• Open the Application Loader in the DataEngine. You can find it under Administration > Developer Tools > Application Loader.
• Install the package “eIdent Integration (Global Group)“, which is available in the Marini Store under the list of available packages.

After successful installation, the service will be available system-wide.

2. Configuration

After successful installation, you can begin with the configuration of the external service. Navigate to Administration > External Services > eIdent by Global Group and enter the required Global Group access credentials:

• URL
• Username
• Password
• Client ID

Save the configuration. The integration is now technically set up and can be used in workflows.

Usage in Workflows

Data retrieval is performed via a dedicated workflow type within the DataEngine, which you can create as follows:

• Create a new workflow in the DataEngine.
• Define the workflow module (e.g. contact, lead, or another custom object).
• Select the workflow action type for e-Ident – complete details on how to configure this workflow action are covered in our Help Center article e-Ident WorkFlow Action.

(Check the Help Center for basic details on workflow functionality.)

Result Processing

When the workflow is executed, a request is sent to the eIdent service. The result is stored in full as a JSON object in the target field you configured.
This JSON can then be further processed using the “JSON Path” workflow action in order to extract individual values into separate fields or use them for additional automations.

Example

In this example, you can see a returned JSON object. The values shown depend on the respective Micro_Data license, and your result may differ from this example depending on the service contract you have concluded with Global Group.

{
  "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"
  }
}

Result

After a successful workflow run, the record contains:

• the originally provided personal data,
• as well as a structured JSON containing enriched e-Ident information.

This data is immediately available for analysis, segmentation, or further automation.

Notes and tips

• The quality and completeness of the results depend directly on the accuracy of the transmitted address and personal data.
• We recommend using the result field exclusively for e-Ident JSON data.