> ## Documentation Index
> Fetch the complete documentation index at: https://guide.blux.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mixpanel 연동

> Mixpanel에서 수집한 데이터를 Blux로 적재하는 방법을 소개합니다

Mixpanel을 사용하시는 경우 **추가 개발 없이 Blux와 데이터 연동**을 진행할 수 있습니다.

Mixpanel의 cohort(코호트) 정보를 Blux에서 메시지를 보낼 때 대상 유저로 활용할 수 있으며 Blux에서 메시지를 보낸 결과를 Mixpanel로 export해 분석할 수 있습니다.

Mixpanel에서 데이터 연동을 하기 위해서는 Growth 또는 Enterprise 플랜을 사용하고 있어야 합니다.

👉 [Mixpanel 가격 정책](https://mixpanel.com/pricing/)

***

## \[Import] Mixpanel → Blux

Mixpanel에서 Blux로 데이터를 import하는 경우 Mixpanel에서 지정한 cohort를 Blux에서도 사용하거나 Mixpanel 통해서 기록하는 이벤트 데이터를 Blux에서 사용하실 수 있습니다.

### 1️⃣ Mixpanel Cohort(코호트) 가져오기

Blux에서 캠페인을 보낼 때 발송 대상에서 커스텀 세그먼트를 통해 연동 된 Mixpanel의 cohort를 불러올 수 있으며 추가 유저 필터를 설정할 수 있습니다.

연동하는 방법은 아래와 같습니다.

1. **Settings > Integrations 에서 새로운 Integration 만들기**

<Frame caption="Mixpanel Integration 생성 페이지">
  <img src="https://mintcdn.com/blux/3xdkiIblCm0x0jvU/10.integration/mixpanel_imgs/image0.png?fit=max&auto=format&n=3xdkiIblCm0x0jvU&q=85&s=d5ed0c92d518a0566ef12870eaff00af" width="3014" height="1514" data-path="10.integration/mixpanel_imgs/image0.png" />
</Frame>

2. **Custom Webhook > Connect 에서 새로운 Custom Webhook 추가하기**

<Frame caption="Mixpanel Cohort 가져오기 페이지">
  <img src="https://mintcdn.com/blux/3xdkiIblCm0x0jvU/10.integration/mixpanel_imgs/image1.png?fit=max&auto=format&n=3xdkiIblCm0x0jvU&q=85&s=c990be3da915078fbda2f416d7a2c815" width="3020" height="1510" data-path="10.integration/mixpanel_imgs/image1.png" />
</Frame>

3. **커넥션 정보 입력하기**

| **필드명**        | **값 (예시)**                                                     | **설명**                                               |
| -------------- | -------------------------------------------------------------- | ---------------------------------------------------- |
| CONNECTOR NAME | Mixpanel 코호트                                                   | 전달할 코호트 이름을 작성하면 됩니다.                                |
| URL            | `api.blux.ai/integrations/`<br />`mixpanel/{ APPLICATION_ID }` | Blux에서 제공하는 웹훅 URL로 Mixpanel에서 데이터를 받기 위해 입력이 필요합니다. |
| USERNAME       | `{ APPLICATION_ID }`                                           | 고객님의 서비스를 고유하게 식별하는 값입니다.                            |
| PASSWORD       | `{ SECRET_KEY }`                                               | 인증을 위한 보안 키 입니다.                                     |

4. **Cohort 중에 하나를 선택해서 export하기**

<Frame caption="Mixpanel Cohort 가져오기 페이지">
  <img src="https://mintcdn.com/blux/3xdkiIblCm0x0jvU/10.integration/mixpanel_imgs/image2.png?fit=max&auto=format&n=3xdkiIblCm0x0jvU&q=85&s=5a8297aa1ccf892b6393828af41f8453" width="3008" height="1514" data-path="10.integration/mixpanel_imgs/image2.png" />
</Frame>

### 2️⃣ Mixpanel Event 데이터 가져오기

Mixpanel에서 이벤트 데이터를 적재하고 계시다면, 별도의 개발 없이 해당 데이터를 Blux에서 사용하실 수 있습니다.

Blux 담당자에게 Mixpanel에서 확인할 수 있는 **Project ID**와 **Settings > Mixpanel에서 Token** 정보를 전달해주시면 됩니다.

데이터의 경우 1시간 주기로 Mixpanel에서 Blux쪽으로 import됩니다.

<Warning>
  앱 푸시를 사용할 예정인 경우 SDK 연동이 필수이므로 위 연동 방법은 권장되지 않습니다.
</Warning>

***

## \[Export] Blux → Mixpanel

Blux에서 Mixpanel로 이벤트 데이터 (고객 행동 데이터)를 export 하여 데이터를 확인할 수 있습니다.

이벤트 데이터에는 각 채널별 메시지 수신, 오픈, 버튼 클릭과 같은 CRM 메시지에 해당하는 데이터와 인앱에서의 구매, 클릭과 같은 데이터가 있습니다.

이 중 Mixpanel을 통해서 더 구체적으로 확인하고 싶은 이벤트에 대해서 export를 진행하실 수 있습니다.

데이터의 경우 1시간 주기로 export 되어 믹스패널에서 확인하실 수 있습니다.

**✅ 이벤트 예시**

| 이벤트 명                       | 설명          |
| --------------------------- | ----------- |
| message\_received           | 메시지 수신      |
| push\_opened                | 푸시 메시지 오픈   |
| inapp\_opened               | 인앱 메시지 오픈   |
| alimtalk\_button\_clicked   | 알림톡 버튼 클릭   |
| friendtalk\_button\_clicked | 친구톡 버튼 클릭   |
| email\_link\_clicked        | 이메일 링크 클릭   |
| sms\_link\_clicked          | 문자 링크 클릭    |
| product\_detail\_view       | 인앱에서의 상품 클릭 |
| purchase                    | 인앱에서의 상품 구매 |

<Warning>
  Export되는 데이터 양에 비례하여 Mixpanel의 과금이 청구되기 때문에 선택적으로 데이터 export을 진행하는 것을 권장드립니다.
</Warning>

**만약 export가 필요하다면 Blux 담당자에게 Settings > Mixpanel 에서 Token을 전달해주세요.**

<Frame caption="Mixpanel Token 전달 페이지">
  <img src="https://mintcdn.com/blux/3xdkiIblCm0x0jvU/10.integration/mixpanel_imgs/image4.png?fit=max&auto=format&n=3xdkiIblCm0x0jvU&q=85&s=4e7d870c1f8f3da45f6b6aed66bdd0af" width="3000" height="1254" data-path="10.integration/mixpanel_imgs/image4.png" />
</Frame>