このガイドは、モバイルSDKのバージョン2、3、または4、またはWeb SDKのv15を長期間使用しているお客様向けです。新規のお客様、またはすでにモバイルSDKのバージョン5またはWeb SDKのv16に移行済みの場合は、このガイドをスキップして以下に進んでください：
ユーザーモデルによるマルチチャネルメッセージング
ユーザーモデルとは？
ユーザーモデルを使用すると、個々のデバイスをターゲットにするのではなく、サブスクライブしているすべてのメッセージングチャネル（モバイルプッシュ、Webプッシュ、メール、SMS、アプリ内）で実際のユーザーをターゲットにできます。 各ユーザー：- 1つ以上のIDエイリアス（例：external_id、カスタムエイリアス）を持ちます
- 各チャネルまたはデバイスごとに複数のサブスクリプションを持つことができます
- タグ、言語、アクティビティ履歴などのメタデータが含まれます
PlayerモデルとUserモデルの比較
主要な概念
- ユーザー
- サブスクリプション
- エイリアス
ユーザーは実在の人物を表します。システム生成またはカスタムエイリアスを使用してユーザーを識別できます。
onesignal_id：OneSignalによって自動生成external_id：SDKlogin()またはAPIを介して設定（予約済みエイリアス）- カスタムエイリアス：例：
user_id、email、facebookなど
移行のメリット
- 統一されたID：すべてのデバイスとチャネルで1人のユーザー
- 高度なメッセージング：Journeys、アプリ内ログイン追跡、ライフサイクルキャンペーンなどの強力な機能
- クリーンなセグメンテーション：タグ、サブスクリプションステータス、チャネルエンゲージメントなどでユーザーをグループ化
- 簡素化されたAPI：エンドポイントが少なく、より一貫したデータモデル
移行手順
ユーザーモデルには後方互換性がありません。移行は、PlayerモデルからUserモデルへの一方向です。移行前に：
- ステージング環境で徹底的にテストします
- すべてのSDKとバックエンドサービスが更新された後にのみ移行します
1
external_idでユーザーを統合
IDエイリアスを使用して、既存のplayerレコードを統一されたユーザーにリンクします。オプション：
- SDK
login(externalId) - API：Create User、Update User
- CSV：インポート
2
OneSignal SDKを更新
すべてのOneSignalモバイルSDK v5+およびWeb SDK v16+はユーザーモデルをサポートしています。リスクを最小限に抑えるために、段階的デプロイメント戦略を使用してSDK更新をロールアウトします：以下のSDKサポート表を参照してください。
3
バックエンドを更新して新しいUser APIを使用
非推奨のPlayer Model API呼び出しを、新しいUser Model相当のものに置き換えます。APIリファレンスと以下の表を使用して、古いエンドポイントを新しいものにマップします。
SDKサポートと移行ガイド
- モバイルSDK
- Web SDK
- バックエンドSDK
APIリファレンス
- Playerモデル（非推奨）
- Userモデル（新規）
次のステップ
- 📘 ユーザーとサブスクリプションのドキュメントを参照してください
- 🛠️ SDKを更新し、本番環境に移行する前にステージング環境でテストします
- 💬 サポートが必要ですか？
support@onesignal.comにお問い合わせください
これで、新しいユーザーモデルを活用したパーソナライズされたマルチチャネルメッセージングエクスペリエンスを構築する準備が整いました！