OneSignal + Mixpanel統合概要
主な利点
- Mixpanelにメッセージイベントを送信：プッシュ、アプリ内、メール、SMSにわたって配信、クリック、失敗などを追跡します。
- リアルタイムインサイト – Mixpanel製品分析とOneSignalエンゲージメントメトリクスを統合します。
- データドリブンキャンペーン – Mixpanelの行動セグメンテーションを使用して、よりスマートな再エンゲージメントを実行します。
- Mixpanelからコホートをインポート：行動ベースのコホートをターゲティング用のフィルターとしてOneSignalに自動的に同期します。
- パーソナライズされたメッセージング – ユーザーがMixpanelコホートに入るまたは出るときにコンテキストに応じたOneSignalメッセージをトリガーします。
要件
- Mixpanelアカウント
- OneSignal有料プラン
- ユーザーと外部IDが設定されたOneSignalアプリ。
この統合はユーザーを作成しません。MixpanelのユーザーをOneSignalのユーザーにマッピングします。
セットアップ
MixpanelをOneSignalに追加する
OneSignalで、データ > 統合 > Mixpanelに移動し、アクティベートをクリックします。
OneSignalでMixpanel統合を有効にする
- プロジェクトトークンを見つけて、OneSignalにコピー＆ペーストします。
- データレジデンシーを確認します。MixpanelのEUサーバーを使用している場合は、Send events exclusively to Mixpanel’s EU Residency Serverボックスにチェックを入れます。
メッセージイベントを選択する
Mixpanelに送信するOneSignalメッセージイベントを選択します。完了したら、アクティベートをクリックします。
OneSignalでのMixpanel設定
OneSignalをMixpanelに追加する
Mixpanelの統合で、OneSignalを追加します。
MixpanelにOneSignal統合を追加する
OneSignal - APP_NAMEのように識別可能なものに設定します。ここでAPP_NAMEはOneSignalのアプリの名前です。
OneSignalの**設定 > キーとID**で次のデータが必要です：
- App ID
- APIキー
ユーザーIDマッピング
このステップは、コホート同期とイベント追跡が正しく機能するために不可欠です。
- 共有識別子を使用します：OneSignalの**外部ID**は、選択されたMixpanelユーザーIDプロパティ（user_idなど）と一致する必要があります。
- 選択したユーザープロパティがMixpanelとOneSignalのユーザープロファイル全体で存在することを確認します。
OneSignalプロパティを設定するためのMixpanelダッシュボード
Mixpanel > ユーザー > ユーザープロファイルプロパティ
OneSignal > オーディエンス > ユーザー > 外部ID
Mixpanelの
$distinct_idに基づいてOneSignalにユーザーを照合する場合、最上位の値のみと一致します。以下の例では、890ea9b1-9024-4fb9-a92f-152ba67dd21aのみが機能します。109768518080488203109または$device:1880c06821f1b3-052354675cde95-1d525634-1fa400-1880c06821f1b3とは一致しません。
ユーザーIDプロパティマッピングに使用する場合は、Distinct IDを設定する際に注意してください
これで、MixpanelからOneSignalにコホートをエクスポートし、OneSignalからMixpanelにメッセージイベントを収集できるようになります。
MixpanelコホートをOneSignalにエクスポートする
前のステップで説明した一致するユーザーID/外部IDプロパティがある限り、Mixpanelコホート内のユーザーをOneSignal内のユーザーに同期できます。 MixpanelからユーザーデータをエクスポートしてもOneSignalでユーザーは作成されません。ユーザーは既に存在し、一致する外部IDを持っている必要があります。 MixpanelからOneSignalにユーザーをエクスポートするには：- Mixpanelでコホートを作成します。
- オプション > エクスポート先… > OneSignal接続名をクリックします。
MixpanelコホートをOneSignalにエクスポートする方法
- 同期頻度を選択し、同期を開始を押します。
Mixpanel頻度オプション
OneSignalセグメント作成
- 同期されたコホートは、OneSignalでMixpanelセグメントフィルターとして表示されます。
- 次の条件が満たされている場合、コホート用のセグメントが自動的に作成されます：
- Mixpanelコホート内のユーザーが、一致する外部IDを持つOneSignalにも存在する。
- OneSignalのセグメント制限を超えていない。
MixpanelはOneSignalでセグメントを作成するために少なくとも1人の一致するユーザーを必要とします。
セグメントが作成されると、後でコホートにユーザーがいなくなっても、OneSignalに残ります。その場合、ユーザーが再び追加されるまでセグメントは空として表示されます。
Mixpanelコホートからセグメントを作成する方法
Mixpanelでメッセージイベントを追跡する
接続されると、OneSignalはメッセージイベントをリアルタイムでMixpanelに送信します。 これをテストするには、OneSignalから自分にメッセージを送信し、Mixpanelのユーザープロファイルページに移動します。 アクティビティフィード内に、イベントが表示されるはずです：
OneSignalメッセージイベントを含むMixpanelアクティビティフィードの例
メッセージイベント
これらは、OneSignalがMixpanelに送信するメッセージイベントの種類です。OneSignal統合設定内で、Mixpanelプロジェクトに送信するイベントを選択できます。| メッセージイベントの種類（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 | サブスクリプションがプッシュからサブスクライブ解除されました。 |
| In-App Impression | Message Sent | アプリ内メッセージがデバイスに正常に表示されました。 |
| In-App Clicked | Message Opened | デバイスでアプリ内メッセージがクリックされました。 |
| In-App Page Displayed | In-App Page Displayed | アプリ内メッセージページが表示されます。 |
| Email Sent | Message Sent | メールが正常に送信されました。 |
| 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（すべてのイベントのソースとして示されます） |
FAQ
コホートとセグメントの数が一致しないのはなぜですか？
- 外部IDの欠落または不一致 一致するOneSignal外部IDとMixpanelユーザーIDを持つユーザーのみが含まれます。この統合はユーザーやサブスクリプションを作成しません。
- サブスクライブ解除されたユーザー OneSignalセグメントは、サブスクライブされたサブスクリプションの数のみを表示します。サブスクライブ解除されたサブスクリプションは、Journeysまたはアプリ内メッセージで利用できます。
- OneSignalに存在しないか、外部IDが正しくない。
- サブスクライブ解除されたサブスクリプションを持っている。
Mixpanelからサブスクライブ解除されたユーザーは同期されますか？
はい、ただし現時点ではOneSignalセグメント数から除外されます。他のサブスクリプションを持っているか、サブスクリプションタイプがサポートしている場合、Journeysまたはアプリ内メッセージを介してメッセージを送信できます。配信データが一致しないのはなぜですか？
1人のユーザーは複数のサブスクリプション（プッシュデバイス、メールアドレス、電話番号）を持つ場合があります。各サブスクリプションは独自の配信イベントを生成します。例：- 1ユーザー = 2 Android + 1 iOS + 2 Web = 5つのプッシュサブスクリプション
- 1つのプッシュメッセージ = 最大5つの送信/受信/クリックイベント
subscription_idを使用して正確なソースを追跡します。
欠落しているイベントのトラブルシューティング：
- ユーザーが識別されるたびに
OneSignal.loginが呼び出されて外部IDが設定されることを確認します。 OneSignal.logoutが外部IDを削除していないことを確認します。- 外部IDを変更する可能性のあるAPIリクエストまたはCSVアップロードを確認します。