エクスペリエンスのAPI要求を作成する

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

トリガーされたエクスペリエンスのWebhookを作成したら、選択したWebhookの送信先に送信する決定モデルによって返されたコンテンツを含むAPIリクエストを作成する必要があります。

APIリクエストを使用すると、ゲストデータモデルとエクスペリエンスレスポンスからの動的データを含めることができます。たとえば、トリガーされたエクスペリエンスのバリアントに、ゲストの名、場所、ロイヤルティ番号などを含めるようにすることができます。要求はFreeMarkerを使用して構成します。

トリガーされたエクスペリエンスのAPIリクエストを作成するには:

APIエディターのAPI requestタブで、ドロップダウンリストを使用して、データの送信先の外部送信先を選択します。
必要に応じて、要求にヘッダーを追加するには、Add headersをクリックします。

メモ

ここで追加するヘッダーにFreeMarker変数を含めることはできません。ヘッダーにFreeMarker変数が必要な場合は、外部の宛先へのリクエストを設定するときに変数を作成する必要があります。
接続にFreeMarker変数が含まれている場合は、Set variable valuesをクリックして、すべての変数の値を指定します。次に、「 Save」をクリックします。

手記

文字列値を二重引用符で囲みます (例: "test-value".

API bodyタブをクリックし、API要求本文を作成します。

変数を含めるには、FreeMarker変数表記 ${}を使用します。たとえば、必要に応じて、ゲストデータモデルと意思決定モデルの応答から動的データをコピーして貼り付けることができます。

以下は、ゲストデータモデルの変数を使用した放棄されたカートのメールのAPIリクエスト本文の例です。

{
  "from": "[email protected]",
  "to": "${guest.email}",
  "subject": "Don't forget your favorite pair of shoes",
  "body": "Hello, ${guest.firstName}. We noticed that you left a pair of shoes in your cart..."
}

「 Save」をクリックします。
「」をクリックして、APIエディターを閉じます。

この記事を改善するための提案がある場合は、お知らせください!