Direct integration use cases direct-integration-use-cases
These examples cover 2 common use cases related to a direct integration and the ECID (also called the MID). This ID is a unique, persistent ID for your site visitors.
- Review and understand the code syntax and variables before diving into the use cases.
- For more information about the MID, see Cookies and the Visitor ID Service.
Use case 1: I have an ECID but want to pass my visitor IDs and set an authentication state section-a67d89a343754d1286d03cf08d34b806
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.
Given these conditions, make a call to the Visitor 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.
Format your call to the Visitor 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 section-8e81291f8b684de8b88fae4002ae0029
This use case assumes you:
- Do not have a MID for the site visitor.
- Need to request a MID from the Visitor ID Service.
- Know your IMS org ID. Let's call this 5555.
Given these conditions, make a call to the Visitor ID Service that includes your IMS org 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.
Format your call to the Visitor ID Service like this:
https://dpm.demdex.net/id?d_orgid=5555&d_ver=2
Note how the sample call contains your IMS org ID, d_orgid=5555. It would return an ECID for this visitor.