mParticle (가져오기)


mParticle에서 Branch로 이벤트를 전송하면 웹 및 앱에서의 구매와 같은 다운스트림 전환이 Branch 링크 클릭으로 어트리뷰션될 수 있습니다. mParticle에서 Branch로 불러온 이벤트는 대시보드 시각화, Data Feeds 솔루션, Universal Ads(광고 어트리뷰션) 포스트백, Journeys 솔루션 타겟팅, Liveview 등 Branch 내에서 일반적으로 이벤트를 사용할 수있는 모든 곳에서 사용할 수 있습니다.

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를 클릭하십시오.
  1. mParticle UI의 연결 페이지로 이동합니다.
    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 동작mParticle 이벤트 유형mParticle 커스텀 이벤트 유형Branch 이벤트Branch 이벤트 카테고리불러옴
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 Event
view_detailproduct_action-View ItemContent Event
view_detailproduct_action-View ItemsContent Event
Branch 이벤트 이름 사용--RateContent Event
Branch 이벤트 이름 사용--ShareContent Event
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-아니오


이벤트를 Branch로 불러오려면 식별자가 필요합니다. 다음을 포함해야 합니다:

  • context.userId.Customer OR
  • (environment.Identity.DeviceIdentity.IOS_ADVERTISING_ID OR environment.Identity.DeviceIdentity.IOS_VENDOR_ID) AND context.runtimeEnvironment.type OR
  • (environment.Identity.DeviceIdentity.GOOGLE_ADVERTISING_ID OR environment.Identity.DeviceIdentity.ANDROID_ID) AND 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 내에서 이벤트를 사용할 수있는 모든 곳에서 사용할 수 있습니다. 여기에는 대시보드 시각화, Data Feeds 솔루션 (Data Integrations, Query API, Webhooks, Daily Export API 포함), Universal Ads(광고 어트리뷰션) 포스트백, Journeys 솔루션 타겟팅, Liveview 등이 포함됩니다.


웹에서 로그아웃한 유저에 대한 어트리뷰션

Branch는 웹에서 로그아웃 한 유저를 위해 커스텀 사내 식별자를 사용합니다. mParticle에서 Branch로 서버 투 서버 연동을 활성화하면 로그아웃 한 웹 이벤트를 Branch로 실행되는 캠페인에 어트리뷰션할 수 없습니다. 따라서 mParticle에서 앱 이벤트를 서버 투 서버로 계속 보내면서 Branch 웹 SDK를 사용하여 웹 이벤트를 직접 트래킹할 수 있습니다. Branch를 사용하면 웹 이벤트 불러오기를 해제하여 중복 데이터를 방지할 수 있습니다.

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 이벤트를 제공하지 않습니다. (오픈 이벤트 임박)
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.