Amplitude

OneSignalをAmplitudeと統合して、プッシュ、アプリ内、メール、SMS全体でリアルタイムの行動ベースターゲティングを実現します。このアプリレベルの統合は3つのデータフローをサポートします：

• メッセージイベント → Amplitude：すべてのチャネルの配信、クリック、失敗などを追跡します。
• カスタムイベント → OneSignal：AmplitudeイベントをOneSignalに送信してJourneysやSegmentsをトリガーします。
• コホート → OneSignal：行動ベースのAmplitudeコホートをOneSignalのターゲティングフィルターとして同期します。

---

​

要件

• Amplitudeアカウント
• OneSignal有料プラン
• ユーザーとExternal IDが設定されたOneSignalアプリ。

---

​

セットアップ

​

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

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

1. OneSignalで、Data > Integrations > Catalogに移動し、Amplitudeを選択します。
2. Settingsをクリックし、Outboundタブを開きます。
3. AmplitudeのAPIトークンを入力し、送信するメッセージイベントを選択して、Saveをクリックします。

​

Amplitudeで

1. プロジェクトAPIキーを見つけて、OneSignalにコピー＆ペーストします。
2. AmplitudeのEUサーバーを使用している場合は、Send events exclusively to Amplitude’s EU Residency Endpointをチェックします。これは、Amplitude URLで確認できます。eu.amplitude.comが表示されている場合は、AmplitudeのEUサーバーを使用しています。

​

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

AmplitudeのDestinationsで、OneSignalを検索します。 Amplitudeは、カタログで2つのOneSignal宛先タイプを提供しています：

• Cohorts：AmplitudeからOneSignalにコホートを同期します。
• Events User Properties：AmplitudeからOneSignalにカスタムイベントを送信します。

​

User IDマッピング

OneSignalの**External ID**は、選択されたAmplitudeユーザープロパティ（例：user_id）と一致する必要があります。このプロパティが両方のシステムで設定されていることを確認してください。コホート同期とイベント追跡は完全な一致に依存しています。

​

追加のプロパティ

OneSignalのカスタムイベントに付加される追加のプロパティを含めることができます。これは条件付きイベント処理に役立ちます。

---

​

カスタムイベントのテスト

1. Amplitude > OneSignal Events Destinationで、Test Connectionボタンをクリックします。

2. ペイロード内の"user_id"が、OneSignalアプリ内の既存ユーザーのExternal IDに設定されていることを確認します。
3. Send Test Eventボタンをクリックします。
4. Responseボックスは空のままで、"OneSignal has successfully received test event."というメッセージが表示されるはずです。

5. OneSignalで、Data > Custom Eventsに移動し、リストにテストイベントが表示されていることを確認します。

​

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

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

1. Amplitudeで、コホートを作成します。Amplitudeのコホートに関するドキュメントを参照してください。
2. Syncをクリックし、宛先としてOneSignalを選択します。
3. 同期頻度を選択します。

​

OneSignal Segmentの作成

同期されたコホートは、Amplitude Segmentフィルターとして表示されます。以下の条件が満たされている場合、OneSignalはコホートのSegmentを自動的に作成します：

• AmplitudeコホートのユーザーがOneSignalにも一致するExternal IDで存在する。
• OneSignalのSegment制限を超えていない。

---

​

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

OneSignalは以下のメッセージイベントをリアルタイムでAmplitudeに送信します。送信するイベントはData > Integrations > Amplitude > Outboundで選択してください。

​

イベントプロパティ

OneSignalからAmplitudeに送信されるすべてのイベントには、これらのプロパティが含まれます：

---

​

FAQ

​

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

1. External IDの欠落または不一致 一致するOneSignal External IDとAmplitude User IDを持つユーザーのみが含まれます。この統合はユーザーやサブスクリプションを作成しません。
2. 登録解除したユーザー OneSignalセグメントは、サブスクライブされたサブスクリプションのカウントのみを表示します。登録解除されたサブスクリプションは、JourneysまたはIn-App Messagesで利用できます。

例えば、Amplitudeコホートに10人のユーザーがいるが、OneSignalセグメントに8つのサブスクリプションが表示されている場合、不足している2人のユーザーは：

• OneSignalに存在しないか、誤ったExternal IDを持っている。
• サブスクリプションが登録解除されている。

確認するには、OneSignalのAudience > Usersタブをチェックして、ユーザーが存在し、アクティブなサブスクリプションがあるかどうかを確認してください。

​

登録解除したユーザーはAmplitudeから同期されますか？

はい、ただし現時点ではOneSignalセグメントカウントから除外されます。他のサブスクリプションがある場合、またはサブスクリプションタイプがサポートしている場合は、JourneysまたはIn-appメッセージを介してメッセージを送信できます。

​

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

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

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

イベントプロパティのsubscription_idを使用して、正確なソースを追跡します。 不足しているイベントのトラブルシューティング：

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

​

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

ユーザーおよびサブスクリプションレベルのイベント（例：権限の付与、ユーザーのログイン/ログアウト）は自動的には送信されません。 OneSignal SDKには、これらのイベントを追跡してAmplitudeに送信するために使用できるイベントリスナーがあります：

• User State Observer：Mobile SDK、Web SDK
• Permission Observer：Mobile SDK、Web SDK

​

OneSignal Subscription IDがAmplitudeにdevice_idとして追加されるのはなぜですか？

Amplitudeは重複排除のためにdevice_idを期待しています。OneSignalはこのためにsubscription_idを使用し、これは自動的にdevice_idにマッピングされます。 詳細については、Amplitudeのドキュメントを参照してください。

---

​

関連ページ

---