一般的なユースケース
トランザクションメッセージを使用して次のことを行います：- ログインと確認コード（OTP）を送信
- 注文、領収書、またはサブスクリプション変更を確認
- 請求ステータスまたは更新アラートを配信
- 予約または期限についてユーザーにリマインド
- 重要なアクション（たとえば、サインアップまたは購入）を認識
要件
トランザクションメッセージを送信する前に、次のガイドを確認することをお勧めします：- OneSignalのユーザー、サブスクリプション、エイリアスを理解します。
- データベース、DMP、またはCRMをOneSignalと通信するように設定するか、統合の1つを使用します。
- メッセージをパーソナライズするためにテンプレートを作成します。
- メッセージをパーソナライズするためにLiquid構文を使用します。
ユーザーの識別
個々のユーザーをターゲティングするには、OneSignal内でそれらを識別する必要があります。推奨されるアプローチは、データベースまたはCRMで使用されるユーザー識別子にマップする必要がある外部IDを設定することです。 OneSignalはユーザーごとに最大20のエイリアスもサポートしており、システム全体で複数の識別子（たとえば、other_user_id、facebook_idなど）を関連付けることができます。メールとSMSの場合、メールアドレスまたは電話番号をそれぞれ直接使用してメッセージを送信することもできます。
ユーザーのターゲティング
Create Message APIを使用して、エイリアス、メールアドレス、電話番号、またはサブスクリプションIDを介してユーザーをターゲティングすることにより、プッシュ、メール、SMSチャネル全体でトランザクションメッセージを送信します。エイリアスに送信（推奨）
include_aliasesを使用して、推奨されるexternal_idまたは次のような他のエイリアスをターゲティングします：
サブスクリプションに送信
特定のサブスクリプションに送信する場合は、include_subscription_idsプロパティを使用できます。ユーザーは複数のサブスクリプションを持つことができるため、このオプションは推奨されません。
メールアドレスに送信
ユーザーのメールアドレスがある場合は、include_email_tokensプロパティを使用してメールを送信できます。
OneSignalアプリ内に存在しない含まれるメールは、自動的に新しいメールサブスクリプションを作成します。
電話番号に送信
ユーザーの電話番号がある場合は、include_phone_numbersプロパティを使用してSMSとMMSを送信できます。
OneSignalアプリ内に存在しない含まれる電話番号は、自動的に新しいSMSサブスクリプションを作成します。
カスタムデータの追加
パーソナライズされたコンテンツの場合、テンプレートとLiquid構文を使用して、ユーザー固有のcustom_dataをメッセージに渡します。
カスタムデータを追加する手順：
- ダッシュボードまたはCreate template APIを介してテンプレートを作成します。
- テンプレートにLiquid変数（たとえば、
{{ message.custom_data.order_id }}）を追加します。 - Create Message API呼び出し内で
template_idとcustom_dataを参照します。
例：ワンタイムパスコード（OTP）
- エイリアス、メール、または電話番号を使用してユーザーを識別します。
- 確認コードを含むテンプレートを作成します：
- ユーザーがアクセスを要求したときに、サーバーで
verification_codeを生成します。 verification_codeの値をAPIリクエストに入力します。
custom_dataを使用したくない場合は、文字列連結を使用して変数値をメッセージに直接入力できます。例：
トラブルシューティング
include_aliasesの場合、エイリアスは事前にユーザーに登録されている必要があります。- メール/SMSの場合、正しいフォーマットを確認してください。