mParticle (가져오기)
Send mParticle data to Branch to unlock a more holistic picture of the customer journey for your app.
Overview
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.
작동 방식
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 동작 | mParticle 이벤트 유형 | mParticle 커스텀 이벤트 유형 | Branch 이벤트 | Branch 이벤트 카테고리 | 불러옴 |
|---|---|---|---|---|---|
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 Event | 예 |
view_detail | product_action | - | View Item | Content Event | 예 |
view_detail | product_action | - | View Items | Content Event | 예 |
| Branch 이벤트 이름 사용 | - | - | Rate | Content Event | 예 |
| Branch 이벤트 이름 사용 | - | - | Share | Content Event | 예 |
| 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 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 필드 |
|---|---|
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 내에서 이벤트를 사용할 수있는 모든 곳에서 사용할 수 있습니다. 여기에는 대시보드 시각화, 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 대시보드에서 연결 활성화 :
- 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