mParticle (Import)
Send mParticle data to Branch to unlock a more holistic picture of the customer journey for your app.

概述
将事件从 mParticle 发送到 Branch 将使您可以将下游转化(例如,通过 Web 和应用购买)归因于 Branch 的链接点击。从 mParticle 导入到 Branch 的事件将在您通常可以在 Branch 中使用事件的任何地方可用,包括操作后台 (Dashboard)可视化,数据馈送,Universal Ads 回传,Journeys 定位,Liveview 等。
This guide walks through the server-side integration for data import from mParticle to Branch. For the client-side integration, see the mParticle iOS or android documentation. For data export from Branch to mParticle, go here.
它是如何工作的?
Once the Branch SDK is integrated into an app, Branch can detect which Branch Links are leading to installs, re-opens, and users' actions. Enabling this integration and sending your events to Branch will allow Branch to enhance your mParticle data with Branch data.
Branch Events Imported from mParticle
Branch will import events that are not auto-tracked with the Branch SDKs. This includes commerce, content, user lifecycle, and custom events, and excludes events like clicks and installs. See the full list of supported events and associated mappings here. Branch will only import events that can be tied to a user.
Avoid Duplicate Data
To avoid duplicate data, you should either track conversion events directly with Branch or track events with mParticle and then enable import to Branch, not both. Branch will warn you if you try to import events to Branch that you are already tracking.
The Branch integration supports some of the events tracked with mParticle’s API or SDKs. Branch will only import events from mParticle that are not already auto-tracked with the Branch SDK. This means that events like click and install cannot be imported. The following outlines how mParticle events are mapped to Branch events, and which will be imported to Branch:
mParticle Action | mParticle 事件类型 | mParticle 自定义事件类型 | Branch Event | Branch 事件类别 | Imported |
---|---|---|---|---|---|
add_to_cart | product_action | -- | Add To Cart | Commerce Event | 是 |
add_to_wishlist | product_action | -- | Add To Wishlist | Commerce Event | 是 |
使用Branch事件名称 | -- | -- | View Cart | Commerce Event | 是 |
使用Branch事件名称 | -- | -- | Add Payment Info | Commerce Event | 是 |
checkout | product_action | -- | Initiate Purchase | Commerce Event | 是 |
purchase | product_action | -- | Purchase | Commerce Event | 是 |
使用Branch事件名称 | -- | -- | Spend Credits | Commerce Event | 是 |
使用Branch事件名称 | custom_event | search | Search | Content 事件 | 是 |
view_detail | product_action | -- | View Item | Content 事件 | 是 |
view_detail | product_action | -- | View Items | Content 事件 | 是 |
使用Branch事件名称 | -- | -- | Rate | Content 事件 | 是 |
使用Branch事件名称 | -- | -- | Share | Content 事件 | 是 |
使用Branch事件名称 | -- | -- | Complete Registration | Lifecycle Event | 是 |
使用Branch事件名称 | -- | -- | Complete Tutorial | Lifecycle Event | 是 |
使用Branch事件名称 | -- | -- | Achieve Level | Lifecycle Event | 是 |
使用Branch事件名称 | -- | -- | Unlock Achievement | Lifecycle Event | 是 |
使用Branch事件名称 | -- | -- | Custom | Custom Event | 是 |
-- | -- | -- | Click | -- | 否 |
-- | -- | -- | Install | -- | 否 |
-- | -- | -- | Reinstall | -- | 否 |
-- | -- | -- | Open | -- | 否 |
-- | -- | -- | SMS Sent | -- | 否 |
-- | -- | -- | Pageview | -- | 否 |
-- | -- | -- | Web Session Start | -- | 否 |
-- | -- | -- | Branch CTA View | -- | 否 |
-- | -- | -- | Impression | -- | 否 |
先决条件
In order to enable mParticle (import), you need to have completed the following:
- Admin access to your Branch Dashboard.
- Enabled Data Feeds for your Branch account.
- Contact your Branch account manager or visit https://branch.io/pricing
- Implemented the Branch SDK into your mobile app (iOS | Android)
- Implement the mParticle SDK
- Admin access to your mParticle account.
Enable mParticle (import)
1. Setup Branch
Contact Branch to configure Branch to receive events from mParticle. Please note that a subscription to Data Feeds is required to enable data import from mParticle to Branch.
Then, navigate to the Data Integrations page of the Branch dashboard.
1. Select mParticle from the menu on the left.
2. Select the platforms you would like to import events from and click Save.

2. Setup mParticle
Navigate to your your mParticle UI’s Connections page.
1. Select an input and add Branch S2S as the output.
2. Enter your Branch Key. This can be found in the Account Settings > App section of the Branch dashboard.
3. Enter your Branch Secret. This can be found in the Account Settings > App section of the Branch dashboard.
身份标识
必须输入标识符,事件才能导入到 Branch。您必须包括:
- context.userId.Customer 或
- (environment.Identity.DeviceIdentity.IOS_ADVERTISING_ID 或environment.Identity.DeviceIdentity.IOS_VENDOR_ID)和 context.runtimeEnvironment.type 或
- (environment.Identity.DeviceIdentity.GOOGLE_ADVERTISING_ID 或 environment.Identity.DeviceIdentity.ANDROID_ID)和 context.runtimeEnvironment.type
Branch 将 mParticle 的标识符映射到以下内容:
mParticle 字段 | Branch 字段 |
---|---|
context.userId.Customer | developer_identity |
environment.Identity.DeviceIdentity.IOS_ADVERTISING_ID | idfa |
environment.Identity.DeviceIdentity.GOOGLE_ADVERTISING_ID | aaid |
environment.Identity.DeviceIdentity.IOS_VENDOR_ID | idfv |
environment.Identity.DeviceIdentity.ANDROID_ID | android_id |
context.runtimeEnvironment.type | os |
At this time, Branch will not attribute logged out web events received from the server-to-server integration.
3. Verify the integration
一旦在 mParticle 和 Branch 中都开启了导入,事件就会发生。如果 Branch 发生了以下事件,您将在导入卡上看到一个绿点:

Branch imports events from mParticle as commerce, user lifecycle, content, or custom events. To see more information on the events that are coming in, you can look at events with origin MPARTICLE
in Liveview.
使用导入的事件
从 mParticle 导入到 Branch 的事件将在任何通常可以在 Branch 中使用事件的位置可用。这包括操作后台 (Dashboard)可视化,Data Feeds(数据对接)(包括数据集成,查询 API,Webhook 和每日导出 API),Universal Ads(全域广告归因)回传,Journeys (站到端引流) 定位,Liveview 等。
高级
网络上已注销用户的归因
Branch 使用自定义的内部标识符供 Web 上注销的用户使用。如果启用从 mParticle 到 Branch 的服务器到服务器间的集成,将无法将注销的 Web Events 归因于使用 Branch 运行的 Campaign。因此,您可能想直接使用 Branch Web SDK 追踪 Web 事件,同时仍将应用事件服务器从 mParticle 发送到服务器。Branch 允许您随后关闭 Web 事件导入,以防止重复数据。
启用 Roku OTT 事件
先决条件
You must complete the above set up steps
You must have OTHER events checked in the Branch Dashboard mParticle Integration
活动支持
OTT mParticle 导入将不会给出 Branch OPEN 事件。(OPEN 事件即将到来)
Branch 将 session_start 事件导入为自定义事件。
在 mParticle 仪表盘中启用连接:
- 一旦配置了 Branch S2S 模块,就可以通过 mParticle 连接 UI 将其选择为目的地(下面为屏幕截图)。
- 选择 Roku 平台输入并将其连接到Branch,而无需进行任何转换。

- Enter your Branch Key and Branch Secret in order to configure the Branch S2S integration.

Updated 2 months ago