믹스패널

Jeongwon KimWritten by Jeongwon Kim,

에어브릿지는 믹스패널(Mixpanel) 연동을 지원합니다. 에어브릿지 사용자는 믹스패널에서 에어브릿지의 광고 성과 데이터를 활용해서 더 정교하게 프로덕트를 분석할 수 있습니다.

 

연동하기

에어브릿지와 믹스패널(Mixpanel) 연동을 완료하면 에어브릿지에 쌓이는 이벤트와 각 이벤트의 프로퍼티 같은 광고 성과 데이터가 믹스패널로 전송됩니다.

사전 준비사항

에어브릿지와 믹스패널을 원활하게 연동하려면 에어브릿지 SDK에 연동 관련 코드를 반드시 추가해야 합니다. 아래 개발자 가이드를 참고해 주세요.

해당 개발자 가이드에 나와 있는 코드를 반드시 데이터를 수집 중인 에어브릿지 SDK에 삽입해야 합니다. 이 코드를 SDK에 미리 삽입하지 않으면 에어브릿지 대시보드에서 연동 설정을 하더라도 유저 매칭 확률이 떨어지고 데이터 분석이 부정확해질 수 있습니다.

 

믹스패널에서 연동 정보 확인하기

주의하세요

아래 순서에 따라 연동 정보를 등록하기 전에 반드시 데이터를 수집 중인 에어브릿지 SDK에 코드를 삽입하는 작업을 진행해야 합니다. SDK에 코드가 삽입되지 않으면 전송된 에어브릿지의 데이터를 바탕으로 믹스패널에서 정확한 데이터 분석을 할 수 없습니다. Mixpanel 연동 개발자 가이드를 확인하고 관련 개발자에게 전달 바랍니다.

에어브릿지와 믹스패널을 연동하려면 에어브릿지에 입력할 연동 정보를 믹스패널에서 확인해야 합니다. 필요한 연동 정보는 총 5가지입니다.

  • Project ID

  • Project Token

  • Data Residency

  • Service Account Username

  • Service Account Secret

아래 순서에 따라 믹스패널에서 연동 정보를 확인할 수 있습니다.

1. 믹스패널 대시보드에 로그인합니다. 

2. 오른쪽 위에 있는 톱니바퀴 모양의 아이콘을 클릭하고 [Organization Settings]>[Projects]로 들어갑니다. 아래 과정을 진행하면 이 메뉴에서 Project ID, Project Token 값과 Data Residency 정보를 확인할 수 있습니다. 

3. 에어브릿지와 연동할 프로젝트(Project)를 선택합니다. 이때 기존에 생성한 프로젝트가 없다면 ‘+Create Project’를 클릭해서 새로운 프로젝트를 만들어야 합니다. 프로젝트 이름을 입력하고 데이터를 저장할 지역(Where To Store Your Data)과 타임존을 선택하고 나서 ‘Create’를 클릭합니다.

이중 데이터를 저장할 지역은 Data Residency 정보에 해당합니다. 이 정보는 프로젝트를 생성한 이후에 변경할 수 없으니 주의 바랍니다. 단, 프로젝트 이름과 타임존은 프로젝트를 생성한 이후에도 변경할 수 있습니다.

 

4. 생성된 프로젝트 정보에서 Project ID, Project Token 값과 Data Residency 정보를 확인합니다. 

5. 왼쪽 메뉴 중 [Projects] 아래에 있는 [Service Accounts]를 클릭합니다. 아래 과정을 진행하면 이 메뉴에서 Service Account Username, Service Account Secret 값을 확인할 수 있습니다.

 

6. 에어브릿지와 연동할 서비스 계정(Service Account)을 선택합니다. 기존에 생성한 서비스 계정이 없다면 ‘+Add Service Account’를 클릭해서 새로운 서비스 계정을 만들어야 합니다.

원하는 서비스 계정 이름을 입력하고 아래 내용에 따라 권한, 프로젝트 그리고 만료 기한을 알맞게 선택해 주세요.

7. 서비스 계정을 생성하면 생성된 계정의 Service Account Username과 Service Account Secret 값을 확인할 수 있습니다. Service Account Secret 값은 팝업창을 닫으면 믹스패널 대시보드에서 다시 확인할 수 없습니다. 따라서 Service Account Secret 값을 별도로 저장하기를 권장합니다.

Service Account Username은 팝업창을 닫고도 생성된 서비스 계정 이름을 클릭해서 다시 확인할 수 있습니다.

Service Account Secret 값을 미리 저장하지 못 했다면 믹스패널 측에 직접 문의하거나 새로운 서비스 계정을 다시 생성해야 합니다.

주의하세요

팝업창을 닫으면 믹스패널 대시보드에서 다시 확인할 수 없는 Service Account Secret 값을 반드시 안전한 위치에 별도로 저장하세요.

  

에어브릿지에서 연동 설정하기

아래 과정을 통해 에어브릿지에서 믹스패널 연동을 설정할 수 있습니다.

1. 에어브릿지 대시보드 [Integrations]>[Third-party Integrations]에서 ‘Mixpanel’을 선택합니다.

 

2. ‘+ 커넥션 추가’를 클릭합니다.

커넥션

커넥션은 믹스패널 연동을 하기 위해 에어브릿지에 추가해야 하는 요소입니다. 커넥션 이름과 믹스패널 연동 정보를 입력하고 에어브릿지에서 믹스패널로 전송하는 이벤트와 프로퍼티를 선택하면 커넥션을 추가할 수 있습니다.
커넥션은 여러 개 추가할 수 있습니다. 단, 여러 개의 커넥션을 동시에 연동할 수 없습니다. 예를 들어 A 커넥션을 연동하다가 B 커넥션을 연동하려면 A 커넥션의 연동을 중지해야 합니다.

 

3. 원하는 커넥션 이름과 믹스패널 대시보드에서 확인한 연동 정보를 각 칸에 알맞게 입력합니다. 이전에 추가한 커넥션이 있다면 중복된 커넥션 이름을 입력할 수 없습니다. Project Token, Service Account Username, Service Account Secret 값은 기존에 추가한 커넥션의 값을 선택할 수 있습니다.

Service Account Username, Service Account Secret에 믹스패널에서 생성된 값을 올바르게 입력하지 않으면 다음 단계로 넘어갈 수 없습니다. 원활하게 연동하기 위해 서비스 계정 관련 값을 포함해 모든 값을 믹스패널에서 정확하게 확인하고 에어브릿지에 입력 바랍니다.

 

4. 에어브릿지에서 믹스패널로 전송할 이벤트를 선택합니다. 처음에는 모든 이벤트가 선택된 상태로 나타납니다. 원하는 이벤트만을 선택하거나 해제할 수 있으며 ‘전체 선택’, ‘전체 해제’를 통해 모든 이벤트를 선택하거나 해제할 수도 있습니다.

에어브릿지 이벤트 중 스탠다드 이벤트는 수집 여부와 관계없이 모두 선택할 수 있습니다. 커스텀 이벤트는 기존에 수집된 이벤트만 선택할 수 있습니다.

 

5. 에어브릿지에서 믹스패널로 전송할 프로퍼티를 선택합니다. 원하는 프로퍼티를 선택하거나 해제할 수 있으며 ‘전체 선택’, ‘전체 해제’를 통해 모든 프로퍼티를 선택하거나 해제할 수도 있습니다. 믹스패널에 반드시 전송해야 하는 8개의 프로퍼티는 전송 여부를 선택할 수 없습니다.

코호트 분석 가능 이벤트

타겟 이벤트인 Install (App), Deeplink Open (App), Deeplink Pageview (App)과 유저 레벨로 업데이트되는 프로퍼티를 선택하면 믹스패널에서 유저 기반의 코호트 분석을 할 수 있습니다. 따라서 에어브릿지의 광고 성과 데이터를 유저 중심으로 분석하고 싶다면 2개의 이벤트와 원하는 프로퍼티를 선택 바랍니다. 유저 레벨로 업데이트되는 프로퍼티 리스트는 참고사항에서 확인할 수 있습니다.

 

6. 특정 이벤트, 특정 프로퍼티를 보내고 싶지 않다면 ‘+ 전송 규칙 추가’를 클릭해서 전송 규칙을 설정할 수 있습니다. 전송 규칙을 설정하지 않아도 커넥션을 추가할 수 있습니다.

7. ‘+ 전송 규칙 추가’를 클릭해서 전송 규칙 이름을 입력하고 전송하지 않을 이벤트 혹은 프로퍼티를 선택합니다. 선택한 이벤트와 프로퍼티의 조건을 다시 이벤트 혹은 프로퍼티별로 선택합니다. 조건은 여러 개 설정할 수 있습니다. 단, 전송하지 않을 이벤트 혹은 프로퍼티에 서로 다른 조건을 설정하려면 2개 이상의 전송 규칙을 따로따로 추가해야 합니다. 전송 규칙 이름은 중복될 수 없습니다.

전송 규칙에서 선택할 수 있는 이벤트와 프로퍼티

전송 규칙에서는 전송할 이벤트를 선택하는 단계에서 선택한 이벤트만 선택할 수 있습니다. 프로퍼티는 모두 선택할 수 있습니다.

아래 이미지처럼 전송 규칙을 설정하면 에어브릿지는 Channel 프로퍼티가 example_channel_1, example_channel_2이고 Term 프로퍼티가 example_term_1, example_term_2가 아닌 회원가입(Sign-up), 로그인(Sign-in), 로그아웃 이벤트(Sign-out)를 믹스패널에 전송하지 않습니다.

 

8. 전송 규칙을 모두 추가했다면 ‘커넥션 추가’를 클릭해 커넥션을 최종적으로 추가합니다. 전송 규칙에 추가된 이벤트는 전송할 이벤트를 고르는 이전 단계로 돌아가서 선택을 해제할 수 없습니다.

9. 커넥션을 추가하면 최초 상태는 비활성화를 의미하는 ‘Inactive’로 표시됩니다. 커넥션을 활성화하고 싶다면 해당 커넥션을 클릭합니다.

 

10. ‘전송 시작’을 클릭합니다. 클릭하면 에어브릿지가 믹스패널에게 선택한 이벤트와 프로퍼티를 전송하기 시작하며 연동이 활성화됩니다. 커넥션 상태는 활성화를 의미하는 ‘Active’로 바뀝니다.

기본 지원 기능

에어브릿지는 GA4를 포함한 유저 행동 분석 서드파티 플랫폼에 대해 전송 여부, 전송 조건, 커넥션 정보와 같은 연동 상태를 수정하거나 연동 상태를 복사 또는 보관할 수 있는 기본적인 기능을 제공합니다.

연동 상태 수정하기

연동 활성화 여부와 관계없이 에어브릿지에서 추가된 커넥션을 클릭하면 어떤 커넥션이든 연동 상태를 수정할 수 있습니다. 전송 여부, 전송 조건, 커넥션 정보를 바꿀 수 있습니다. 활성화(Active)된 커넥션의 연동 상태를 수정하면 의도하지 않은 이벤트와 프로퍼티가 전송될 수 있으니 주의해 주세요.

연동 상태 관리하기

연동 상태를 복사하거나 보관할 수 있습니다.

 

믹스패널에서 연동 데이터 조회하기

연동이 정상적으로 완료되면 믹스패널(Mixpanel)에서 에어브릿지의 데이터를 활용할 수 있습니다. 아래 기본적인 활용 방법을 참고해 주세요.

주의사항

아래 사항을 주의해 주세요.

도움이 되었나요?

더 필요한 내용이 있나요?