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.

TIP

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.

recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a