mParticle & AB Tasty
mParticle is a Customer Data Platform (CDP) that streamlines the collection, integration, and distribution of data from various channels such as mobile apps, websites, and IoT devices.
The mParticle integration allows you to receive the audiences created in the mParticle dashboard and to target them with AB Tasty.
A segment in mParticle is any subset of users based on a particular criterion defined by you.
For further information on how to use audiences, please refer to the mParticle documentation.
The mParticle integration allows you to receive the audiences collected in mParticle and to use them to create segments within AB Tasty. Thus, the mParticle integration process is a process taking place on both interfaces.
Integration
Requirements
To make sure the integration runs without any problem, you must have mParticle integrated into your website.
On the console (on the browser), you can check with the following commands:
window.mParticle
window.mParticle?.Identity?.getCurrentUser?.()?.getMPID?.()
If you don’t have any response, please contact mParticle. It probably means that you don’t have mParticle on your website so the pull integration can’t run.
Enabling the integration on AB Tasty
To enable the integration on AB Tasty, follow the steps below:
- Access Integrations > Integration Hub > Pull.
- Search for and select mParticle.
- Click Setup connector.
- Give a name to your connector so you can easily retrieve it.
- Click Save and create connector.
mParticle is set up. No other action is required here. This will allow AB Tasty to display the audiences that will be sent by mParticle.
Copying the AB tasty API key
- Access Integrations > API key
- Generate an API Key
- Copy this new API Key (for later)
Enabling the integration on mParticle
To enable integration on mParticle, follow the steps below:
- From the Directory catalog page in the mParticle App, Search for “AB Tasty” and select the AB Tasty destination.
- When hovering over the corresponding card, click on “setup”
- Choose which Source should send data to the AB Tasty destination. (audience)
- A new modal is displayed. Enter :
- A configuration name
- Paste the API generated inside the AB tasty dashboard
An integration API key is a unique key that allows a third-party tool to communicate with your specific AB Tasty account i.e., send data to your account.
Technical specification
mParticle sends the audiences in real-time, i.e. AB Tasty will receive data each time a new audience is created.
First, an AudienceSubscriptionRequest is sent to AB tasty. It’s not linked to a single user but only to give the information to AB tasty that a new audience is now connected
Secondly, mParticle pushes an AudienceMembershipChangeRequest. When a user enters in an Audience or is removed from it, data is sent to AB tasty with a mParticle userID. Thanks to this ID, we are able to recognize which user belongs to which audience.
Configuration
Once you have activated and configured an integration, you can retrieve mParticle audiences in the segment builder (available when you create a new segment).
Audiences or traits generated by your integrations are all to be found under the criteria group EXTERNAL DATA.
For each integration, you will have a corresponding item that you can drag and drop to use.
For global information on how to build a targeting segment, please refer to our targeting guide.
For an audience to be available in the segment builder it must not be empty, meaning that we have to identify at least one user belonging to that audience. Once a user is identified, the audience will appear in the segment builder.