Show Menu
TOPICS×

Direct integration use cases

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.

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 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.