Skip to content

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.

The Braze and mParticle integration allows you to seamlessly control the flow of information between the two systems. With Currents, you can also connect data to mParticle to make it actionable across the entire growth stack.

Prerequisites

About mParticle credentials

mParticle has app-level and workspace-level credentials which impact how your events are sent.

  • App-level: mParticle will separate events by each individual app, meaning the app-level credentials you give to your iOS app can only be used to send iOS-specific events.
  • Workspace-level: mParticle groups all events together (that are not app-specific), meaning the workspace-level credentials you give your app group will be used to send all of your non-app-specific events.

You can think of this as mParticle ingesting a “feed” based on each individual app. For example, if you have one app for iOS, one for Android, and one for Web, your events will be disjointed. This means if you provide the same credentials for each app, then one mParticle feed will be used to receive all data for all of your apps, with no duplication.

Integration

Step 1: Create feeds

From your mParticle admin account, navigate to Setup > Inputs. Locate Braze in the mParticle Directory and add the feed integration.

The Braze feed integration supports four separate feeds: iOS, Android, Web, and Unbound. The unbound feed can be used for events such as emails that are not connected to a platform. You will need to create an input for each main platform feed. You can create additional inputs from Setup > Inputs, on the Feed Configurations tab.

For each feed, under Act as Platform select the matching platform from the list. act-as 피드를 선택하는 옵션이 표시되지 않으면 데이터는 언바운드로 처리되지만 여전히 데이터 웨어하우스 출력으로 전달할 수 있습니다.

구성 이름을 제공하고 피드 상태를 결정하며 작동할 플랫폼을 선택하라는 프롬프트를 표시하는 첫 번째 통합 대화 상자. 서버 간 키와 서버 간 비밀을 보여주는 두 번째 통합 대화상자.

각 입력을 생성할 때 mParticle에서 키와 비밀을 제공합니다. Copy these credentials, making sure to note which feed each pair of credentials is for.

Step 2: Create Current

In Braze, navigate to Currents > + Create Current > Create mParticle Export. Provide an integration name, contact email and the mParticle API key and mParticle secret key for each platform. Next, select the events you want to track; a list of available events is provided. Lastly, click Launch Current

The mParticle Currents page in Braze. 여기에서 통합 이름, 연락처 이메일, API 키 및 비밀 키 필드를 찾을 수 있습니다.

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. If you’d like to map the external_user_id to a different ID in mParticle that is not the default customerid, please contact your Braze CSM.

Supported Currents events

Braze supports exporting the following data listed in the Currents user behavior and message engagement event glossaries to mParticle:

Behaviors

  • Uninstall: users.behaviors.Uninstall
  • Subscription (global state change): users.behaviors.subscription.GlobalStateChange
  • Subscription group (state change): users.behaviors.subscriptiongroup.StateChange

Campaigns

  • Abort: users_campaigns_abort
  • Conversion: users.campaigns.Conversion
  • EnrollinControl: users.campaigns.EnrollInControl

Canvas

  • Abort: users_canvas_abort
  • Conversion: users.canvas.Conversion
  • Entry: users.canvas.Entry
  • Exit (matched audience, performed event)
    • users.canvas.exit.MatchedAudience
    • users.canvas.exit.PerformedEvent
  • Experiment Step (conversion, split entry)
    • users.canvas.experimentstep.Conversion
    • users.canvas.experimentstep.SplitEntry

Messages

  • Content Card (abort, click, dismiss, impression, send)
    • users.messages.contentcard.Abort
    • users.messages.contentcard.Click
    • users.messages.contentcard.Dismiss
    • users.messages.contentcard.Impression
    • users.messages.contentcard.Send
  • Email (abort, bounce, click, delivery, markasspam, open, send, softbounce, unsubscribe)
  • In-app message (abort, click, impression)
    • users.messages.inappmessage.Abort
    • users.messages.inappmessage.Click
    • users.messages.inappmessage.Impression
  • Push notification (abort, bounce, open, send)
    • users.messages.pushnotification.Abort
    • users.messages.pushnotification.Bounce
    • users.messages.pushnotification.Open
    • users.messages.pushnotification.Send
  • SMS (abort, carrier send, delivery, delivery failure, inbound receive, rejection, send, short link click)
    • users.messages.sms.Abort
    • users.messages.sms.Delivery
    • users.messages.sms.DeliveryFailure
    • users.messages.sms.InboundReceive
    • users.messages.sms.Rejection
    • users.messages.sms.Send
    • users.messages.sms.ShortLinkClick
  • Webhook (abort, send)
    • users.messages.webhook.Abort
    • users.messages.webhook.Send
  • WhatsApp (abort, delivery, failure, inbound receive, read, send)
    • users.messages.whatsapp.Abort
    • users.messages.whatsapp.Delivery
    • users.messages.whatsapp.Failure
    • users.messages.whatsapp.InboundReceive
    • users.messages.whatsapp.Read
    • users.messages.whatsapp.Send

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

New Stuff!