筛选项

mParticle (Import)

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

1328

概述

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

  1. Admin access to your Branch Dashboard.
  2. Enabled Data Feeds for your Branch account.
  3. Implemented the Branch SDK into your mobile app (iOS | Android)
  4. Implement the mParticle SDK
  5. 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.

2390

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.Customerdeveloper_identity
environment.Identity.DeviceIdentity.IOS_ADVERTISING_IDidfa
environment.Identity.DeviceIdentity.GOOGLE_ADVERTISING_IDaaid
environment.Identity.DeviceIdentity.IOS_VENDOR_IDidfv
environment.Identity.DeviceIdentity.ANDROID_IDandroid_id
context.runtimeEnvironment.typeos

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 发生了以下事件,您将在导入卡上看到一个绿点:

501

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

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