- 메시지 이벤트 → Mixpanel: 모든 채널의 전달, 클릭, 실패 등을 추적합니다.
- Cohorts → OneSignal: 행동 기반 Mixpanel Cohort를 OneSignal의 타겟팅 필터로 동기화합니다.
요구 사항
- Mixpanel 계정
- OneSignal 유료 플랜
- External ID가 설정된 OneSignal 앱
이 통합은 사용자를 생성하지 않습니다. 식별자를 매핑하여 Mixpanel의 사용자를 OneSignal의 기존 사용자에 매핑합니다.
설정
OneSignal에 Mixpanel 추가 (아웃바운드)
OneSignal 메시지 이벤트를 Mixpanel 프로젝트로 전송합니다.- OneSignal에서 Data > Integrations > Mixpanel로 이동하여 Activate를 클릭하세요.
Mixpanel에서
- Project Token을 찾아 OneSignal에 복사하여 붙여넣으세요.
- Data Residency를 확인하세요. Mixpanel의 EU 서버를 사용하는 경우 Send events exclusively to Mixpanel’s EU Residency Server 상자를 선택하세요.
메시지 이벤트 선택
Mixpanel로 보내려는 OneSignal 메시지 이벤트를 선택하세요. 완료되면 Activate를 클릭하세요.
Mixpanel에 OneSignal 추가 (인바운드)
Mixpanel Integrations에서 OneSignal을 추가하세요.
OneSignal - APP_NAME과 같이 식별 가능한 이름으로 설정하세요. 여기서 APP_NAME은 OneSignal의 앱 이름입니다.
OneSignal **Settings > Keys & IDs**에서 다음 데이터가 필요합니다:
- App ID
- API Key
User ID 매핑
OneSignal의 **External ID**는 선택한 Mixpanel User ID Property(예:user_id)와 일치해야 합니다. 이 속성이 두 시스템 모두에 설정되어 있는지 확인하세요 — Cohort 동기화 및 이벤트 추적은 정확한 일치에 의존합니다.
완료되면 Continue를 클릭하세요. 이제 Mixpanel에서 OneSignal로 Cohort를 내보내고 OneSignal에서 Mixpanel로 메시지 이벤트를 수집할 수 있습니다.
Mixpanel Cohort를 OneSignal로 내보내기
위에서 설정한 일치하는 External ID를 사용하여 Mixpanel Cohort를 OneSignal로 동기화하세요. 내보내기는 사용자를 생성하지 않습니다 — 각 사용자는 이미 OneSignal에 존재해야 합니다.- Mixpanel에서 Cohort를 만드세요.
- Options > Export to… > OneSignal Connection 이름을 클릭하세요.
- 동기화 빈도를 선택하고 Begin Sync를 누르세요.
OneSignal Segment 생성
동기화된 Cohort는 Mixpanel Segment 필터로 나타납니다. 다음 조건이 충족되면 OneSignal이 Cohort에 대한 Segment를 자동으로 생성합니다:- Mixpanel Cohort의 사용자가 일치하는 External ID를 가진 OneSignal에도 존재합니다.
- OneSignal에서 Segment 제한을 초과하지 않아야 합니다.
Mixpanel은 OneSignal에서 Segment를 생성하려면 최소한 한 명의 일치하는 사용자가 필요합니다. Segment가 생성되면 나중에 Cohort에 사용자가 없더라도 OneSignal에 남아 있습니다. 이 경우 사용자가 다시 추가될 때까지 Segment는 비어 있는 것으로 표시됩니다.
Mixpanel에서 메시지 이벤트 추적
OneSignal은 다음 메시지 이벤트를 Mixpanel로 실시간으로 전송합니다. Data > Integrations > Mixpanel에서 전송할 이벤트를 선택하세요. 테스트하려면 OneSignal에서 자신에게 메시지를 보낸 다음 Mixpanel의 사용자 프로필 페이지로 이동하세요. Activity Feed 내에서 이벤트가 채워지는 것을 볼 수 있습니다.
메시지 이벤트
| Message Event Kind (OneSignal) | Message Event Name (Mixpanel) | Event Description |
|---|---|---|
| Push Sent | Message Sent | Push notification successfully sent |
| Push Received | Message Received | Push notification successfully received |
| Push Clicked | App Opened from Push | Push notification touched on device |
| Push Failed | Push Failed | Push failed to be sent. Check the failed message report in OneSignal. |
| Push Unsubscribed | Push Unsubscribed | The Subscription unsubscribed from push. |
| In-App Impression | Message Sent | In-App Message successfully displayed on device |
| In-App Clicked | Message Opened | In-App Message clicked on device |
| In-App Page Displayed | In-App Page Displayed | In-App Message page is displayed |
| Email Sent | Message Sent | Email successfully sent |
| Email Received | Message Received | Email received by recipient |
| Email Opened | Message Opened | Email opened by recipient |
| Email Link Clicked | App Opened from Push | Email link clicked on |
| Email Unsubscribed | Email Unsubscribed | Email unsubscribed by recipient |
| Email Reported As Spam | Email Reported as Spam | Email reported as spam by recipient |
| Email Bounced | Email Bounced | Email returned to sender due to permanent error |
| Email Failed | Email Failed | Could not deliver the email to the recipient’s inbox |
| Email Suppressed | Email Suppressed | The email address is on your suppression list. Either it bounced or marked your emails as spam. |
| SMS Sent | Message Sent | SMS sent to recipient |
| SMS Failed | SMS Failed | SMS failed to send |
| SMS Delivered | Message Received | SMS successfully delivered |
| SMS Undelivered | SMS Undelivered | The SMS could not be sent. |
이벤트 속성
OneSignal에서 Mixpanel로 보낸 모든 이벤트에는 다음 속성이 포함됩니다:| PROPERTY NAME | DESCRIPTION |
|---|---|
| Distinct ID | 메시지와 연결된 external_id |
| Message ID | 개별 메시지의 식별자 |
| Message Name | 메시지 이름 |
| Message Title | 메시지 제목 |
| Message Contents | 메시지 내용 |
| message_type | 보낸 메시지 유형, 푸시, In-App, 이메일, SMS |
| template_id | 사용된 메시지 템플릿(API 및 Journey 메시지) |
| subscription_id | OneSignal 설정 장치/이메일/SMS 식별자 |
| device_type | 메시지를 받은 장치 유형 |
| language | 장치의 2자 언어 코드 |
| source | onesignal (모든 이벤트의 소스로 표시됨) |
커스텀 이벤트 (서드파티)
Mixpanel 통합은 Mixpanel에서 OneSignal로 커스텀 이벤트 전송을 기본적으로 지원하지 않습니다. Amplitude와 달리 Mixpanel에서 OneSignal로의 내장 이벤트 대상이 없습니다. Mixpanel 행동 이벤트를 OneSignal에 커스텀 이벤트로 라우팅하여 Journey 또는 Segment를 트리거해야 하는 경우 Vendo와 같은 서드파티 커넥터를 사용할 수 있습니다. Vendo는 선택한 Mixpanel 이벤트를 캠페인 트리거를 위해 커스텀 이벤트로 OneSignal에 스트리밍합니다.FAQ
Cohort 및 Segment 수가 일치하지 않는 이유는 무엇인가요?
- 누락되거나 일치하지 않는 External ID 일치하는 OneSignal External ID 및 Mixpanel User ID가 있는 사용자만 포함됩니다. 이 통합은 사용자 또는 Subscription을 생성하지 않습니다.
- 구독 취소한 사용자 OneSignal Segment는 구독된 Subscription의 수만 표시합니다. 구독 취소한 Subscription은 Journey 또는 In-App 메시지에서 사용할 수 있습니다.
- OneSignal에 존재하지 않거나 잘못된 External ID를 가지고 있습니다.
- 구독 취소한 Subscription을 가지고 있습니다.
구독 취소한 사용자가 Mixpanel에서 동기화되나요?
예, 하지만 현재 OneSignal Segment 수에서 제외됩니다. 다른 Subscription이 있거나 Subscription 유형이 지원하는 경우 Journey 또는 In-App 메시지를 통해 여전히 메시지를 보낼 수 있습니다.전달 데이터가 일치하지 않는 이유는 무엇인가요?
단일 사용자는 여러 Subscription(푸시 장치, 이메일 주소, 전화번호)을 가질 수 있습니다. 각 Subscription은 자체 전달 이벤트를 생성합니다. 예:- 1명의 사용자 = 2 Android + 1 iOS + 2 Web = 5개의 푸시 Subscription
- 1개의 푸시 메시지 = 최대 5개의 sent/received/clicked 이벤트
subscription_id를 사용하여 정확한 소스를 추적하세요.
누락된 이벤트 문제를 해결하려면:
- 사용자가 식별될 때마다
OneSignal.login이 호출되어 External ID가 설정되는지 확인하세요. OneSignal.logout이 External ID를 제거하지 않는지 확인하세요.- External ID를 변경할 수 있는 API 요청 또는 CSV 업로드를 확인하세요.
Mixpanel에서 OneSignal로 커스텀 이벤트를 보낼 수 있나요?
기본적으로는 불가능합니다. Mixpanel 통합은 메시지 이벤트(OneSignal → Mixpanel) 및 코호트 동기화(Mixpanel → OneSignal)를 지원하지만 내장된 커스텀 이벤트 대상을 포함하지 않습니다. Mixpanel 이벤트를 OneSignal에 커스텀 이벤트로 라우팅하려면 Vendo와 같은 서드파티 커넥터를 사용하세요.사용자/Subscription 이벤트를 어떻게 보낼 수 있나요?
사용자 및 Subscription 수준 이벤트(예: 권한 부여됨, 사용자 로그인/로그아웃)는 자동으로 전송되지 않습니다. OneSignal SDK에는 이러한 이벤트를 추적하여 Mixpanel로 보낼 수 있는 이벤트 리스너가 있습니다:- User State Observer: Mobile SDK, Web SDK
- Permission Observer: Mobile SDK, Web SDK
관련 페이지
분석 개요
OneSignal 분석, 배송 지표 및 이벤트 추적 개요.
커스텀 이벤트
Journey를 트리거하거나 분석을 강화하기 위해 사용자 액션을 추적합니다.
Need help?Chat with our Support team or email
support@onesignal.comPlease include:- Details of the issue you’re experiencing and steps to reproduce if available
- Your OneSignal App ID
- The External ID or Subscription ID if applicable
- The URL to the message you tested in the OneSignal Dashboard if applicable
- Any relevant logs or error messages