mParticle (Import)


将事件从 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.

Branch 会导入什么事件?

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.


  1. 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.

  2. Navigate to the Data Integrations page of the Branch dashboard.

    1. 从左侧菜单中选择 mParticle
    2. 选择您要从中导入事件的平台,然后点击 Save


  3. 前往 mParticle UI 的 Connections 页面。

    1. 选择一个输入,然后添加 Branch S2S 作为输出。
    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.



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 ActionmParticle 事件类型mParticle 自定义事件类型Branch EventBranch 事件类别Imported
add_to_cartproduct_action--Add To CartCommerce Event
add_to_wishlistproduct_action--Add To WishlistCommerce Event
使用Branch事件名称----View CartCommerce Event
使用Branch事件名称----Add Payment InfoCommerce Event
checkoutproduct_action--Initiate PurchaseCommerce Event
purchaseproduct_action--PurchaseCommerce Event
使用Branch事件名称----Spend CreditsCommerce Event
使用Branch事件名称custom_eventsearchSearchContent 事件
view_detailproduct_action--View ItemContent 事件
view_detailproduct_action--View ItemsContent 事件
使用Branch事件名称----RateContent 事件
使用Branch事件名称----ShareContent 事件
使用Branch事件名称----Complete RegistrationLifecycle Event
使用Branch事件名称----Complete TutorialLifecycle Event
使用Branch事件名称----Achieve LevelLifecycle Event
使用Branch事件名称----Unlock AchievementLifecycle Event
使用Branch事件名称----CustomCustom Event
------SMS Sent--
------Web Session Start--
------Branch CTA View--
------Web to App Auto Redirect--


必须输入标识符,事件才能导入到 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 字段

At this time, Branch will not attribute logged out web events received from the server-to-server integration.


一旦在 mParticle 和 Branch 中都开启了导入,事件就会发生。如果 Branch 发生了以下事件,您将在导入卡上看到一个绿点:


To see more information on the events that are coming in, you can look at events with origin MPARTICLE in Liveview:


Branch imports events from mParticle as commerce, user lifecycle, content, or custom events.


从 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 仪表盘中启用连接:

  1. 一旦配置了 Branch S2S 模块,就可以通过 mParticle 连接 UI 将其选择为目的地(下面为屏幕截图)。
  2. 选择 Roku 平台输入并将其连接到Branch,而无需进行任何转换。
  1. Enter your Branch Key and Branch Secret in order to configure the Branch S2S integration.