APIリクエストをパーソナライズする

報告や分析の目的で、APIリクエストにパーソナライゼーションを追加できます。次のユーザー属性とキャンペーン属性を動的属性として渡すことができます。

• ユーザー属性 : パーソナライゼーションダイアログボックスで利用可能なすべての属性。
• キャンペーン属性 :
  
  • キャンペーンID
  • キャンペーン名
  • キャンペーンタグ
  • チーム名
  • テンプレートID
  • コネクタータイプ（プロモーションまたはトランザクショナル）
  • 作成者
  • キャンペーン作成時間
  • 公開時間
  • 最終更新日時
  • 最終更新者
  • キャンペーン配信タイプ
  • コンバージョン目標
  • コンバージョン目標属性

パーソナライズを追加するには：

1. 必要な 値 フィールドに「@」と入力します。例えば、 URLパラメータ の 値 フィールドです。
   
   パーソナライズのポップアップが表示されます。
   
2. データパーソナライゼーション タブで、 属性を選択 リストから必要な属性を選択します。例えば、 キャンペーンID 。
   
3. 置換テキスト フィールドに、ユーザー固有の値が解決できない場合に送信される標準文字列を入力します。
   
   

   info	情報 SMSを送信する際、MoEngageはキャンペーンオブジェクトに含まれる属性の現在の置換文字列をサポートしています。

4. 「 完了 」をクリックします。パーソナライズされた属性の動的な値が、送信者詳細ページの選択された値フィールドに表示されます。
   

配送追跡

配信追跡を使用すると、カスタムコネクタ（サービスプロバイダー）を使用して送信されたSMSメッセージの配信状況を追跡できます。配信追跡を有効にすると、メトリック - 配信済み , が表示され、メッセージがユーザーに配信されたかどうかを理解し、配信の失敗やエラーを分析するのに役立ちます。この情報を使用して、定期的に配信リストをクリーンアップ（以前の配信が失敗したユーザーを削除）することができます。これにより、繰り返し配信失敗が発生したユーザーへのSMSキャンペーンの送信を回避し、コストを節約できます。

コネクタ（サービスプロバイダー）の設定を初めて保存した後で、配送追跡情報を追加できます。

配達追跡を有効にする手順

配達追跡を有効にするには：

1. SMS設定画面で新しく追加された送信者にカーソルを合わせ、三点リーダーのアイコンをクリックします。
2. 編集 を選択します。 送信者の詳細 画面が開きます。
3. 配達追跡を有効にするには、 次へ をクリックしてください。
4. SMS配信の追跡 がオンになっています。オフにして配信追跡を無効にします。

5. SMS配信追跡URLをコピーして、パートナーのダッシュボードのコールバックWebhook設定に貼り付けてください。MoEngageは、以下に示すように、SMS配信トラッキングURLの下でcustom_connectorIDと呼ばれるユニークな識別子を生成します。コネクタ内のすべての送信者は、同じ custom_connectorID と配信追跡URLを持ちます。

   SMS配信追跡URL

   https://api-0X.moengage.com/sms/dlr/custom/<custom_connectorID>

6. 配信応答の属性/フィールドをマッピング

   配信応答からフィールドをマッピングするか、希望のオプションを選択して手動でフィールドをマッピングすることができます。このマッピングは、MoEngageがサービスプロバイダーの配信応答を理解するのに役立ちます。配信応答の属性をマッピングするには、次のオプションのいずれかを選択してください:

   1. 配信応答の属性をマッピング
   2. フィールドを手動でマッピング
   前のステップでSend a Test SMSを使用して設定をテストしていない場合は、 Send a test SMS をクリックして配信応答の属性をマッピングします。配信コールバック情報を受信するまでに最大15分かかることがあります。MoEngageがこの情報を受信すると、ダッシュボードに表示されます。

   フィールド名	説明
   送信応答のユニークIDを格納する属性	このフィールドはリクエストを一意に識別します。このフィールドの値は、トランザクションまたはメッセージIDフィールドに存在する値と一致することが理想です。
   配信応答のユニーク配信IDフィールドを格納する属性	このフィールドは、配信応答のユニーク識別子を格納します。このフィールドの値は送信応答の値と一致する必要があります。これにより、MoEngageは任意のSMSに対する配信応答を識別するのに役立ちます。
   配信ステータスを格納する属性	このフィールドには送信されたSMSの配信ステータスが含まれています。これは、MoEngageによって Delivered メトリックを計算するために使用されます。
   配信ステータスの成功値	これらの値は、SMSが正常に配信されたことを示します。このフィールドに記載されている値が応答の一部として受信された場合、メッセージを配信済みとしてマークします。応答で他の値が受信された場合は、デフォルトで失敗と見なされます。
   失敗理由を格納する属性	このフィールドには、SMS配信が失敗した場合の失敗理由が含まれています。失敗理由はキャンペーン分析で確認できます。詳細については、 Failure Reasons を参照してください。

   配信応答からフィールドをマッピング フィールドを手動でマッピング

   配信応答からフィールドをマッピングするには:

   1. テストSMSを送信し、サービスプロバイダーからの応答を受信するには、Send a Test SMSをクリックします。MoEngageがこの情報を受信すると、ダッシュボードに表示されます。この応答からフィールドをマッピングできます。
   2. ドロップダウンは、配信応答から解析されたフィールド名で自動的に入力されます。次の画像は、送信されたサンプルSMSと配信応答を示しています。この応答からダッシュボードでのマッピングのためにドロップダウンが自動入力される様子も画像で説明されています。

   

   応答のフィールドを手動でマッピングするには、このオプションを選択し、上記の表に記載されているすべてのフィールドに詳細を入力します。カスタムコネクタのAPIドキュメントを参照して、入力する値を特定してください。

   

   	配信応答の一意の識別子を保存します。このフィールドの値は、送信された応答の値と一致する必要があります。これにより、MoEngageは任意のSMSの配信応答を識別するのに役立ちます。
   配信ステータスを格納する属性	このフィールドには、送信されたSMSの配信状況が含まれています。これは、MoEngageによって 配信済み メトリックを計算するために使用されます。
   配信ステータスの成功値	これらの値は、SMSが正常に配信されたことを示しています。レスポンスの一部としてこのフィールドに記載されている値が受信された場合、メッセージは配信済みとマークされます。それ以外の値がレスポンスで受信された場合、デフォルトで失敗と見なされます。
   属性保存失敗の理由	このフィールドには、SMS 配信が失敗したときの失敗理由が含まれています。失敗理由はキャンペーン分析で確認できます。詳細については、 失敗理由 を参照してください。

   配信応答からフィールドをマップする フィールドを手動でマッピング

   配信応答からフィールドをマッピングするには：

   1. テストSMSを送信して、サービスプロバイダーからの応答を受信するには、テストSMSを送信をクリックしてください。MoEngageがこの情報を受け取ると、ダッシュボードに表示されます。この応答からフィールドをマッピングできます。
   2. ドロップダウンは、配信応答から解析されたフィールド名で自動入力されます。次の画像は、送信されたサンプルSMSと配信応答を示しています。ダッシュボード上のマッピングのために、この応答からドロップダウンが自動的に入力される様子も画像に示されています。

   応答内のフィールドを手動でマッピングするには、このオプションを選択し、上記の表に記載されているすべてのフィールドに詳細を入力します。カスタムコネクタのAPIドキュメントを参照して、入力する値を特定してください。

7. 配信応答がマッピングされたら、 保存 をクリックして配信コールバック設定を保存します。

Next Steps

1. SMSキャンペーンを作成します。
2. SMSの頻度制限を設定する .
3. 現在のサービスプロバイダーを設定します。