Import mParticle Audiences

The mParticle Customer Data Platform combines real-time data quality and governance protections with AI-powered insights and predictions.

The mParticle integration allows you to sync your mParticle audience with Dynamic Yield in real time. When synced, you can target Dynamic Yield campaigns to users, based on their inclusion in mParticle audiences.

Install the mParticle extension

1. In the Experience OS store, go to mParticle and click Learn More.
2. On the mParticle page, click Install.
   
3. Go to the Audience Hub application.
4. Click on the Extensions tab.
5. In the Extensions tab of Audience Hub, activate the extension.
6. In the Connection Settings: Select the identifier type for this integration. You have two options:
   • Select from the list the main identifier type (CUID) you defined for your Dynamic Yield section. It must be the same identifier type you use in mParticle. This is the same CUID you use in Identification events (such as Login, Signup, Identify User, Newsletter Subscription).
   • Select other to use a custom identifier you defined in mParticle. In Dynamic Yield, this must be defined as a secondary identifier in your section, and it must be used in your identification events as a secondary identifier as well.
     
     » Learn more about CUID and secondary identifiers.
     » Learn more about mParticle identifiers.
7. Click Save. Keep this tab open, as you'll need to copy the identifier, section ID and connection key to your mParticle console.

Configure the Dynamic Yield Output

This is a one-time setup done in mParticle. After completing this step, you will be able to choose which audiences to sync with Dynamic Yield.

1. In the mParticle Directory, search for Dynamic Yield output and then click Set Up.
2. In the configuration dialog, fill in the fields you got from Dynamic Yield (Identifier, Section ID, and Connection Key) as appear in the Experience OS extension.
3. Select the encoding type. Use the same encoding you use in your login, signup, or identify Dynamic Yield events. Email addresses and phone numbers must always use SHA256 hashing. All other types can be used as-is.
4. Save changes.

Choose mParticle audiences to sync

After syncing, go to any audience you'd like to sync and choose the Dynamic Yield output:

1. Go to Audiences and click Connected Outputs for each audience you want to sync with Dynamic Yield.
2. Click Connect Output and connect the Dynamic Yield Output.
3. In Connected Output, make sure the Dynamic Yield Output is connected.

Once chosen, a new audience condition will be added to the Dynamic Yield console, of users who belong to this audience.

Create audiences based on mParticle data

1. In the Audience Hub app, go to Audience Explorer. 
2. Select mParticle Audiences in the dropdown, and then configure targeting conditions based on the data from mParticle.

Troubleshooting 

• Make sure the identifier type (such as MPID or customer ID) and values are identical in both the Dynamic Yield integration settings for the mParticle extension and the output configuration in mParticle.
• Make sure that the identifier type you use in your identification events (Login, Signup, Identify) is the same identifier used in the integration.
• Verify that the users in the mParticle audiences indeed visited the site. If you're not sure, it is recommended to create an audience with all users who visited the site, sync it, and see if users appear in the Audience Explorer.
• Note that Audience Explorer does not include real-time data, only defined past timeframes.
• If you've just now implemented the identifier in your identification events: For users who were never identified on the site, connecting them to their mParticle identity can take up to 24 hours.