External Data Service Micro_Data (e-Ident)

The integration of the DataEngine via the e-Ident API provides the technical interface to Global Group TDA Germany GmbH.
This interface enables the use of the Micro_Data Service, which enriches your customer data with microgeographical and sociodemographic attributes from the Micro_Data data system of Global Group TDA Germany GmbH.

Accordingly, e-Ident serves exclusively as the technical connection, while the Micro_Data_Service performs the actual enrichment of customer data with variables from the Micro_Data data system.

To use the integration, you require a current version of your MARINI DataEngine instance as well as a valid Micro_Data service agreement with Global Group.

To implement the integration, you require the following access rights in the Admin area:

• Developer Tools
• External Services

Upon conclusion of the Micro_Data agreement, you will receive valid credentials for the e-Ident Service from Global Group – these are used exclusively to configure the interface.

1. Installation of the e-Ident Interface

In the first step, install the application that technically provides the API connection via e-Ident.

1. Open the Extensions section in the DataEngine under
   Admin > Developer Tools > Manage Extensions.
2. Install the package “eIdent Integration (Global Group)” from the Marini Store.
3. After successful installation, the technical interface is available system-wide.

2. Configuration of the External Service (e-Ident)

After installation, configure the e-Ident interface:

1. Navigate to Administration > External Services > eIdent (Global Group).
2. Enter the provided credentials:
   URL
   Username
   Password
   Client ID
3. Save the configuration.

The e-Ident interface is now fully set up and can be used within workflows.

Data enrichment is executed via a dedicated workflow type that uses the e-Ident interface to retrieve Micro_Data results.

• Create a new workflow in the DataEngine.
• Define the triggering record (e.g., contact, lead, or another custom object).
• Select the eIdent workflow type – all configuration details for this Workflow Action can be found in our Help Center article “e-Ident Workflow Action”.

(General information about workflows is available in the Help Center.)

During workflow execution, a request is sent via the e-Ident interface. The Micro_Data Service returns a JSON object, which is stored in full in your defined target field.

This JSON can subsequently be processed further, for example using the Workflow Action “JSON Path”, to extract individual values into separate fields or to use it for additional automations.

Example

In our example, you can see a returned JSON object. The specific values depend on your Micro_Data license and your agreement with Global Group, meaning your results may differ from our example.

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

After successful workflow execution, the record contains:

• the originally provided personal data, as well as
• a structured JSON file containing the enriched Micro_Data information retrieved via the e-Ident interface.

This data can be used immediately for analytics, segmentation, and automation purposes.

• The quality and completeness of the results depend on the accuracy of the transmitted address and personal data.
• The result field should be used exclusively for Micro_Data/e-Ident JSON data.
• Would you like to learn more about Micro_Data variables? Review the complete variable catalog from Global Group.