Skip to content

mParticle by Rokt

mParticle’s customer data platform empowers you to do more with your data. Sophisticated marketers use mParticle to orchestrate data across their entire growth stack, enabling them to win in key customer journey moments.

The Braze and mParticle integration allows you to seamlessly control the flow of information between the two systems:

  • Sync mParticle audiences to Braze for Braze campaign and Canvas segmentation.
  • Share data across the two platforms. This can be done through the mParticle kit integration and the server-to-server integration.
  • Send Braze user interaction to mParticle through Currents, making it actionable across the entire growth stack.

Prerequisites

Integration

Audiences

Use Braze and mParticle’s partnership to configure your integration and import mParticle audiences directly into Braze for retargeting, creating a full loop of data from one system to another.

설정한 모든 통합은 데이터 포인트를 기록합니다. Braze 데이터 포인트의 뉘앙스에 대한 질문이 있는 경우, 귀하의 Braze 계정 매니저가 답변할 수 있습니다.

Forwarding Audiences

mParticle offers three ways to set cohort membership attributes, controlled by the “Send Segments As” configuration setting. Refer to the following sections for the processing of each option:

Single string attribute

mParticle will create a single custom attribute called SegmentMembership. The value of this attribute is a string of comma-separated mParticle audience IDs that match the user. These audience IDs can be found in the mParticle dashboard under Audiences.

For example, if an mParticle audience “Ibiza dreamers” has an audience ID of “11036”, you can segment these users with the filter SegmentMembershipmatches regex11036.

While this is the default option in mParticle, most Braze users opt to use single array attributes for the filtering experience when creating segments in Braze.

mParticle 세그먼트 membership

단일 배열 속성

mParticle creates a single custom array attribute in Braze for each user, called SegmentMembershipArray. The value of this attribute is an array of mParticle audience IDs that match the user.

For example, if a user is a member of three mParticle audiences with the audience IDs of “13053”, “13052”, and “13051”, you can segment for users who match one of those audience with the filter SegmentMembershipArrayincludes value13051.

One attribute per segment

mParticle will create a boolean custom attribute for each audience a user belongs to. 예를 들어, mParticle 오디언스가 ‘Possible Parisians’인 경우, 이 사용자는 In Possible Parisians - equals - true 필터로 세분화할 수 있습니다.

mParticle 커스텀 속성

단일 배열 속성과 단일 문자열 속성

mParticle will send attributes as described by both single array attribute and single string attribute.

Both single array attribute and one attribute per segment

mParticle will send attributes as described by both single array attribute and one attribute per segment.

Both single string attribute and one attribute per segment

mParticle will send attributes as described by both single string attribute and one attribute per segment.

Single array attribute, single string attribute, and one attribute per segment

mParticle will send attributes as described by single array attribute, single string attribute, and one attribute per segment.

Step 1: Create an audience in mParticle

To create an audience in mParticle:

  1. Navigate to Audiences > Single Workspace > + New Audience.
  2. To connect Braze as an output for your audience, you must provide the following fields:

3. Lastly Save your audience.

You should begin seeing audiences syncing to Braze within a few minutes. Audience membership will only update for users with external_ids (that is, not anonymous users). For more information on creating Braze mParticle audience, see the mParticle documentation on Configuration settings.

Step 2: Segment users in Braze

In Braze, to create a segment of these users, navigate to Segments under Engagement and name your segment. The following are two examples of segments depending on the option you selected for Send segments as. 각 옵션에 대한 자세한 내용은 오디언스 전달를 참조하십시오.

  • Single array attribute: SegmentMembershipArray를 필터로 선택합니다. 다음으로, ‘값 포함’ 옵션을 사용하고 원하는 오디언스 ID를 입력합니다. mParticle 세그먼트 필터 'SegmentMembershipArray'를 '값 포함'으로 설정하고 오디언스 ID를 입력합니다.

  • 세그먼트당 하나의 속성: 귀하의 커스텀 속성을 필터로 선택하십시오. 다음으로, ‘같음’ 옵션을 사용하고 적절한 논리를 선택합니다. mParticle 세그먼트 필터 'in possible parisians'을 '같음' 및 'true'로 설정합니다.

저장한 후에는 사용자 타겟팅 단계에서 캔버스 또는 캠페인을 생성하는 동안 이 세그먼트를 참조할 수 있습니다.

Deactivating and deleting connections

mParticle는 Braze에서 세그먼트를 직접 유지 관리하지 않기 때문에, 해당 mParticle 오디언스 연결이 삭제되거나 비활성화될 때 세그먼트를 삭제하지 않습니다. When this happens, mParticle will not update the audience user attributes in Braze to remove the audience from each user.

To remove the audience from a Braze user before deletion, adjust the audience filters to force the audience size to 0 before deleting an audience. After the audience calculation has completed and returns 0 users, delete the audience. 그런 다음, 오디언스 멤버십은 단일 속성 옵션에 대해 Braze에서 false로 업데이트되거나 배열 형식에서 오디언스 ID를 제거합니다.

Data mapping

Data can be mapped to Braze using the embedded kit integration if you want to connect your mobile and web apps to Braze through mParticle. You can also use the server-to-server API integration to forward server-side data to Braze.

Regardless of which approach you choose, you must set up Braze as an output:

Configure your Braze output settings

mParticle에서 설정 > 출력 > 출력 추가로 이동하고 Braze를 선택하여 Braze 키트 구성을 엽니다. Save when completed.

Embedded kit integration

mParticle 및 Braze SDK는 내장 키트 통합을 통해 귀하의 애플리케이션에 존재합니다. However, unlike a direct Braze integration, mParticle takes care of calling the majority of Braze SDK methods for you. The mParticle methods you use to track user data will automatically be mapped to the Braze SDK methods.

mParticle의 SDK에 대한 이러한 매핑은 Android, iOS, 및 Web에 대해 오픈 소스이며 mParticle의 GitHub 페이지에서 찾을 수 있습니다.

The embedded kit SDK integration allows you to take advantage of our full suite of features (push, in-app messages, and all relevant message analytics tracking).

Step 1: Integrate the mParticle SDKs

Integrate the appropriate mParticle SDKs into your app based on your platform needs:

Step 2: Complete mParticle’s Braze event kit integration

While the Braze SDK does not need to be directly included within your website or app for this mParticle integration, the following mParticle Appboy Kit must be installed to forward data from your app to Braze.

mParticle’s Braze event kit integration guide will walk you through custom mParticle and Braze alignment instructions based on your messaging needs (Push, Location Tracking, etc.).

Step 3: Connections settings for your Braze output

mParticle에서 연결 > 연결 > [원하는 플랫폼] > 출력 연결로 이동하여 Braze를 출력으로 추가합니다. 그런 다음 저장을 선택합니다.

Not all connection settings will apply to all platforms and integration types. For a breakdown of connection settings and the platforms they apply to, see mParticle’s documentation.

Server API integration

This is an add-on to route your backend data to Braze if you’re using mParticle’s server-side SDKs (for example, Ruby, Python, etc.). To set up this server-to-server integration with Braze, follow mParticle’s documentation.

Connections settings for your Braze output

mParticle에서 연결 > 연결 > [원하는 플랫폼] > 출력 연결로 이동하여 Braze를 출력으로 추가합니다. Save when completed.

Not all connection settings will apply to all platforms and integration types. For a breakdown of connection settings and the platforms they apply to, see mParticle’s documentation.

Before enabling “Enriched User Attributes” or “Enriched User Identities” we recommend reviewing Data point overages to ensure you are aware of how these settings will impact data point usage.

Data mapping details

Data types

Not all data types are supported between both platforms.

  • Custom event properties support string, numeric, boolean, or date objects. It does not support arrays or nested objects.
  • 커스텀 속성은 문자열, 숫자, 불리언, 날짜 객체 및 배열을 지원하지만 객체나 중첩 객체는 지원하지 않습니다.

Data mapping

User identity mapping

For each mParticle output, you can select the external identity type to send to Braze as the external_id. While the default value is customer ID, you can choose to map another ID, such as MPID, to send to Braze as the external_id. 고객 ID 외의 식별자를 선택하면 Braze에서 데이터가 전송되는 방식에 영향을 미칠 수 있습니다.

For example, mapping MPID to your Braze external_id will have the following effects:

  • Due to the nature of when MPID is assigned, all users will be assigned an external_id on session start.
  • Currents setup may require additional mapping due to differing data types between MPID and external_id.

Forwarding erasure requests (data subject requests)

Forward erasure requests to Braze by configuring a data subject request output to Braze. To forward erasure requests to Braze, follow mParticle’s documentation.

Potential data point overages

Enriched user attributes

Enabling enrich user attributes/identities (server-to-server only)

In the mParticle connection settings, Braze recommends turning off Include Enriched User Attributes. If enabled, mParticle will forward all available user attributes (such as standard attributes, custom attributes, and calculated attributes) from the existing profile to Braze on each logged event. 이로 인해 mParticle이 각 호출에서 동일한 변경되지 않은 속성을 Braze에 전송하므로 데이터 포인트 소비가 높아집니다.

예를 들어, 사용자가 첫 번째 세션 중에 이름, 성 및 전화번호를 추가하고 나중에 뉴스레터에 가입하고 동일한 정보와 이메일을 추가하여 뉴스레터 가입 이벤트를 트리거하는 경우:

  • If turned on (default), five data points will be incurred. (sign-up event, email address, first name, last name, and phone number)
  • If turned off, two data points will be incurred (sign-up event and email address)

Considerations of turning off enriched user attributes

There are a few considerations to be aware of when turning off Include Enriched User Attributes:

  1. The server-to-server integration uses the mParticle events API to send events to Braze. Each request is triggered by an event. When a user attribute is changed, such as updating an email address, but is not associated with a specific event (for example, a profile update custom event), the new value is only passed to an output like Braze as an “enriched attribute” in the payload of the next event triggered by the user. When Include Enriched User Attributes is turned off, this new attribute value unassociated with a specific event will not be passed to Braze.
    • To solve this, we recommend creating a separate “user attribute updated” event that only sends the specific user attribute(s) that have been updated to Braze. 이 접근 방식을 사용하면 “사용자 속성 업데이트” 이벤트에 대해 추가 데이터 포인트를 여전히 기록하고 있지만, 기능이 활성화된 모든 호출에서 모든 사용자 속성을 전송하는 것보다 데이터 포인트 사용량이 훨씬 적습니다.
  2. Calculated Attributes are passed to Braze as an enriched user attribute, so when “Enriched User Attributes” is turned off these will no longer be passed to Braze. To forward calculated attributes to Braze when “Enriched User Attributes” are turned off, a calculated attribute feed could help without pushing all the attributes. The feed will fire an update downstream to Braze when a calculated attribute changes.

Sending unnecessary or duplicate data to Braze

Braze counts a data point each time an attribute is passed to Braze, even if the value is unchanged. For this reason, Braze recommends only forwarding data needed to action on within Braze and ensuring that only deltas of attributes are being passed.

New Stuff!