API 連携が正しく設定され、パーソナライゼーションが適切にレンダリングされることを確認するために、このステップを実施することを推奨します(任意)。
公開前にアラートをテストする方法
ダッシュボードからコピーしたリクエストに、いくつかの値を渡す必要があります。これらは、Authorization Header、MOE-APPKEY、リクエスト属性、およびパーソナライゼーション属性(ある場合)です。Authorization Header の作成
MoEngage は Basic 認証を使用します。こちらで説明されているように、Workspace ID と API Secret を使用して HTTP Auth Header を生成します。リクエストのコピー
ダッシュボードの Test Request セクションから、サポートされている任意の言語でサンプルリクエストをクリップボードにコピーアイコンを使用してコピーし、外部コンソールでテストすることもできます。Workspace ID のコピー
リクエストヘッダーの MOE-APPKEY には、MoEngage アカウントの Workspace ID の値を含める必要があります。Test Alert ID
このテストアラートのリクエストを外部コンソールに送信するために、ダッシュボードに Test Alert ID が表示されます。この値はリクエストに自動的に渡されます。 注: これは、公開済みアラートの Alert ID とは異なります。Test Alert Reference Name
Test Alert Reference Name は、このテストアラートのリクエストを外部コンソールに送信するために、ダッシュボードでアラートを追加する際に設定します。この参照名を使用してアラートをテストできます。これは、公開済みアラートの Reference ID とは異なります。
属性
リクエストでは、次の属性を渡す必要があります。Payloads
アラート送信のためのユーザー識別
以下に示すように、API はリクエストで共有されたユーザー ID 情報を処理し、コミュニケーションの送信先となるユーザーを識別します。
user_id を渡す必要があり、渡されない場合はリクエストが破棄されます。ペイロードに user_id(User Profile の ID フィールド)が含まれ、指定されたチャネルの受信者の詳細(携帯電話番号/メール ID/有効なプッシュトークン)がユーザープロファイルにある場合、アラートが送信されます。
受信者の詳細があり、新しい user_id が共有された場合は、受信者の詳細を持つ新しいプロファイルが作成されます。
- Push チャネルでアラートを送信する際は、ユーザープロファイルにある直近でアクティブなデバイストークンのうち最大 5 つのみが対象となります。
- ユーザー属性が有効になっている場合、受信者の詳細はユーザープロファイルから取得されます。詳細については、ユーザー属性の有効化を参照してください。
Postman でのリクエストのテスト
Postman でテストするには、次の手順に従います。- copy & open Postman アイコンをクリックして cURL をコピーし、Postman にインポートします。
- Authorization セクションを使用して認証の詳細を追加します。ユーザー名として Workspace ID を、パスワードとして API Key を追加します。
- インポートした cURL にはペイロードの詳細が含まれています。Email ID、Phone Number、その他の属性(user_id、transaction_id、パーソナライゼーション(ある場合))を追加します。
- Postman で Send をクリックします。これにより、リクエストが Send Inform API に送信されます。