Mixpanel

Overview

900900

버튼 하나로 Branch 데이터를 Mixpanel 대시보드로 전송하여 유저 획득 경로를 제공하는 Branch의 능력을 이해할 수 있습니다.

작동 방식

Branch SDK가 앱에 연동되면 Branch는 어떤 링크가 설치, 재오픈, 유저 액션으로 이어지는지 감지할 수 있습니다. 이 연동을 활성화하고 Mixpanel 토큰을 제공하면 Branch가 리퍼드(Referred)된 이벤트를 Mixpanel이 예상하는 정확한 형식으로 Mixpanel에 자동으로 전달합니다.

Branch는 어떤 이벤트를 보내나요?

Branch will send referred installs and opens, commerce, content, user lifecycle, as well as any custom events you track with Branch. Non-referred events, clicks, web session starts, and pageviews will be excluded. Branch also sends all the data that is attached to the link that drove the referred event. This will allow you to analyze which campaigns, channels, etc. are helping you acquire and engage users. You can see the list of fields that we send to Mixpanel here.

어떻게 생겼습니까?

Branch events will appear alongside your other tracked events in Mixpanel. These events will automatically have [Branch] prepended.

imageimage

또한 Live View 등에서 볼 수 있는 개별 이벤트에는 Branch 링크 데이터가 포함됩니다. 예시 :

imageimage

Branch 이벤트는 기존 유입 경로에서 사용될 수 있으며 다양한 페이지 및 대시보드에서 트래킹될 수 있다는 점에서 Mixpanel 이벤트와 유사합니다. 그러나 일반 이벤트와 달리 Branch 이벤트에는 유저가 어떻게 여러분의 앱에 유입되었는지에 대한 귀중한 정보가 포함됩니다.

1. 데이터 연동 전제조건 완료

🚧

개발자 필요

BRANCH

MIXPANEL

2. 파트너의 키/자격 증명 검색

기본적으로는 코드 없는 연동을 지원 : Mixpanel 토큰을 찾아 Branch 대시보드에 입력합니다.

  1. Navigate to https://mixpanel.com and log into the Dashboard.
  2. 페이지 상단의 탐색 표시 줄에서 Account 을 클릭합니다.
  3. Choose Projects in the modal that appears, then copy your app’s Token: imageimage

3. 연동 활성화

  1. On the Branch Dashboard (dashboard.branch.io), navigate to the Integrations page.
  2. Mixpanel을 검색하고 타일을 클릭합니다.
  3. Mixpanel 토큰을 입력하고 (토큰을 두 필드에 모두 붙여넣은 경우) Enable을 클릭하십시오.

imageimage

🚧

연동을 반드시 테스트하세요!

Branch는 부정확한 API 키에 대해 책임지지 않습니다.

4. ID/Metadata를 Branch로 전송

Branch iOS SDK 0.12.2 이상, 안드로이드 SDK v1.12.1 이상을 사용하고 있는지 반드시 확인하십시오.

기본 연동 외에도 앱에 소량의 코드를 추가해야 합니다. 이를 통해 Branch SDK에 유저의 Mixpanel Distinct ID를 Branch 서버로 전달할 수 있도록 권한을 부여합니다. 이후 Branch는 이벤트 로그시 해당 Distinct ID를 Mixpanel에 전달합니다.

iOS:

Branch 세션을 초기화하기 전에 다음을 추가하십시오.

[[Branch getInstance] setRequestMetadataKey:@"$mixpanel_distinct_id" value:[Mixpanel sharedInstance].distinctId];
Branch.getInstance().setRequestMetadataKey("$mixpanel_distinct_id", value: Mixpanel.mainInstance().distinctId)

Android:

애플리케이션의 #onCreate 또는 Activity의 #onCreate에서 Branch를 초기화 한 직후 다음 라인을 호출하십시오:

MixpanelAPI mp = MixpanelAPI.getInstance(this, "<your project token>");
Branch.getInstance().setRequestMetadata("$mixpanel_distinct_id", mp.getDistinctId());

For more information, see Why We Recommend Passing Mixpanel Distinct ID.

🚧

Mixpanel 고유 ID 변경

유저가 앱을 사용하는 동안 언제든지 Mixpanel 고유 ID를 변경하는 경우 위와 동일한 한 줄의 코드를 호출해야 합니다. 이런 식으로 Branch에서 Mixpanel 로의 향후 호출은 업데이트된 고유 ID를 사용합니다.

iOS 예시:

[[Branch getInstance] setRequestMetadataKey:@"$mixpanel_distinct_id" value:@"User A"];

추가 Mixpanel 리소스:

For a high level overview of identities in Mixpanel, see Identity Management in Mixpanel. If you experience any issues regarding tracking identities or have general questions about the .alias() and .identify() methods, please take a look at Mixpanel's documentation first. Additionally, reach out to [email protected] if the problem persists.

고급

Branch가 Mixpanel에 보내는 것

속성 이름출처예시 Req
eventBranch 이벤트event name[Branch] installY
properties.distinct_id디바이스/유저의 Unique ID아래 섹션 참조AEBE52E7-03EE-455A-B3C4-E57283966239N
properties.tokenMixpanel 토큰Branch 대시보드eed14a8aaa8c8ef777b8e9cb30826399Y
properties.time이벤트 생성일event1461878903N
properties.ANY-KEY (다수)키와 관련된 값이벤트 메타 데이터 또는 리퍼링(Referring) 링크 데이터~channel: facebookN

Mixpanel Distinct ID를 추천하는 이유

Mixpanel에서 사용하는 IDentifier 중 하나라도 사용 가능한 경우 Branch는 Mixpanel이 요청한 Distinct ID를 자동으로 지정합니다. iOS에서 Branch는 IDFA가 있는 경우 IDFA를 보내거나, 있는 경우 identifierForVendor (IDFV)를 보내며, 그렇지 않으면 Distinct ID를 생략합니다. 안드로이드 Branch에서는 있는 경우 Google Advertising ID 또는 안드로이드 ID(하드웨어 ID)를 보낼 것이며, 그렇지 않은 경우 Distinct ID를 생략합니다.

iOS에서 Mixpanel SDK는 기본적으로 IDFA(있는 경우)를 사용하고, 그렇지 않으면 identifierForVendor (IDFV) (공급업체 ID 또는 identifierForVendor라고도 함)를 사용합니다. 드물게 identifierForVendor (IDFV)를 사용할 수 없는 경우 임의의 UUID가 생성됩니다. IDFA를 사용할 수 있으려면 AdSupport.framework를 포함했는지 확인하십시오.

안드로이드에서 Mixpanel SDK는 기본적으로 Google Advertising ID 또는 안드로이드 ID (하드웨어 ID)를 사용하지 않습니다. 대신 임의의 UUID를 생성합니다. 즉, 안드로이드에서 Branch에 Mixpanel Distinct ID를 전달하지 않으면 Branch에서 생성한 이벤트를 Mixpanel에서 식별한 유저와 제대로 연결할 수 없습니다.

서포트

여러 디바이스 및 Mixpanel ID/Alias들의 뉘앙스

앱을 사용할 때 유저의 Mixpanel 고유 ID를 변경하는 경우 위와 동일한 한 줄의 코드를 호출해야 합니다. 이렇게 Branch에서 Mixpanel으로의 향후 호출은 업데이트된 고유 ID를 사용합니다.

또한 이벤트가 Mixpanel에 기록되지만 올바른 유저와 연결되지 않는 시나리오가 하나 있습니다. 이는 Mixpanel의 ID 제한 때문입니다.

다음은 예제 시나리오입니다:

유저는 iPhone과 iPad를 가지고 있습니다

iPhone에는 IDFA 1234XXXX-XXXX-XXXX-XXXXXXXXXXXX - 줄여서 1234가 있습니다.

iPad에는 5678XXXX-XXXX-XXXX-XXXXXXXXXXXX - 줄여서 5678이 있습니다.

(Branch 링크를 통하지 않고) 오가닉으로 앱을 오픈한 유저는 자동으로 distinctId 1234(IDFA)를 할당받습니다. 그런 다음 유저가 회원 가입을 마쳤을 때, "User A" 값을 가진 alias () 가 호출되어 1234와 연결시킵니다 (1234 <> "User A").

그런 다음 해당 유저는 리인게이지먼트 타겟이 되어 이메일 캠페인의 대상이 됩니다. 유저는 iPad에서 이메일을 확인하고 Branch 링크를 클릭하여 앱을 오픈합니다. Branch는 Mixpanel에 자동으로 할당된 distinctId 5678(=IDFA값)과 함께 리퍼드(Referred) 이벤트를 전송합니다. 그리고 유저가 로그인을 하면, identify()가 'User A'라는 값과 함께 호출됩니다. Identify()는 양 디바이스 모두에서 같은 아이덴티티인 User A로 유저를 매칭하기 위해 호출됩니다. 만약 두 번째 케이스에서 alias()를 호출한다면 두 개의 distinctId들(그리고 Mixpanel의 로직에서는 두 명의 다른 사람들)이 있을 것입니다 - 하나는 distinctId 1234이며 다른 하나는 distinctId 5678입니다. 이 둘을 합치기 위해 두 번째 디바이스에서 유저를 Identify()해야 합니다. 이 로직의 어쩔 수 없는 맹점은 identify() 이전의 액션들은 다른 두 distinctId들이 존재하므로 같은 유저로 인식될 수 없다는 점입니다.

5678과 관련된 리퍼드(Referred) 이벤트는 1234/"User A" 와 연관되지 않은 상태입니다.

In order for any additional events on this device to be associated with "User A", the app should invoke the one line of code as recommended in the section Pass Mixpanel Distinct ID. Example:

[[Branch getInstance] setRequestMetadataKey:@"$mixpanel_distinct_id" value:@"User A"];

If there are ever workarounds for this, we will update this guide and notify our partners accordingly. Here is more information on how Mixpanel manages identities.

User Profile Properties

Branch does not support sending any User Profile Properties to Mixpanel. In order to set user properties, please follow Mixpanel's guide on setting a user profile property.

필터