Direct integration use cases

Last update: June 10, 2021

CREATED FOR:

Developer
User
Admin
Leader

These examples cover 2 common use cases related to a direct integration and the Experience Cloud ID (ECID or MID). This ID is a unique, persistent ID for your site visitors.

TIP

Review and understand the code syntax and variables before diving into the use cases.
For more information about the MID, see Cookies and the Experience Cloud Identity Service.

Use case 1: I have an Experience Cloud ID (MID) but want to pass my visitor IDs and set an authentication state

Use Case Element	Description
Conditions	This use case assumes you: Have a MID for the site visitor. Let's call this ID 1234. Know this visitor by your own unique ID. Let's call this ID 9876. Want to link the MID (1234) to your own, unique ID (9876). (Optional) Want to set an authentication status on this visitor.
Actions	Given these conditions, make a call to the ID service that includes: The MID (1234). Your data provider ID. This is a unique ID assigned to your company. Let's call this ID 4444. Your ID for the visitor (9876). (Optional) A status ID to define the authentication state for this visitor. And, if you happen to have any of the other parameters listed in the direct integration guide (e.g., d_blob or dcs_region, etc.) it's ok to pass those in as well.
Solution and code sample	Format your call to the ID service like this: https://dpm.demdex.net/id?d_mid=1234&d_cid=4444%019876%011&d_ver=2 Note how the sample call contains the: MID: d_mid=1234 MID joined to your unique ID for the visitor: d_mid=1234&d_cid=4444%019876%011 Authentication state ID: ...d_cid=4444%019876%011 (hint: it's that last digit).

Use Case Element

Description

Conditions

This use case assumes you:

Have a MID for the site visitor. Let's call this ID 1234.
Know this visitor by your own unique ID. Let's call this ID 9876.
Want to link the MID (1234) to your own, unique ID (9876).
(Optional) Want to set an authentication status on this visitor.

Actions

Given these conditions, make a call to the ID service that includes:

The MID (1234).
Your data provider ID. This is a unique ID assigned to your company. Let's call this ID 4444.
Your ID for the visitor (9876).
(Optional) A status ID to define the authentication state for this visitor.

And, if you happen to have any of the other parameters listed in the direct integration guide (e.g., d_blob or dcs_region, etc.) it's ok to pass those in as well.

Solution and code sample

Format your call to the ID service like this:

https://dpm.demdex.net/id?d_mid=1234&d_cid=4444%019876%011&d_ver=2

Note how the sample call contains the:

MID: d_mid=1234
MID joined to your unique ID for the visitor: d_mid=1234&d_cid=4444%019876%011
Authentication state ID: ...d_cid=4444%019876%011 (hint: it's that last digit).

Use case 2: I do not have a MID and need to generate one

Use Case Element	Description
Conditions	This use case assumes you: Do not have a MID for the site visitor. Need to request a MID from the ID service. Know your organization ID. Let's call this 5555.
Actions	Given these conditions, make a call to the ID service that includes your Organization ID. And, if you happen to have any of the other parameters listed in the direct integration guide (e.g., d_blob or dcs_region, etc.) it's ok to pass those in as well.
Solution and code sample	Format your call to the ID service like this: https://dpm.demdex.net/id?d_orgid=5555&d_ver=2 Note how the sample call contains your Organization ID, d_orgid=5555. It would return a Experience Cloud ID for this visitor.

Use Case Element

Description

Conditions

This use case assumes you:

Do not have a MID for the site visitor.
Need to request a MID from the ID service.
Know your organization ID. Let's call this 5555.

Actions

Given these conditions, make a call to the ID service that includes your Organization ID.

And, if you happen to have any of the other parameters listed in the direct integration guide (e.g., d_blob or dcs_region, etc.) it's ok to pass those in as well.

Solution and code sample

Format your call to the ID service like this:

https://dpm.demdex.net/id?d_orgid=5555&d_ver=2

Note how the sample call contains your Organization ID, d_orgid=5555. It would return a Experience Cloud ID for this visitor.

Use case 2: I do not have a MID and need to generate one

Connect with Experience League at Summit!

Learn

Documentation

Certifications

Events

Community

Support

Resources

Adobe Account

Adobe

Direct integration use cases

Use case 1: I have an Experience Cloud ID (MID) but want to pass my visitor IDs and set an authentication state

Use case 2: I do not have a MID and need to generate one

Experience Cloud Services

Connect with Experience League at Summit!