mParticle Export
Customer Data Platform
Overview
mParticle is a customer data platform that manages data quality and drives better customer interactions. Integrating CleverTap with mParticle allows you to export your CleverTap event data to your mParticle dashboard. You can use this event data for further analysis.
Integrate mParticle with CleverTap
This process involves the following two steps:
Find mParticle Project Details
To find your project details:
- Log in to your mParticle account.
- Navigate to Setup > Inputs > Feeds.
- Click Add Feed Input and select CleverTap from the dropdown list. The Input: Feed Configuration popup opens.
- Enter the Configuration Name and turn ON the Feed Status toggle.
- Click Save. The Server to Server Key and Server to Server Secret are displayed.
- Copy the project details. You will need them when configuring the CleverTap dashboard.
Configure CleverTap Dashboard
To configure the CleverTap dashboard:
- Log in to your CleverTap account and navigate to the Settings > Partners > Partner List page. Select mParticle from the list.
- A popup opens on the right side of the screen. Enter the following details and click Integrate.
Field | Description |
---|---|
Partner Nickname | Enter the Nickname for your integration. |
API key and API secret | These are the unique codes passed to mParticle to verify your credentials. For more information about obtaining the key, refer to Find mParticle Project Details. |
Customer ID Mapping | This is used as an identifier when sending event data to mParticle. |
After successful integration, navigate to the the Export tab on the Partner List page.
Create New Export
To create a new export:
- Navigate to Settings > Partners > Exports from the CleverTap dashboard.
- Click Create Export and select mParticle.
The Export to mParticle pop-up displays.
- Configure the following settings:
- Partner Nickname: Nickname for the partner. To edit the nickname, go to Partner List.
- DATA TYPE & IDENTIFIER PRIORITY: Select the type of data that you want to export from the available options. For more information, refer to Export Details.
- FREQUENCY: Select from one of the following options:
- One time: A single export for the selected export type. You can export data up to the last 60 days. You create an export for a specific day, date range, previous month, current month, and more.
- Recurring: Set up a recurring frequency to export all the new events/user properties captured in the last window. You can export event data as frequently as every 4 hours and up to once every 24 hours. You can export user properties only once every 24 hours.
- Date to export data: The export starts at 12:00 a.m. on the specified date by default.
- Click Export. The popup closes, and the following message displays at the top of the Exports page:
CleverTap processes the export, and you can now see the newly created export for mParticle.
The status for each export is displayed as PENDING as soon as the export is created. The status changes to RUNNING after the processing starts. It changes to DONE when the export is complete.
Stop Export
You can also stop the export that you have created. Hover over the export. Click the Stop button for the export request you want to stop.
The Stop export? window appears. Click Stop to confirm your action.
You are navigated back to the Exports page, and the mParticle data export stopped message displays at the top. The status for the data export now displays as STOPPED.
Edit an Export
You might need to modify an export to meet specific business requirements or while waiting for the next run. This section describes editing a Recurring export in the RUNNING and PENDING (awaiting next run) state.
Points to Remember
- In the case of running exports, the new changes will apply to the next run.
- You cannot edit a One-time export, regardless its status (RUNNING, PENDING, DONE, or STOPPED).
- You cannot change the export from User Profile to Event and vice-versa.
- You cannot modify exports marked as DONE or STOPPED.
To edit an export:
- On the CleverTap dashboard, go to Partners > Exports.
- Hover over the required export. The View, Edit, and the Stop buttons appear.
- Click the Edit button. The Export to mPartcile section appears.
- Edit the export details and click Update export.
Filter Exports
This section describes the different ways you can filter exports.
Filter by Export Details
To filter by export details:
- Click the Filter button at the top right corner.
- You can filter exports by Partner, Type, Format, Status, or Frequency.
- To clear the filter, click Reset all.
Filter Exports by Date Range
You can also filter the exports based on the export date.
To filter exports by export date range:
- Click the Filter button at the top right corner.
- Click the Exported on button.
The Calendar widget appears.
- Choose the custom date range and click Apply.
The exports are filtered accordingly.
Filter Exports by Pagination
To choose how many export items you view per page:
- Use the Items per page drop-down at the bottom of the Exports page.
- Options include 10, 20, 30, or 40. By default, the Exports page shows 20 exports.
Export Details
Select from one of the following options to export events from CleverTap to the mParticle dashboard:
All System Events
When you select this option, the following defined system events are exported:
CleverTap Event Name | Event Description |
---|---|
Notification Sent | The event is tracked when the notification is successfully sent from CleverTap to the communication channel you select for your campaign. |
Notification Viewed | This event is tracked when a user views an email, in-app notification, or a web notification sent from CleverTap. |
Notification Clicked | This event is tracked only when a user clicks on a notification sent via CleverTap.Recorded when a user clicks on a mobile push, in-app, email, web-popup, or web push message sent via the CleverTap dashboard or through the campaign API. |
Push Impressions | This event is tracked when a Push notification sent from CleverTap is delivered on a userβs device. |
Notification Replied | This event is recorded when a user replies to a WhatsApp message. |
Control Group | The event raised when a campaign is activated with a Control group. |
Channel Unsubscribed | The event raised when a user Unsubscribes to receive further communication through a channel |
Push Impressions | This event is tracked when a push notification sent from CleverTap is delivered on a userβs device. The funnels on the Push campaign statistics page reflect the count for this event. |
AB Experiment Stopped | This event is recorded when AB experiment is stopped. |
AB Experiment Rolled Out | This event is recorded when AB experiment is started |
AB Experiment Disqualified | This event is raised when the device is disqualified. |
Geocluster Entered | This event is recorded to mark when a device enters a geofence. |
Geocluster Exited | This event is recorded to mark when a device exits a geofence. |
Reply Sent | This event is recorded when an agent (CleverTap user) replies to a message from the end-user. |
App Version Changed | This event is raised when a userβs current app version is different from the userβs previous app version. |
App Launched | This event is recorded every time a user launches your application. |
App Installed | The event is raised when the user launches the app for the first time. |
App Uninstalled | This event is recorded when a user uninstalls your application. |
UTM Visited | This event is tracked when a user clicks on a link from a marketing campaign that has a UTM parameter defined on it. |
For more information about these events, refer to Events.
Selected Events
With this option, you can select the specific system events (from those listed in the above table) that you want to export from CleverTap to the mParticle dashboard.
Engagement Events
When you select this option, the following engagement events are exported:
- Notification Sent
- Notification Viewed
- Notification Clicked
- Push Impressions
- Notification Replied
- Control Group
- Channel Unsubscribed
- Push Impressions
- Notification Delivered
- AB Experiment Rendered
- AB Experiment Stopped
- AB Experiment Rolled Out
- Geocluster Entered
- Geocluster Exited
- Reply Sent
- App Uninstalled
- Webhook Delivered
- State Transitioned
- UTM Visited
For more information about these events, refer to Events.
User Properties
When you select this option, the following user profile attributes are exported:
Field | Description |
---|---|
Name | Indicates the name of the user. |
Gender | Indicates the gender of the user. |
DOB | Indicates the date of birth of the user. |
All communication preference | Flags that determine the communication preference of the user. |
Availability of Feature
If you are a CleverTap for Enterprises user, contact your sales account manager to activate this feature at your end. In the case of CleverTap for Startups, it is available as a paid add-on.
FAQs
Q. Do CleverTap data exports allow special characters?
A. Yes, CleverTap data exports allow the following special characters:
- CleverTap's export system supports Unicode (UTF-8) character encoding. It facilitates the accurate representation of text in various languages and scripts. For example, Indian regional languages, Arabic, Korean, Russian, Japanese, Chinese, Spanish, Greek, Indonesian, etc.
- It replaces the following characters with a hyphen to avoid issues in output file generation:
- Whitespace
- Tab
- Slash
- null (\0)
- Control characters are replaced with ?. For more information, refer to Control Character.
- Supports emoji characters; however, some emojis (UTF-16) may not render properly.
Updated 3 months ago