믹스패널

에어브릿지는 믹스패널(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’를 클릭해서 새로운 서비스 계정을 만들어야 합니다. 원하는 서비스 계정 이름을 입력하고 권한, 프로젝트 그리고 만료 기한을 선택하고 나서 ‘Create’를 클릭합니다.

• 권한(ROLE): ORGANIZTION ROLE은 Admin 혹은 Owner로 설정해야 합니다. 다른 권한으로 설정하면 에어브릿지와 믹스패널을 연동할 수 없습니다. PROJECT ROLE은 어떤 권한을 선택해도 연동에 영향을 주지 않습니다. 설명에 따라 원하는 권한을 선택 바랍니다.
• 프로젝트(PROJECTS): 에어브릿지와 연동할 때 사용할 Project ID, Project Token 값을 확인한 프로젝트로 설정해야 합니다. 다른 프로젝트로 설정하면 에어브릿지와 믹스패널을 연동할 수 없습니다.
• 만료 기한(EXPIRES): Never를 선택하면 해당 서비스 계정은 만료되지 않습니다. Specify…를 선택하면 특정 만료 기한을 설정할 수 있습니다. 서비스 계정이 만료되면 에어브릿지와 믹스패널의 연동이 중단될 수 있으니 Never를 선택하기를 권장합니다.

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

단, Service Account Secret 값은 팝업창을 닫으면 믹스패널 대시보드에서 다시 확인할 수 없습니다. 따라서 Service Account Secret 값을 별도로 저장하기를 권장합니다.

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)과 유저 레벨로 업데이트되는 프로퍼티를 선택하면 믹스패널에서 유저 기반의 코호트 분석을 할 수 있습니다. 따라서 에어브릿지의 광고 성과 데이터를 유저 중심으로 분석하고 싶다면 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’로 바뀝니다.

연동 상태 수정

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

전송 여부

커넥션의 연동을 활성화하려면 연동 설정 방법의 마지막 단계처럼 비활성화(Inactive) 상태의 커넥션을 선택하고 ‘전송 시작’을 클릭합니다.

반대로 커넥션의 연동을 비활성화하려면 활성화 상태의 커넥션을 선택하고 톱니바퀴 모양의 아이콘이 그려진 ‘관리’와 ‘전송 중지’를 클릭합니다. 연동하려는 커넥션을 바꿀 때도 아래 이미지처럼 기존 커넥션에서 전송 중지부터 해야 합니다.

기존 커넥션에서 전송을 중지하지 않으면 새롭게 연동하고 싶은 커넥션에서 ‘전송 시작’을 클릭할 수 없습니다.

전송 조건

이벤트 스키마

[이벤트 스키마]에서 해당 커넥션에 설정된 이벤트와 프로퍼티를 원하는 대로 선택하거나 해제할 수 있습니다. 왼쪽의 ‘Events’에서는 현재 커넥션에서 선택된 모든 이벤트를 확인할 수 있습니다. 특정 키워드로 검색하면 이벤트와 프로퍼티에 입력한 검색어가 포함된 검색 결과를 볼 수 있습니다.

예를 들어, 아래 이미지처럼 ‘Si’라고 검색하면 에어브릿지는 Sign-in (App), Sign-out (App), Sign-up (App) 같은 이벤트 외에도 OS Version, App Version 같은 프로퍼티를 가진 이벤트를 함께 보여줍니다.

‘설정’ 버튼 혹은 이벤트를 선택했을 때 [프로퍼티 설정]에 나오는 프로퍼티 오른쪽에 있는 톱니바퀴 모양의 아이콘을 클릭하면 이벤트와 프로퍼티 선택 여부를 바꿀 수 있습니다. 단, 전송 규칙이 적용된 이벤트는 선택을 해제할 수 없습니다.

[적용된 규칙]에서는 현재 이벤트별로 적용된 전송 규칙을 확인할 수 있습니다. 톱니바퀴 모양의 아이콘을 클릭해서 전송 규칙의 조건을 바꿀 수 있습니다. 단, 새로운 전송 규칙을 추가할 수 없으며 추가하려면 [이벤트 스키마]가 아닌 [전송 규칙]으로 이동해야 합니다.

[전송 규칙]을 삭제할 수도 있습니다.

전송 규칙

[전송 규칙]에서는 커넥션에 추가된 전송 규칙을 한눈에 모아볼 수 있습니다. [이벤트 스키마]의 [적용된 규칙]과 마찬가지로 이미 추가된 전송 규칙을 수정, 삭제할 수 있습니다. 또한, 현재 추가된 전송 규칙을 CSV 혹은 구글 스프레드시트 형태로 다운로드하거나 새로운 전송 규칙을 추가할 수도 있습니다.

커넥션 정보

[커넥션 정보] 탭에서 커넥션 이름과 마스킹(masking)되어서 일부 값만 보이는 믹스패널의 연동 정보를 변경할 수 있습니다. 현재 선택한 이벤트, 프로퍼티 개수와 커넥션을 생성하고 아카이브한 일시, 계정도 확인할 수 있습니다. 커넥션 이름과 연동 정보를 바꾸고 싶다면 ‘수정’을 클릭합니다.

커넥션 이름, Project ID를 바꾸려면 직접 원하는 이름과 값을 입력해야 합니다. Project Token, Service Account Username, Service Account Secret에서는 기존에 추가한 커넥션의 값을 그대로 가져올 수 있습니다.

3개의 연동 정보 중 어떤 연동 정보에서 기존 커넥션의 값을 클릭하더라도 나머지 2개의 값이 자동으로 입력됩니다. 예를 들어 아래 이미지에서 Project Token에서 example_예시_01의 값을 선택하면 Service Account Username, Service Account Secret에서도 example_예시_01의 값이 선택됩니다.

연동 상태 복사, 보관

‘복제’ 버튼으로 추가한 커넥션의 상태를 그대로 복사해서 새로운 커넥션을 만들 수 있습니다. 더이상 사용하지 않는 커넥션이라면 ‘아카이브’ 버튼으로 커넥션을 보관할 수 있습니다.

커넥션 복제

‘복제’를 클릭하면 커넥션 이름을 제외한 해당 커넥션의 설정 상태가 입력된 팝업창이 나타납니다. 설정을 바꾸지 않고 그대로 커넥션을 추가하면 설정 상태가 똑같은 커넥션을 새롭게 만들 수 있습니다.

커넥션 아카이브

‘아카이브’를 클릭하면 해당 커넥션을 아카이브할 때 발생하는 현상을 공지하는 팝업창이 나타납니다. 아카이브한 커넥션은 에어브릿지와 믹스패널을 연동할 때 다시 쓸 수 없습니다. 단, 에어브릿지가 이미 전달한 데이터는 믹스패널에 남습니다. 아카이브를 원한다면 커넥션 이름을 입력하고 ‘아카이브’를 클릭합니다.

아카이브한 커넥션은 [Archived Connection]에 보관됩니다. 아카이브한 커넥션의 설정 상태는 커넥션별로 언제나 확인할 수 있습니다. 또한 커넥션을 연동에 다시 사용할 수 없지만 ‘복제’ 버튼을 통해 설정 상태가 같은 커넥션을 새롭게 만들 수 있습니다.

연동 데이터 조회

연동이 정상적으로 완료되면 믹스패널에서 에어브릿지의 데이터를 활용할 수 있습니다. 믹스패널 대시보드에서 [Boards]와 ‘+ Add’ 혹은 [Reports]를 클릭하면 원하는 형태와 기능의 리포트를 만들 수 있습니다.

생성한 리포트의 ‘Events & Cohorts’에서 에어브릿지에서 믹스패널로 전송한 이벤트를 선택할 수 있습니다. ‘Filter’와 ‘Breakdown’에서는 전송한 프로퍼티를 선택할 수 있습니다.

조건을 설정하면 오른쪽에 시각화된 차트와 테이블로 데이터가 표시됩니다. 예를 들어 아래 이미지처럼 조건을 설정하면 광고 그룹이 20~30대인 유저가 발생시킨 앱 설치 이벤트 수를 채널 단위로 분석할 수 있습니다.

[Users]에서는 유저 단위로 데이터를 확인할 수 있습니다. 아래 이미지처럼 필터를 설정하면 미기여(unattributed)된 유저만을 모아서 볼 수 있습니다.

[Events]에서는 발생한 이벤트 단위로 데이터를 확인할 수 있습니다. [Users]와 마찬가지로 필터를 설정해서 특정 이벤트만 모아서 볼 수 있습니다. 이벤트를 발생시킨 Distinct ID를 클릭하면 [Users]에서 유저를 클릭할 때처럼 해당 Distinct ID의 유저 데이터가 나타납니다.

참고사항

유저 매칭

에어브릿지와 믹스패널을 연동할 때 아래 우선순위에 따라 여러 가지 식별자가 유저 매칭에 사용됩니다.

1. Distinct ID(device.alias.mixpanel_device_id)

2. Distinct ID(user.alias.mixpanel_device_id)

3. 에어브릿지 디바이스 ID(device.deviceUUID)

4. 브라우저 클라이언트 ID(browser.clientID)

믹스패널의 디바이스 ID인 Distinct ID를 가져오지 않으면 에어브릿지는 환경(앱, 웹)에 따라 각각 에어브릿지 디바이스 ID와 브라우저 클라이언트 ID를 믹스패널에 전송합니다. Distinct ID가 아닌 다른 식별자를 바탕으로 데이터를 전송하면 에어브릿지와 믹스패널 사이에서 유저 매칭 확률이 떨어집니다.

에어브릿지와 믹스패널 사이에서 유저가 매칭되지 않으면 믹스패널은 기존 유저 데이터 존재 여부와 관계없이 해당 유저를 별도의 유저로 인식합니다. 이에 따라 믹스패널에서 분석하는 유저 수가 과장되고 필요 이상의 이용 금액이 과금될 수 있습니다.

믹스패널에서 에어브릿지의 데이터를 최적의 금액으로 정교하게 분석하고 싶다면 사전 연동 준비 작업을 반드시 진행해야 합니다.

에어브릿지 디바이스 ID

에어브릿지 디바이스 ID는 에어브릿지가 고유한 디바이스를 식별하기 위해 사용하는 범용 고유 식별자(Device UUID)입니다. 기본적으로 OS별 광고 식별자(안드로이드-GAID, iOS-IDFA)가 에어브릿지 디바이스 ID의 값으로 사용됩니다.

만약 LAT(Limited Ad Tracking, 광고 추적 제한)나 ATT(App Tracking Transparency, 앱 추적 투명성) 정책으로 인해 GAID나 IDFA를 수집하지 못 했거나 사용할 수 없다면 OS에 따라 IDFV 또는 Random Generated 값이 사용됩니다.

메타 비즈니스 데이터

메타 비즈니스(Meta Business) 광고 캠페인에 기여된 데이터는 메타 개인정보보호정책에 따라 서드파티 플랫폼에 전송되거나 공유될 수 없습니다. 이 데이터는 오직 광고를 집행하는 주체가 메타 비즈니스 광고 성과 분석을 목적으로 내부적으로만 사용할 수 있습니다.

이러한 메타의 정책을 준수하기 위해 에어브릿지는 대시보드에서 Channel이 facebook.business인 메타 비즈니스 데이터를 미기여(unattributed)로 표시해서 믹스패널에 전달합니다. 따라서 믹스패널에서 메타 비즈니스 기여 여부를 확인할 수 없습니다.

코호트 분석 가능 이벤트

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

유저 레벨로 업데이트되는 프로퍼티 리스트는 아래와 같습니다.

이름	설명
Touchpoint
Channel	터치포인트와 전환이 발생한 채널
Campaign	터치포인트와 전환이 발생한 캠페인
Ad Group	터치포인트와 전환이 발생한 광고 그룹
Ad Creative	터치포인트와 전환이 발생한 광고 소재
Content	터치포인트와 전환이 발생한 광고 형태
Term	터치포인트와 전환이 발생한 광고 키워드
Sub Publisher	터치포인트와 전환이 발생한 서브 퍼블리셔
Sub Publisher 1	터치포인트와 전환이 발생한 서브 퍼블리셔 1
Sub Publisher 2	터치포인트와 전환이 발생한 서브 퍼블리셔 2
Sub Publisher 3	터치포인트와 전환이 발생한 서브 퍼블리셔 3
Campaign ID	터치포인트와 전환이 발생한 캠페인 ID
Ad Group ID	터치포인트와 전환이 발생한 광고 그룹 ID
Ad Creative ID	터치포인트와 전환이 발생한 광고 소재 ID
User
User ID	터치포인트와 전환을 발생시킨 유저 ID
Hashed User ID	터치포인트와 전환을 발생시킨 유저 ID(해시됨)
User Email	터치포인트와 전환을 발생시킨 유저 이메일
Hashed User Email	터치포인트와 전환을 발생시킨 유저 이메일(해시됨)
User Phone	터치포인트와 전환을 발생시킨 유저 전화번호
Hashed User Phone	터치포인트와 전환을 발생시킨 유저 전화번호(해시됨)
Custom User Properties	커스텀 유저 속성

전송 이벤트 개수

에어브릿지는 에어브릿지 이벤트 택소노미 설계에 따라 하나의 이벤트를 상품(product)별로 쪼개서 믹스패널에 여러 개의 이벤트로 전송합니다. 에어브릿지와 믹스패널이 상품 관련 시맨틱 어트리뷰트(Semantic Attributes)를 사용하는 이벤트에 여러 상품이 담겨 있을 때 이벤트를 서로 다른 방식으로 기록하기 때문입니다. 어트리뷰트 이름에 products.$0이 붙는 시맨틱 어트리뷰트는 모두 상품에 관한 어트리뷰트입니다.

예시) 전송 이벤트 상품별 분할 시나리오

아래처럼 택소노미를 설계하면 입력한 어트리뷰트에 따라 구매 완료(Order Complete) 이벤트가 발생했을 때 구매한 상품별로 상품 ID(Product ID)가 기록됩니다.

카테고리	액션	라벨	밸류	어트리뷰트
airbridge.ecommerce.order.completed	-	-	-	eventData.goal.semanticAttributes.products.$0.productID

이 택소노미를 바탕으로 상품이 5개 담긴 구매 완료 이벤트 1건이 에어브릿지에 기록되면 믹스패널에서는 5건의 구매 완료 이벤트가 기록됩니다.

• 에어브릿지 - 구매 완료 이벤트 1건
• 믹스패널 - 구매 완료 이벤트 5건