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

# Mixpanel

> OneSignalとMixpanelを統合して、行動コホートを同期し、メッセージイベントを追跡し、プッシュ、メール、SMS、アプリ内チャネル全体でユーザーをターゲティングします。

OneSignalを[Mixpanel](https://mixpanel.com)と統合して、プッシュ、アプリ内、メール、SMS全体でリアルタイムの行動ベースのターゲティングを有効にします。このアプリレベルの統合は2つのデータフローをサポートします：

* **メッセージイベント → Mixpanel**：全チャネルの配信、クリック、失敗などを追跡します。
* **コホート → OneSignal**：行動ベースのMixpanelコホートをOneSignalのターゲティングフィルターとして同期します。

<Warning>
  Mixpanelは現在、[カスタムイベント](./custom-events)をOneSignalに送信していません。MixpanelのイベントをOneSignalにルーティングする必要がある場合は、[Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal)などのサードパーティコネクタを使用してください。
</Warning>

***

## 要件

* [Mixpanelアカウント](https://mixpanel.com/)
* [OneSignal有料プラン](https://onesignal.com/pricing)
* 外部IDが設定されたOneSignalアプリ。

<Info>
  この統合はユーザーを作成しません。識別子を照合することで、MixpanelのユーザーをOneSignalの既存ユーザーにマッピングします。
</Info>

***

## セットアップ

### MixpanelをOneSignalに追加する（アウトバウンド）

OneSignalのメッセージイベントをMixpanelプロジェクトに送信します。

1. OneSignalで、**データ > 統合 > Mixpanel**に移動し、**アクティベート**をクリックします。

<Frame caption="OneSignalでMixpanel統合を有効にする">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/f5dfbab5a6c41ae816e34401b7fa5a8624e15d43f90ad723c4c7b2166dbd66de-Screenshot_2025-03-18_at_8.15.13_AM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=4c5a9ba2e4e2a2c8b2e2b2b2376253f1" alt="OneSignal Integrations page with Mixpanel selected" width="1150" height="458" data-path="images/docs/f5dfbab5a6c41ae816e34401b7fa5a8624e15d43f90ad723c4c7b2166dbd66de-Screenshot_2025-03-18_at_8.15.13_AM.png" />
</Frame>

#### Mixpanelで

1. [プロジェクトトークン](https://docs.mixpanel.com/docs/orgs-and-projects/managing-projects#find-your-project-tokens)を見つけて、OneSignalにコピー＆ペーストします。
2. [データレジデンシー](https://docs.mixpanel.com/docs/orgs-and-projects/managing-projects#project-details)を確認します。MixpanelのEUサーバーを使用している場合は、**Send events exclusively to Mixpanel's EU Residency Server**ボックスにチェックを入れます。

#### メッセージイベントを選択する

Mixpanelに送信するOneSignalメッセージイベントを選択します。完了したら、**アクティベート**をクリックします。

<Frame caption="OneSignalでのMixpanel設定">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/bc980ae-Screenshot_2024-06-04_at_10.18.59_AM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=b98514269a60a2144c1dc0334969e7d3" alt="OneSignal Mixpanel integration settings showing event selection" width="2216" height="1412" data-path="images/docs/bc980ae-Screenshot_2024-06-04_at_10.18.59_AM.png" />
</Frame>

### OneSignalをMixpanelに追加する（インバウンド）

Mixpanelの**統合**で、OneSignalを追加します。

<Frame caption="MixpanelにOneSignal統合を追加する">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/mixpanel-integration.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=b4e6bc1f405b2087b455b2942ce5aecd" alt="Mixpanel integrations catalog with OneSignal selected" width="2986" height="1300" data-path="images/docs/mixpanel-integration.png" />
</Frame>

**コネクタ名**を`OneSignal - APP_NAME`のように識別可能なものに設定します。ここで`APP_NAME`はOneSignalのアプリの名前です。

OneSignalの\*\*設定 > [キーとID](./keys-and-ids)\*\*で次のデータが必要です：

1. App ID
2. APIキー

### ユーザーIDマッピング

<Warning>
  このステップは、コホート同期とイベント追跡が正しく機能するために不可欠です。
</Warning>

OneSignalの\*\*[外部ID](./users)\*\*は、選択されたMixpanelユーザーIDプロパティ（例：`user_id`）と一致する必要があります。このプロパティが両方のシステムで入力されていることを確認してください — コホート同期とイベント追跡は完全一致に依存しています。

<Frame caption="OneSignalプロパティを設定するためのMixpanelダッシュボード">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b5e818708efcc73ea8eb0cccb6542c205069b395978b8fa796af28d816b33356-Screenshot_2025-03-18_at_11.22.54_AM.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=c161191d039f187a20df7201d9ca71db" alt="Mixpanel OneSignal connector settings showing User ID property selection" width="864" height="900" data-path="images/docs/b5e818708efcc73ea8eb0cccb6542c205069b395978b8fa796af28d816b33356-Screenshot_2025-03-18_at_11.22.54_AM.png" />
</Frame>

選択した**ユーザーIDプロパティ**がMixpanelユーザープロファイルプロパティで利用可能であることを確認します。

<Frame caption="Mixpanel > ユーザー > ユーザープロファイルプロパティ">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4416681-small-Screenshot_2023-05-15_at_9.54.14_AM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=e89ad019a61077ae376fc92e1a1eb87a" alt="Mixpanel user profile properties list" width="521" height="1024" data-path="images/docs/4416681-small-Screenshot_2023-05-15_at_9.54.14_AM.png" />
</Frame>

ユーザープロファイルプロパティのMixpanelの同じ値は、OneSignalの外部IDと一致する必要があります。

<Frame caption="OneSignal > オーディエンス > ユーザー > 外部ID">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e6853b59781b29ccbd264f97925830986605ec5514d02b5435c27ec896804a89-Screenshot_2025-03-18_at_10.22.25_AM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=9a0b4237233c0492901853d72a6b1b63" alt="OneSignal user profile showing External ID" width="2764" height="686" data-path="images/docs/e6853b59781b29ccbd264f97925830986605ec5514d02b5435c27ec896804a89-Screenshot_2025-03-18_at_10.22.25_AM.png" />
</Frame>

<Warning>
  Mixpanelの`$distinct_id`に基づいてOneSignalにユーザーを照合する場合、最上位の値のみと一致します。

  以下の例では、`890ea9b1-9024-4fb9-a92f-152ba67dd21a`のみが機能します。`109768518080488203109`または`$device:1880c06821f1b3-052354675cde95-1d525634-1fa400-1880c06821f1b3`とは一致しません。
</Warning>

<Frame caption="ユーザーIDプロパティマッピングに使用する場合は、Distinct IDを設定する際に注意してください">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e7b80eb-small-Screenshot_2023-05-15_at_10.07.10_AM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=ef1999c6f01a48063d98e7e2ea330052" alt="Mixpanel Distinct ID example showing multiple values" width="464" height="314" data-path="images/docs/e7b80eb-small-Screenshot_2023-05-15_at_10.07.10_AM.png" />
</Frame>

<Check>
  完了したら**続行**をクリックします。これで、MixpanelからOneSignalにコホートをエクスポートし、OneSignalからMixpanelにメッセージイベントを収集できるようになります。
</Check>

***

## MixpanelコホートをOneSignalにエクスポートする

上記で設定した一致する外部IDを使用して、MixpanelコホートをOneSignalに同期します。エクスポートしても**ユーザーは作成されません** — 各ユーザーはOneSignalにすでに存在している必要があります。

1. Mixpanelでコホートを作成します。
2. **オプション > エクスポート先... > *OneSignal接続名***をクリックします。

<Frame caption="MixpanelコホートをOneSignalにエクスポートする方法">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/187698db55979af5f5c94d672ada1e0c8d7329d600a650e3115b77077ef99237-Screenshot_2025-03-18_at_12.04.16_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=fce16e4cde30d69f3b24a947cf71c937" alt="Mixpanel cohort export menu with OneSignal destination" width="2432" height="1008" data-path="images/docs/187698db55979af5f5c94d672ada1e0c8d7329d600a650e3115b77077ef99237-Screenshot_2025-03-18_at_12.04.16_PM.png" />
</Frame>

3. 同期頻度を選択し、**同期を開始**を押します。

<Frame caption="Mixpanel頻度オプション">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c6b36cedac01d722acaa4240225ea6d10519458682f4c2844d681b8ee34b236e-Screenshot_2025-03-18_at_12.12.06_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=5bb3a035bfb3bea7d78553e86ccb943b" alt="Mixpanel cohort sync frequency selection dialog" width="860" height="896" data-path="images/docs/c6b36cedac01d722acaa4240225ea6d10519458682f4c2844d681b8ee34b236e-Screenshot_2025-03-18_at_12.12.06_PM.png" />
</Frame>

### OneSignalセグメント作成

同期されたコホートは、**Mixpanelセグメントフィルター**として表示されます。次の条件が満たされている場合、OneSignalはコホート用のセグメントを自動的に作成します：

* Mixpanelコホート内のユーザーが、一致する外部IDを持つOneSignalにも存在する。
* OneSignalのセグメント制限を超えていない。

<Note>
  MixpanelはOneSignalでセグメントを作成するために少なくとも1人の一致するユーザーを必要とします。セグメントが作成されると、後でコホートにユーザーがいなくなっても、OneSignalに残ります。その場合、ユーザーが再び追加されるまでセグメントは空として表示されます。
</Note>

<Frame caption="Mixpanelコホートからセグメントを作成する">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7b01785ad5a5f85377bdb20e664e5d5c38280cff56373d70726621569668907d-Screenshot_2025-03-18_at_12.38.47_PM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=3ba94cf6588a4158a86e77c4a23c3e34" alt="OneSignal Segment builder using Mixpanel Cohort filter" width="1444" height="818" data-path="images/docs/7b01785ad5a5f85377bdb20e664e5d5c38280cff56373d70726621569668907d-Screenshot_2025-03-18_at_12.38.47_PM.png" />
</Frame>

***

## Mixpanelでメッセージイベントを追跡する

OneSignalは以下のメッセージイベントをリアルタイムでMixpanelに送信します。**データ > 統合 > Mixpanel**で送信するイベントを選択します。

テストするには、OneSignalから自分にメッセージを送信し、Mixpanelのユーザープロファイルページに移動します。アクティビティフィード内に、イベントが表示されるはずです。

<Frame caption="OneSignalメッセージイベントを含むMixpanelアクティビティフィード">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c344970fd85bda82f9b6bedf1700a9cbb91afd63afc9fe1e866c42e1b380770e-Screenshot_2025-03-18_at_1.59.23_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=9ca542f553f6c08a15ca99d52d68be2b" alt="Mixpanel user activity feed showing OneSignal message events" width="2420" height="1654" data-path="images/docs/c344970fd85bda82f9b6bedf1700a9cbb91afd63afc9fe1e866c42e1b380770e-Screenshot_2025-03-18_at_1.59.23_PM.png" />
</Frame>

### メッセージイベント

| メッセージイベントの種類（OneSignal） | メッセージイベント名（Mixpanel）   | イベントの説明                                           |
| ----------------------- | ---------------------- | ------------------------------------------------- |
| Push Sent               | Message Sent           | プッシュ通知が正常に送信されました                                 |
| Push Received           | Message Received       | プッシュ通知が正常に受信されました                                 |
| Push Clicked            | App Opened from Push   | デバイスでプッシュ通知がタップされました                              |
| Push Failed             | Push Failed            | プッシュの送信に失敗しました。OneSignalの失敗メッセージレポートを確認してください     |
| Push Unsubscribed       | Push Unsubscribed      | [サブスクリプション](./subscriptions)がプッシュからサブスクライブ解除されました |
|                         |                        |                                                   |
| In-App Impression       | Message Sent           | アプリ内メッセージがデバイスに正常に表示されました                         |
| In-App Clicked          | Message Opened         | デバイスでアプリ内メッセージがクリックされました                          |
| In-App Page Displayed   | In-App Page Displayed  | アプリ内メッセージページが表示されます                               |
|                         |                        |                                                   |
| Email Sent              | \$campaign\_delivery   | メールが正常に送信されました                                    |
| Email Received          | Message Received       | 受信者がメールを受信しました                                    |
| Email Opened            | Message Opened         | 受信者がメールを開封しました                                    |
| Email Link Clicked      | App Opened from Push   | メールリンクがクリックされました                                  |
| Email Unsubscribed      | Email Unsubscribed     | 受信者がメールをサブスクライブ解除しました                             |
| Email Reported As Spam  | Email Reported As Spam | 受信者がメールをスパムとして報告しました                              |
| Email Bounced           | Email Bounced          | 永続的なエラーによりメールが送信者に返されました                          |
| Email Failed            | Email Failed           | 受信者の受信トレイにメールを配信できませんでした                          |
| Email Suppressed        | Email Suppressed       | メールアドレスが抑制リストに含まれています。バウンスされたか、メールをスパムとしてマークされました |
|                         |                        |                                                   |
| SMS Sent                | App Opened from Push   | SMSが受信者に送信されました                                   |
| SMS Failed              | SMS Failed             | SMSの送信に失敗しました                                     |
| SMS Delivered           | SMS Received           | SMSが正常に配信されました                                    |
| SMS Undelivered         | SMS Undelivered        | SMSを送信できませんでした                                    |

### イベントプロパティ

OneSignalからMixpanelに送信される任意のイベントにはこれらのプロパティが含まれます：

| プロパティ名               | 説明                                   |
| -------------------- | ------------------------------------ |
| **Distinct ID**      | メッセージに関連付けられたexternal\_id            |
| **Message ID**       | 個別メッセージの識別子                          |
| **Message Name**     | メッセージ名                               |
| **Message Title**    | メッセージのタイトル                           |
| **Message Contents** | メッセージの内容                             |
| **message\_type**    | 送信されたメッセージのタイプ：プッシュ、アプリ内、メール、SMS     |
| **template\_id**     | 使用されたメッセージテンプレート（APIおよびJourneyメッセージ） |
| **subscription\_id** | OneSignalが設定したデバイス/メール/SMS識別子        |
| **device\_type**     | メッセージを受信したデバイスタイプ                    |
| **language**         | デバイスの2文字の言語コード                       |
| **source**           | `onesignal`（すべてのイベントのソースとして示されます）    |

<Warning>
  配信数はMixpanelとOneSignal間で異なる場合があります。詳細は[配信データが一致しないのはなぜですか？](#配信データが一致しないのはなぜですか？)を参照してください。
</Warning>

***

## カスタムイベント（サードパーティ）

Mixpanelの統合は、MixpanelからOneSignalへのカスタムイベントの送信をネイティブにサポートしていません。[Amplitude](./amplitude)とは異なり、MixpanelからOneSignalへの組み込みイベント宛先はありません。

MixpanelのイベントをOneSignalに[カスタムイベント](./custom-events)として送信してJourneysやSegmentsをトリガーする必要がある場合は、[Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal)などのサードパーティコネクタを使用できます。Vendoは選択されたMixpanelイベントをOneSignalにカスタムイベントとしてストリーミングしてキャンペーンをトリガーします。

***

## FAQ

### コホートとセグメントの数が一致しないのはなぜですか？

1. **外部IDの欠落または不一致**
   一致するOneSignal外部IDとMixpanelユーザーIDを持つユーザーのみが含まれます。この統合はユーザーやサブスクリプションを作成しません。

2. **サブスクライブ解除されたユーザー**
   OneSignalセグメントは、サブスクライブされた[サブスクリプション](./subscriptions)の数のみを表示します。サブスクライブ解除されたサブスクリプションは、Journeysまたはアプリ内メッセージで利用できます。

たとえば、Mixpanelコホートに10人のユーザーがいるのに、OneSignalセグメントに8つのサブスクリプションしか表示されない場合、不足している2人のユーザーは次の可能性があります：

* OneSignalに存在しないか、外部IDが正しくない。
* サブスクライブ解除されたサブスクリプションを持っている。

確認するには、OneSignalの**オーディエンス > ユーザー**タブをチェックして、ユーザーが存在し、アクティブなサブスクリプションを持っているかを確認します。

### Mixpanelからサブスクライブ解除されたユーザーは同期されますか？

はい、ただし現時点ではOneSignalセグメント数から除外されます。他の[サブスクリプション](./subscriptions)を持っているか、サブスクリプションタイプがサポートしている場合、Journeysまたはアプリ内メッセージを介してメッセージを送信できます。

### 配信データが一致しないのはなぜですか？

1人のユーザーは複数の[サブスクリプション](./subscriptions)（プッシュデバイス、メールアドレス、電話番号）を持つ場合があります。各サブスクリプションは独自の配信イベントを生成します。例：

* 1ユーザー = 2 Android + 1 iOS + 2 Web = 5つのプッシュサブスクリプション
* 1つのプッシュメッセージ = 最大5つの送信/受信/クリックイベント

イベントプロパティの`subscription_id`を使用して正確なソースを追跡します。

欠落しているイベントのトラブルシューティング：

* ユーザーが識別されるたびに`OneSignal.login`が呼び出されて外部IDが設定されることを確認します。
* `OneSignal.logout`が外部IDを削除していないことを確認します。
* 外部IDを変更する可能性のあるAPIリクエストまたはCSVアップロードを確認します。

### MixpanelからOneSignalにカスタムイベントを送信できますか？

ネイティブにはできません。Mixpanelの統合はメッセージイベント（OneSignal → Mixpanel）とコホート同期（Mixpanel → OneSignal）をサポートしていますが、組み込みのカスタムイベント宛先は含まれていません。MixpanelのイベントをOneSignalに[カスタムイベント](./custom-events)として送信するには、[Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal)などのサードパーティコネクタを使用してください。

### ユーザー/サブスクリプションイベントを送信するにはどうすればよいですか？

ユーザーおよびサブスクリプションレベルのイベント（権限が付与された、ユーザーログイン/ログアウトなど）は自動的には送信されません。

OneSignal SDKには、これらのイベントを追跡してMixpanelに送信するために使用できるイベントリスナーがあります：

* ユーザー状態オブザーバー：[モバイルSDK](./mobile-sdk-reference#addobserver-user-state)、[Web SDK](./web-sdk-reference#addeventlistener-user-state)
* 権限オブザーバー：[モバイルSDK](./mobile-sdk-reference#addpermissionobserver-push)、[Web SDK](./web-sdk-reference#permissionchange)

***

## 関連ページ

<Columns cols={2}>
  <Card title="分析の概要" icon="chart-line" href="./analytics-overview">
    OneSignalの分析、配信メトリクス、イベント追跡の概要。
  </Card>

  <Card title="カスタムイベント" icon="bolt" href="./custom-events">
    ユーザーアクションを追跡してJourneysをトリガーしたり、分析を強化したりします。
  </Card>
</Columns>

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please 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](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>