mParticle for Currents

mParticle is a customer data platform that collects and routes information from multiple sources to a variety of other locations in your marketing stack.

To get started, you must obtain the mParticle Server to Server Key and mParticle Server to Server Secret. These can be obtained by navigating to your mParticle dashboard and creating the necessary feeds that allow mParticle to receive Braze interaction data for iOS, Android, and Web platforms. Once obtained, the Key and Secret must be added to the Braze Currents mParticle integration page.

mParticle Currents Integration

Create Feeds

Within the mParticle dashboard, you must create one feed per platform (iOS, Android, Web). mParticle also offers an unbound feed for events such as emails, that are not connected to an app platform.

  1. From your mParticle Admin account, navigate to Inputs under Setup.

  2. Locate Braze in the mParticle Directory and add the Feed Integration.

  3. The Braze Feed Integration supports four separate feeds: iOS, Android, Web, and Unbound. You will need to create an input for each feed. You can create additional inputs from Setup > Inputs, on the Feed Configurations tab.mParticle Settings

    For each feed, under “Act as Platform” select the appropriate option from the list. If you do not see an option to select an “act-as” feed, the data will be treated as unbound, but can still be forwarded to data warehourse outputs.
    mParticle Settings mParticle Settings

  4. As you create each input, mParticle will provide you with a Key and Secret. Copy these credentials, making sure to note which feed each pair of credentials is for.

Finish mParticle Integration

To get started, navigate to the Braze dashboard, and select Currents under Integrations. Next, create a new Current, and select mParticle Data Export. Here, you must select the apps you would like event tracking for, and provide the following information for each feed you created:

  • mParticle Server to Server Key
  • mParticle Server to Server Secret

Add this information to the mParticle integration page on the dashboard, and press Launch Current.

mParticle

All events sent to mParticle will include the user’s external_user_id as the customerid. At this time, Braze does not send event data for users who do not have their external_user_id set.

Integration Details

You can export the following data from Braze to mParticle:

Event Name Feed Type Description Currents Properties
Push Notification Sends Platform-specific Feed A push notification was successfully sent to a User. app_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Push Notification Opens Platform-specific Feed User opened a push notification. app_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Push Notification Bounces Platform-specific Feed Braze was not able to send a push notification to this User. app_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
In-App Message Impressions Platform-specific Feed User viewed an In-App Message. app_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
In-App Message Clicks Platform-specific Feed User tapped or clicked a button in an In-App Message. button_id, app_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Content Card Sent Platform-specific Feed A Content Card was sent to a user’s device app_id, card_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Content Card Viewed Platform-specific Feed User viewed a Content Card app_id, card_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Content Card Clicked Platform-specific Feed User clicked a Content Card app_id, card_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Content Card Dismissed Platform-specific Feed User dismissed a Content Card app_id, card_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
News Feed Views Platform-specific Feed User viewed the native Braze News Feed. app_id, card_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
News Feed Card Views Platform-specific Feed User viewed a Card within the native Braze News Feed. app_id, card_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
News Feed Card Clicks Platform-specific Feed User clicked on a Card within the native Braze News Feed. app_id, card_id, campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Application Uninstalled Platform-specific Feed User uninstalled the App. app_id
Event Name Feed Type Description Currents Properties
Email Sends Unbound Feed An email was successfully sent. campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Email Deliveries Unbound Feed An email was successfully delivered to a User’s mail server. campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Email Opens Unbound Feed User opened an email. campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Email Clicks Unbound Feed User clicked a link in an email. Email click tracking must be enabled. campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Email Bounces Unbound Feed Braze attempted to send an email, but the User’s receiving mail server did not accept it. campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Email Marks As Spam Unbound Feed User marked an email as spam. campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Email Unsubscribes Unbound Feed User clicked the unsubscribe link in an email. campaign_id, canvas_step_id, canvas_id, canvas_variation_id
SMS Sends Unbound Feed An SMS was sent to a user. campaign_id, campaign_name, message_variation_id, canvas_step_id, canvas_step_name, canvas_id, canvas_name, canvas_variation_id, canvas_variation_name, to_phone_number
SMS Carrier Sends Unbound Feed An SMS was set to a carrier. campaign_id, campaign_name, message_variation_id, canvas_step_id, canvas_step_name, canvas_id, canvas_name, canvas_variation_id, canvas_variation_name, to_phone_number, from_phone_number
SMS Deliveries Unbound Feed An SMS was delivered successfully. campaign_id, campaign_name, message_variation_id, canvas_step_id, canvas_step_name, canvas_id, canvas_name, canvas_variation_id, canvas_variation_name, to_phone_number, from_phone_number
SMS Delivery Failures Unbound Feed An SMS unable to be delivered successfully. campaign_id, campaign_name, message_variation_id, canvas_step_id, canvas_step_name, canvas_id, canvas_name, canvas_variation_id, canvas_variation_name, to_phone_number, from_phone_number, error, provider_error_code
SMS Rejections Unbound Feed An SMS was rejected. campaign_id, campaign_name, message_variation_id, canvas_step_id, canvas_step_name, canvas_id, canvas_name, canvas_variation_id, canvas_variation_name, to_phone_number, from_phone_number, error, provider_error_code
SMS Inbound Received Unbound Feed An inbound SMS was received. inbound_phone_number, action, message_body
Subscription Group State Change Unbound Feed User’s subscription group state changed to ‘Subscribed’ or ‘Unsubscribed’ campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Webhook Sends Unbound Feed A webhook message was sent on behalf of a User. campaign_id, canvas_step_id, canvas_id, canvas_variation_id
Campaign Conversions Unbound Feed User performed the primary conversion event for a campaign within its conversion window. campaign_id
Campaign Control Group Enrollments Unbound Feed User was enrolled in a campaign control group. campaign_id
Canvas Conversions Unbound Feed User performed the primary conversion event for a Canvas within its conversion window. canvas_step_id, canvas_id, canvas_variation_id
Canvas Entries Unbound Feed User was entered into a Canvas. in_control_group, canvas_id, canvas_variation_id

To read more about the mParticle integration, visit their documentation here.

WAS THIS PAGE HELPFUL?
New Stuff!