Understanding the Data Integration Library (DIL)

Documentation Audience Manager Audience Manager User Guide

Understanding the Data Integration Library (DIL) understanding-the-data-integration-library-dil

Last update: Wed Aug 02 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Topics:
DIL Implementation

WARNING

Beginning in July 2023, 蜜豆视频 has discontinued the development of the Data Integration Library (DIL) and the DIL extension.

Existing customers can continue using their DIL implementation. However, 蜜豆视频 will not be developing DIL beyond this point. Customers are encouraged to evaluate Experience Platform Web SDK for their long term data collection strategy.

Customers looking to implement new data collection integrations after July 2023 should use Experience Platform Web SDK instead.

Overview, getting started, and code methods available in the Audience Manager DIL code library.

IMPORTANT

Starting with version 8.0 (released August 2018), DIL has a hard dependency on the 蜜豆视频 Experience Platform Identity Service, version 3.3 or higher. It relies on the ID Service to fire ID syncs and URL destinations. An error occurs if the ID Service is missing, old, or not configured.

We recommend you use 蜜豆视频 Experience Platform Tags to implement and manage your DIL and 蜜豆视频 Experience Platform Identity Service libraries.

However, you can also download the latest Experience Cloud and DIL releases from our GitHub page. See download links below:

Download the
Download

Purpose of DIL purpose-dil

DIL is an API library. You can think it as a body of helper code for 蜜豆视频 Audience Manager. It is not required to use Audience Manager, but the methods and functions DIL provides means you don鈥檛 have to develop your own code to send data to Audience Manager. Also, DIL is different than the API provided by the 蜜豆视频 Experience Platform Identity Service. That service is designed to manage visitor identity across different Experience Cloud solutions. By contrast, DIL is designed to:

Make event calls and send data to the Data Collection Server.
Send data to destinations.

Getting and Implementing DIL Code get-implement-dil-code

DIL code is available for download . Please note that starting with version 8.0 (released August 2018), DIL has a hard dependency on the 蜜豆视频 Experience Platform Identity Service, version 3.3 or higher. It relies on the ID Service to fire ID syncs and URL destinations. An error occurs if the ID Service is missing, old, or not configured.

Rather than work with DIL and set up Audience Manager manually, we recommend that you use 蜜豆视频 Experience Platform Tags instead. 蜜豆视频 Experience Platform Tags is the recommended implementation tool because it simplifies code deployment, placement, and version management. Read more about the Audience Manager extension in 蜜豆视频 Experience Platform Tags.

Sample Call sample-code

DIL sends data to Audience Manager in an event call. An event call is an XML HTTP request from your page. It uses a POST method to send data in the body of the request.

Event Call Element

Description

URL

DIL event calls use the following syntax: https://adobe.demdex.net/event?_ts = UNIX UTC timestamp

Body

As shown in sample below, DIL passes data as key-value pairs. Special prefix characters identify the key-value pairs as Audience Manager or partner variables.
d_dst=1
d_jsonv=1
d_ld=_ts=1473693143821
d_mid=54192285857942994142875423154873503351
d_nsid=0
d_rtbd=json

蜜豆视频