MoEngageは、API統合が正しく設定されていることを確認するために、公開後に体験をテストすることを推奨します。
ビルド認証ヘッダー
ワークスペースIDとAPIシークレットを使用して、HTTP認証ヘッダーを生成します。これは、パーソナライズAPI記事の 認証 セクションで説明されています。
Copy Request
ダッシュボードのテスト体験セクションからサポートされている任意の言語のサンプルリクエストをコピーし、クリップボードアイコンを使用して外部コンソールでテストすることもできます。
Copy Workspace ID
リクエストヘッダー MOE-APPKEY には、あなたのMoEngageアカウントのワークスペースIDの値が含まれている必要があります。
属性
リクエストには次の属性を渡す必要があります:
リクエストフィールド |
MANDATORY |
Description |
---|---|---|
app_id |
Yes |
これはあなたのMoEngageアカウントのワークスペースIDです。ワークスペースIDは、あなたのMoEngageワークスペースを一意に識別します。 |
承認 |
Yes |
これは認証のために渡す必要があるBase64エンコードされた認証ヘッダー(WorkspaceID: APISECRET)です。 |
user_id |
No |
このフィールドはあなたのブランドによって提供されており、リクエストに貼り付ける必要があります。このフィールドはクライアントIDで、パーソナライズされたコンテンツを表示するユーザーを特定します。これは、ユーザーにイベントをマッピングするために不可欠です。 無効なユーザーIDまたは存在しないユーザーIDが共有され、APIリクエストに有効な受取人の詳細が含まれている場合、有効な受取人の詳細を持つ新しいユーザープロファイルが作成されます。 リクエストに user_id が存在しない場合でも、 visitor_id フィールドの値を考慮してリクエストは処理されます。 visitor_id フィールドの値がリクエストに存在しない場合、イベントは MoEngage のいかなるユーザーにもログされません。 |
visitor_id |
No |
このフィールドはMoEngage SDKによって提供されており、ユーザーに関連付けられた一意のIDがない場合はリクエストに貼り付ける必要があります。これは一般的に、過去にあなたのウェブサイトを訪れたが、ログインまたはアカウントを作成していないユーザーに使用されます。
|
experience_key |
Yes |
このフィールドは、MoEngage Personalizeを使用して作成された各サーバーサイドエクスペリエンスを一意に識別するために使用されます。1回のリクエストで複数の値を渡し、それぞれの体験に定義されたパーソナライズされたコンテンツをレスポンスで受け取ることができます。 |
プラットフォーム |
No |
このフィールドは、訪問者があなたのブランドと関わるために使用するプラットフォームを特定します。 受け入れられる値 - web, mweb, android, ios |
曜日 |
No |
このフィールドには、INセッションの属性ベースの体験を評価するための曜日を含める必要があります。 受け入れられる値 - 日曜日、月曜日、火曜日、水曜日、木曜日、金曜日、土曜日 |
一日の時間 |
No |
このフィールドには、INセッション属性ベースの体験を評価するための日中の時間を含める必要があります。受け入れられる値 -
00, 01, 02, 03, 04, 05, 06, 07,….., 23
|
USER_IP_ADDRESS |
No |
このフィールドには、地理的位置に基づく体験を評価するためにユーザーのIPアドレスを含める必要があります。 |
USER_AGENT |
いいえ |
このフィールドには USER-AGENT HTTP ヘッダーが含まれている必要があります。これは、デバイスタイプのようなセッション中の属性に基づいて、パーソナライズされたコンテンツを提供するために不可欠です。 |
パーソナライズされたコンテンツを取得するためのユーザー識別
APIはリクエストで共有されたユーザーの識別情報を処理し、通信を送信する必要があるユーザーを特定します。以下に示します。
リクエストに必要な情報がすべて追加されたら、外部コンソールからリクエストを送信します。
Testing the request in Postman
Postmanでテストするには、次の手順を実行してください:
-
Click on the copy & open Postman icon to copy the cURL and import it in Postman.
-
認証セクションを使用して認証情報を追加します。ワークスペースIDをユーザー名として、APIキーをパスワードとして追加してください。
-
インポートされたcURLにはペイロードの詳細が含まれます。経験キーをコピーし、それをそれぞれのフィールドに更新してください。認証ヘッダーとその他の属性を追加します。
-
Postmanで送信をクリックします。これは、Fetch Personalize API にリクエストを送信します。
-
レスポンス、エラーコード、およびサンプルレスポンスに関する情報は、 Fetch API Response を参照してください。