mParticle Import (Audience)
Understand how to import audience (segment) from mParticle to CleverTap.
Overview
mParticle, a customer data platform that helps make informed decisions for targeting users. This integration allows you to import audience (segment) from mParticle into CleverTap and provides different benefits described in the below section.
Key Benefits
Here are some of the key benefits of this integration:
- Enhanced Audience Management: Leverage mParticle's product analytics to create a targeted audience (segments) in CleverTap for personalized messaging and engagement campaigns based on user behaviors and preferences captured in mParticle.
- Comprehensive Event Tracking: Capture and analyze user interactions within CleverTap, such as app installs, uninstallations, push notifications, and In-App messages, in mParticle for a holistic view of user engagement across both platforms.
- Data-Driven Decision Making: Make informed decisions and optimize your customer engagement strategies by leveraging the combined insights from CleverTap and mParticle's powerful analytics engines.
- Personalized and Relevant Campaigns: Deliver contextual and personalized messaging to your users based on their behaviors and preferences captured in mParticle, leading to higher engagement and conversion rates.
- Streamlined Workflow: Seamlessly push audience (segments) and system events between CleverTap and mParticle with a simple and intuitive setup, saving you time and effort in managing your marketing campaigns.
Prerequisites to Integration
Before you begin the integration, ensure that you have the following:
- The required permission to create an audience (segments) in the mParticle account.
- The mParticle Audience (segments) mapped correctly to CleverTap Segments.
Setup
This procedure involves the following three major steps:
- Find CleverTap Project Details
- Configure CleverTap as an Audience Output in mParticle
- Import Audience from mParticle
- Map User Identities of mParticle Audience to CleverTap Segments
Find CleverTap Project Details
Find the following project details to authorize the CleverTap integration on the mParticle dashboard:
- Project ID
- Passcode
- Project Token
- Region
Passcode
When generating an account passcode, we recommend you set the expiry date for the passcode as Forever. To find the passcode for your mParticle Import project, refer to Account Passcode.
You can obtain the remaining project details by navigating to the Settings > Project page of the CleverTap dashboard (see figure below):
Project Details
CleverTap suggests keeping the above details handy, as you will need them to configure the mParticle dashboard.
To identify the region for your account, refer to the following table:
Configure CleverTap as an Audience Output in mParticle
To configure CleverTap on the mParticle dashboard:
- Navigate to Setup > Output from the mParticle dashboard.
- Select the Audience tab, click Add Audience Output, and select CleverTap from the dropdown.
The Audience Configuration popup opens.
- Enter the following details and click Save to save the details:
Field | Description |
---|---|
Configuration Name | Enter the name to identify your configuration uniquely. |
Account ID | Enter the Project ID of your CleverTap account. |
Passcode | Enter the Passcode of your CleverTap account. |
Account Token | Enter the Project Token of your CleverTap account. |
Region | Enter the Region of your CleverTap account. |
After configuring the output, it displays under the CleverTap Default of the Outputs page.
Import Audience from mParticle
To import Audience from mParticle to CleverTap output destination:
- Navigate to Audience from the mParticle dashboard and open the audience you want to connect to the output.
- From the Connect tab, click Connect Output.
- Select the configuration you want to set as an Output.
- Select the User ID that you want to set up for mapping the mParticle audience on the CleverTap dashboard. For more information, refer to User Identity Management.
Verify User Identifications
To ensure that the user profiles imported from mParticle are correctly identified in CleverTap, we recommend importing a smaller audience (segment) before proceeding with larger audiences.
Map User Identities of mParticle Audience to CleverTap Segments
CleverTap imports all users from mParticle except the anonymous users. During the import process, CleverTap compares the identifiers set by mParticle for its existing user profiles and maps the relevant user identifiers to CleverTap's user profiles. This ensures that user actions, attributes, and event data associated with a specific user in mParticle are accurately attributed to the corresponding user in CleverTap. To achieve this, a common identifier is used to map users when importing audience (segments) from mParticle to CleverTap.
CleverTap uses the following identities to map the imported audience (segments) from mParticle:
- Partner ID: A unique identifier assigned to every user profile whenever the data is exported from CleverTap to mParticle. This value is available on the mParticle dashboard as
CleverTap_User_ID
in the Partner ID field. - Customer ID: A unique identifier generated by mParticle to individual users within the mParticle ecosystem.
- mParticle ID: A persistent, anonymized identifier assigned to each user in the mParticle system.
- Email: The email address associated with a user.
- Phone Number: The phone number associated with a user.
For more information about mParticle Identity Management, refer to Identify Users.
User Identity Management
When importing audience (segments) from mParticle, the user identity is managed in the following manner:
- If the Partner ID is present in an imported audience from mParticle, it is mapped with the CleverTap ID value in CleverTap. In that case, the Email and Phone Number of the profile are merged with the same profile in CleverTap, and the profile becomes part of the CleverTap segment.
- If the Partner ID is not present in an imported audience from mParticle, the Customer ID value from mParticle is used as an identifier and mapped with the Identity value in CleverTap. In that case, the Email and Phone Number of the profile are merged with the same profile in CleverTap, and the profile becomes part of the CleverTap segment.
- If the Customer ID is also not present in an imported audience from mParticle, the mParticle ID value is used as an identifier and mapped with the Identity value in CleverTap. In that case, the Email and Phone Number of the profile are merged with the same profile in CleverTap, and the profile becomes part of the CleverTap segment.
- If only mParticle ID is present and the rest of the details are not present in the imported audience, then the profile is considered anonymous and does not become part of the CleverTap dashboard.
To understand this better, refer to the following diagram:
View mParticle Audience in CleverTap
The audience name defined in the mParticle dashboard appears as the segment under the Segments list page of the CleverTap dashboard. The Type column under the Segments list page is displayed as Partner - mParticle for the exported audience.
Click the segment to view the statistics for this segment, like any other segment on the CleverTap dashboard.
You can also validate if the user profile is ingested from mParticle by verifying if the Partner Sync event is listed under the User activity details section.
Engage with mParticle Audience on CleverTap
You can also engage with the audience (segments) imported from mParticle by creating different campaigns and journeys. Creating campaigns for the Past Behavior Segment and Live Behavior Segment is the same except where we need to select the segment.
For Past Behavior Campaigns/Journeys
To select the segment:
- From the dashboard, select Campaigns.
- Click + Campaign.
- From the Messaging Channels list, select the messaging channel.
- Click Who and filter the target audience by selecting With user properties > Segments.
- Select the imported user segment from the available list of segments.
Scenario: Customer wants to send an In-App Message campaign to the user from Bangalore city when they launch the mobile application.
In this case, the customer will create an audience (segment) in the mParticle dashboard and initiate a one-time export to CleverTap for engagement activities. On the CleverTap dashboard, the customer will create an In-App campaign for this audience of users.
To create the campaign, the customer will navigate to In-App Campaign and select the segment under the Who segment section in the following way:
- Select App Launched event under As soon as the user does section.
- Select Filter on past behavior and user properties checkbox.
- Select With user properties > Segments and select the segment name from the list.
For Live Campaigns/Journeys
To select the segment:
- From the dashboard, select Campaigns.
- Click + Campaign.
- From the Messaging Channels list, select the messaging channel.
- Click Who and select Partner Sync event from the list.
- Click Filter and then select Event Property Action = Added.
Partner Sync Event
The Partner Sync event is raised every time CleverTap receives an audience sync request from mParticle.
- Filter the target audience by selecting Segments under With User Properties.
- Select the imported user segment from the available list of segments.
Scenario: Customer wants to send a recurring Email campaign to the users who added an item to the cart but did not purchase the item.
In this case, the customer will create an audience (segment) in the mParticle dashboard and initiate a recurring export to CleverTap for engagement activities. On the CleverTap dashboard, the customer will create a recurring Email campaign for this audience of users. To create the campaign, the customer will navigate to Email Campaign and create the campaign in the following way:
- Select Start here > Live Behavior.
- Select the Partner Sync event under the As soon as the user does section.
- Click Filter and then select Event Property Action = Added.
- Select Filter on past behavior and user properties checkbox.
- Select Segments under With user properties and select the segment name from the list.
Find mParticle Audience from CleverTap Dashboard
To find the mParticle audience:
- Navigate to Segments > Find People from the CleverTap dashboard.
- Select the Partner Sync event from the Users who did section.
- Select Segments under Display common properties, such as, and select the segment name from the list.
Partner Sync Event
The Partner Sync event is raised for all the users who are part of different partner segments. The following table provides information about the event properties:
Property Name | Description | Property Value/Example |
---|---|---|
Partner Segment Name | Indicates the name of the audience (segment) exported from mParticle. | For example, Cart Drop off |
Action | Indicates if the user has been added or removed from the segment in the CleverTap dashboard. |
|
Partner Segment ID | Indicates the Audience ID in the mParticle dashboard. | For example, 47444 |
CT Source | Indicates the source of the event. | mParticle |
Partner Name | Indicates the name of the partner from where the segment was imported. | mParticle |
Campaign Exceptions for Partner Sync Event
The Partner Sync event cannot be used as a trigger event to create the campaigns for the following channels as it is not an SDK event:
- In-App Messages
- Web Popup
- Web Exit Intent
- App Inbox
- Native Display
Contribution Towards Billing
The Partner Sync event contributes to data points for MAU Billing Type and as an event for Container Billing Type.
FAQs
Q. Can I export the CleverTap engagement data to mParticle for analysis?
A. Yes. For more information, refer to mParticle Export.
Updated 10 months ago