Didomi-mParticle integration for your CMP

How It Works

Thanks to the Didomi-mParticle integration, you will be able to collect consent data and push it to mParticle. At the same time, user consent data will continue streaming to Didomi via the Didomi SDK.

mParticle SDK is initialized → and will automatically initialize the Didomi SDK → the consent notice is then displayed on your website
Once the user provides/updates their consent on the Didomi consent notice, the consent data will be streamed:
- To the Didomi server via the Didomi SDK
- To the mParticle server via the mParticle SDK

Implementation

The Didomi-mParticle integration can be set up in 3 main steps:

1- Add the mParticle SDK

More documentation here: https://docs.mparticle.com/developers/quickstart/web/overview/

Add the mParticle SDK right below the opening <head> in your webpage’s HTML. Don’t forget to replace the API key as indicated in the script.

<script type="text/javascript">

// Configures the SDK. Note the settings below for isDevelopmentMode
// and logLevel.

window.mParticle = {
  config: {
    isDevelopmentMode: true,
    logLevel: "verbose"
  },
};

// Insert your API key below
(function(t){window.mParticle=window.mParticle||{};window.mParticle.EventType={Unknown:0,Navigation:1,Location:2,Search:3,Transaction:4,UserContent:5,UserPreference:6,Social:7,Other:8};window.mParticle.eCommerce={Cart:{}};window.mParticle.Identity={};window.mParticle.config=window.mParticle.config||{};window.mParticle.config.rq=[];window.mParticle.config.snippetVersion=2.3;window.mParticle.ready=function(t){window.mParticle.config.rq.push(t)};var e=["endSession","logError","logBaseEvent","logEvent","logForm","logLink","logPageView","setSessionAttribute","setAppName","setAppVersion","setOptOut","setPosition","startNewSession","startTrackingLocation","stopTrackingLocation"];var o=["setCurrencyCode","logCheckout"];var i=["identify","login","logout","modify"];e.forEach(function(t){window.mParticle[t]=n(t)});o.forEach(function(t){window.mParticle.eCommerce[t]=n(t,"eCommerce")});i.forEach(function(t){window.mParticle.Identity[t]=n(t,"Identity")});function n(e,o){return function(){if(o){e=o+"."+e}var t=Array.prototype.slice.call(arguments);t.unshift(e);window.mParticle.config.rq.push(t)}}var dpId,dpV,config=window.mParticle.config,env=config.isDevelopmentMode?1:0,dbUrl="?env="+env,dataPlan=window.mParticle.config.dataPlan;dataPlan&&(dpId=dataPlan.planId,dpV=dataPlan.planVersion,dpId&&(dpV&&(dpV<1||dpV>1e3)&&(dpV=null),dbUrl+="&plan_id="+dpId+(dpV?"&plan_version="+dpV:"")));var mp=document.createElement("script");mp.type="text/javascript";mp.async=true;mp.src=("https:"==document.location.protocol?"<https://jssdkcdns>":"<http://jssdkcdn>")+".mparticle.com/js/v2/"+t+"/mparticle.js" + dbUrl;var c=document.getElementsByTagName("script")[0];c.parentNode.insertBefore(mp,c)})
("<REPLACE WITH API KEY>");

</script>

2- Add the Didomi SDK

Insert the Didomi SDK right below the mParticle SDK. More documentation on Didomi’s Web SDK can be found in this developer documentation.

3- Enable and Configure the integration in mParticle

Set up the Didomi Integration

Login to your mParticle app
Navigate to Directory → Didomi
Click Setup → this will create your Event output for Didomi.

Configure the Didomi-mParticle connection

Navigate to Connections → connect
Choose your input: JS Web
Click Connect Output
Choose your output: Didomi integration
Select a configuration from the list and click Next:
Connect Didomi-mParticle data transfer: select the mParticle purposes created earlier and map them to their corresponding Didomi purposes. Didomi purposes will be referenced thanks to the purpose SDK ID (from the Didomi console)
Remove mapping for the other types of data (vendors)
Click “Add connection”

PreviousCMP integrations NextDeploy Didomi’s SDK for your Adobe Commerce website

Last updated 7 months ago

How It Works

mParticle SDK is initialized → and will automatically initialize the Didomi SDK → the consent notice is then displayed on your website

Once the user provides/updates their consent on the Didomi consent notice, the consent data will be streamed:

To the Didomi server via the Didomi SDK
To the mParticle server via the mParticle SDK

Implementation

The Didomi-mParticle integration can be set up in 3 main steps:

1- Add the mParticle SDK

Add the mParticle SDK right below the opening <head> in your webpage’s HTML. Don’t forget to replace the API key as indicated in the script.

<script type="text/javascript">

// Configures the SDK. Note the settings below for isDevelopmentMode
// and logLevel.

window.mParticle = {
  config: {
    isDevelopmentMode: true,
    logLevel: "verbose"
  },
};

// Insert your API key below
(function(t){window.mParticle=window.mParticle||{};window.mParticle.EventType={Unknown:0,Navigation:1,Location:2,Search:3,Transaction:4,UserContent:5,UserPreference:6,Social:7,Other:8};window.mParticle.eCommerce={Cart:{}};window.mParticle.Identity={};window.mParticle.config=window.mParticle.config||{};window.mParticle.config.rq=[];window.mParticle.config.snippetVersion=2.3;window.mParticle.ready=function(t){window.mParticle.config.rq.push(t)};var e=["endSession","logError","logBaseEvent","logEvent","logForm","logLink","logPageView","setSessionAttribute","setAppName","setAppVersion","setOptOut","setPosition","startNewSession","startTrackingLocation","stopTrackingLocation"];var o=["setCurrencyCode","logCheckout"];var i=["identify","login","logout","modify"];e.forEach(function(t){window.mParticle[t]=n(t)});o.forEach(function(t){window.mParticle.eCommerce[t]=n(t,"eCommerce")});i.forEach(function(t){window.mParticle.Identity[t]=n(t,"Identity")});function n(e,o){return function(){if(o){e=o+"."+e}var t=Array.prototype.slice.call(arguments);t.unshift(e);window.mParticle.config.rq.push(t)}}var dpId,dpV,config=window.mParticle.config,env=config.isDevelopmentMode?1:0,dbUrl="?env="+env,dataPlan=window.mParticle.config.dataPlan;dataPlan&&(dpId=dataPlan.planId,dpV=dataPlan.planVersion,dpId&&(dpV&&(dpV<1||dpV>1e3)&&(dpV=null),dbUrl+="&plan_id="+dpId+(dpV?"&plan_version="+dpV:"")));var mp=document.createElement("script");mp.type="text/javascript";mp.async=true;mp.src=("https:"==document.location.protocol?"<https://jssdkcdns>":"<http://jssdkcdn>")+".mparticle.com/js/v2/"+t+"/mparticle.js" + dbUrl;var c=document.getElementsByTagName("script")[0];c.parentNode.insertBefore(mp,c)})
("<REPLACE WITH API KEY>");

</script>

2- Add the Didomi SDK

Insert the Didomi SDK right below the mParticle SDK. More documentation on Didomi’s Web SDK can be found in this developer documentation.

3- Enable and Configure the integration in mParticle

Set up the Didomi Integration

Navigate to Directory → Didomi

Click Setup → this will create your Event output for Didomi.

Configure the Didomi-mParticle connection

Navigate to Connections → connect

Choose your input: JS Web

Click Connect Output

Choose your output: Didomi integration

Select a configuration from the list and click Next:

Connect Didomi-mParticle data transfer: select the mParticle purposes created earlier and map them to their corresponding Didomi purposes. Didomi purposes will be referenced thanks to the purpose SDK ID (from the Didomi console)

Remove mapping for the other types of data (vendors)

Click “Add connection”