mParticle Export

Customer Data Platform

📘

Feature in Beta

Currently, this feature is released in a public beta.

Overview

mParticle, a customer data platform that manages data quality and drives better customer interactions. CleverTap integration 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 major steps:

  1. Find mParticle Project Details.
  2. Configure CleverTap Dashboard.

Find mParticle Project Details

To find your project details:

  1. Log in to your mParticle account.
  2. Navigate to the Setup > Inputs > Feeds.
  3. Click Add Feed Input and select CleverTap from the dropdown list.
28622862

The Input: Feed Configuration popup opens.

  1. Enter the Configuration Name and turn ON the Feed Status toggle.
28182818
  1. Click Save. The API key and API secret are displayed.
28062806
  1. Copy the project details as you will need them in the next step.

Configure CleverTap Dashboard

This process involves adding mParticle project details to the CleverTap dashboard. To add the project details to the CleverTap dashboard:
a. Log in to your CleverTap account.
b. Navigate to Settings > Partners > Exports.

16721672

c. Click the mParticle icon under the Unconnected partners section. The mParticle page displays.
d. Enter the following mParticle details:

Field

Description

mParticle API Key and mParticle 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 user property is used as an identifier when sending events data to mParticle.

15041504

e. Click Save credentials. The following popup displays:

13901390

mParticle is now displayed under Connected partners when you navigate to Settings > Partners > Exports.

13941394

Create New Export

To create a new export:

  1. Navigate to Settings > Partners > Exports.
  2. Navigate to the Activity log tab and then click + Create Export.
13161316

The Create an export popup displays.

10181018
  1. Configure the following settings:
    • Choose an export partner: Select mParticle from the Choose an export partner dropdown.
    • Export details: Select the type of data that you want to export from the available options. For more information, refer to Export Details.
    • Choose export frequency: Select from one of the following options:
      • One time: Single export for the export type selected. You can export data up to the last 60 days.
      • Recurring: Set up a recurring export that exports 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.
  2. Click Create export.
13821382

The following message displays on successful creation of export:

13881388
  1. Click Ok to return to the Exports page. CleverTap processes the export, and you can now see the newly created export for mParticle.
13881388

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. And, it changes to Done when the export is complete.

Stop Export

You can also stop the export that you have created. To do so:

  1. Click the ellipsesellipses icon for the export request you want to stop and then click stopstop.
13901390

You are prompted to confirm your action.

13821382
  1. Click Yes, stop export to stop the export request. The following message displays:
13921392
  1. Click Ok to return to the Exports page.

Export Details

All 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 the birth of the user.

All communication preference

Flags that determine the communication preference of the user.

📘

Availability of Feature

This feature is available in the CleverTap Enterprise plan.


Did this page help you?