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.

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now