Mixpanel

Overview

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

작동 방식

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

Branch Events Sent to Mixpanel

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.

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

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

전제 조건

In order to enable Mixpanel, you need to have completed the following:

1. Admin access to your Branch Dashboard.
2. Enabled Data Feeds for your Branch account.
   • Contact your Branch account manager or visit https://branch.io/pricing
3. Implemented the Branch SDK into your mobile app (iOS | Android)
   • Track events
4. MIXPANEL SDK 구현
5. Admin access to your Google Analytics account.

Enable Mixpanel

1. Retrieve IDs from Mixpanel

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

1. Navigate to https://mixpanel.com and log into the Dashboard.
2. 페이지 상단의 탐색 표시 줄에서 Account 을 클릭합니다.
3. 표시되는 선택창에서 Projects 을 선택한 다음 앱의 토큰을 복사합니다:

2. Connect Mixpanel in Branch

In the Branch Dashboard in Data Feeds → Data Integrations tab, find and search for Google Analytics.

Enter the Android and iOS tokens from the previous step, then hit Enable.

3. Pass Metadata to the Branch SDK

👍

개발자 필요

Developers on your mobile app are required for this step

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"];

4. Verify Data Sent

Once the above steps are complete, you are now ready to start launching campaigns. Branch-attributed conversions will be sent to Mixpanel. To verify data is being sent from Branch to Mixpanel, you can look at the Branch Dashboard's Liveview Webhook Records and apply the following filter:

📘

Wait Period

Please be patient as data may take some time to flow through Branch's attribution systems and onto Mixpanel. If data has not appeared in Mixpanel after 30 minutes of completing a test conversion, review the above steps to see if you may have missed something.

Troubleshooting

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에 보내는 것

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.