パーソナライゼーションに対する外部統合の使用 integrations-personalization

type が json の場合、content フィールドは JSON 文字列​です。ネストされたフィールドにアクセスする前に解析します。以下の例は、JSON mbox に対する一般的な Delivery API 応答を示しています。

{
  "status": 200,
  "prefetch": {
    "mboxes": [
      {
        "index": 0,
        "name": "SummerOffer",
        "options": {
          "content": "{\"recommendations\":[{\"productId\":\"p101\",\"name\":\"Noise Smartwatch\",\"price\":2999},{\"productId\":\"p205\",\"name\":\"Boat Earbuds\",\"price\":1499}],\"strategy\":\"collaborative-filtering\"}",
          "type": "json"
        }
      }
    ]
  }
}

3 つのヘルパーを順番に使用して、Target 応答を取得、抽出、解析します。

1. Target 応答を取得します。 設定済みのTarget 統合を、externalDataLookup を使用して呼び出します。integrationName をその統合の​ 名前 ​に設定します（例のプレースホルダー target_recommendations を置き換えます）。Delivery API の完全なペイロードを保持するテンプレート変数の名前を指定するには、result パラメーターを使用します（例：targetResponse）。

   また、パーソナライゼーションエディターの左側のナビゲーションにある​ 統合 ​メニューから統合を直接選択することもできます。詳しくは、コンテンツへの統合パーソナライゼーションの適用を参照してください。

   code language-handlebars
   {{externalDataLookup integrationName="target_recommendations" result="targetResponse"}}

2. valueAtPath を使用して特定の mbox を抽出します。 valueAtPath は、0 ベースのインデックスで配列から要素を抽出し、テンプレート変数に割り当てます。アクセスする要素を指定するには、idx パラメーターを使用します。

   code language-handlebars
   {{valueAtPath targetResponse.prefetch.mboxes idx=0 result="summerOffer"}}

   table 0-row-2 1-row-2 2-row-2 3-row-2
   パラメーター	説明
   path	配列へのパス（位置、キーワードなし）
   idx	配列アクセス用の 0 ベースのインデックス（オプション）
   result	抽出した値を格納する変数名

   note
   NOTE
   idx が範囲外の場合、レンダリングは例外をスローします。 インデックスが無効な場合は、無効なインデックスを {%#if idx >= 0 and idx < count(targetResponse.prefetch.mboxes)%} で保護します。PQL 式は、パスとして使用できません。2025.9.0 リリース以降で使用できます。

3. parseJson を使用して JSON 文字列を解析します。 mbox options.content フィールドは生の JSON 文字列です。parseJson は、フィールドがテンプレート内で直接アクセスできる構造化オブジェクトに変換します。

   code language-handlebars
   {{parseJson jsonStr=summerOffer.options.content result="summerOfferContent"}}

   table 0-row-2 1-row-2 2-row-2
   パラメーター	説明
   jsonStr	有効な JSON を含む文字列フィールドへのパス
   result	解析したオブジェクトを格納する変数名

   note
   NOTE
   JSON 文字列が無効であるか、参照が null の場合、result は null に設定されます。レンダリングエラーはスローされません。実際の Target 応答でテストし、コンテンツが有効な JSON であることを確認します。2026.6.0 以降で使用できます

4. データにアクセスします。 解析したら、ドット表記を使用して summerOfferContent からフィールドにアクセスします。レコメンデーションのリストをレンダリングするには：

   code language-handlebars
   {{externalDataLookup integrationName="target_recommendations" result="targetResponse"}} {{valueAtPath targetResponse.prefetch.mboxes idx=0 result="summerOffer"}} {{parseJson jsonStr=summerOffer.options.content result="summerOfferContent"}} Strategy: {{summerOfferContent.strategy}} {{#each summerOfferContent.recommendations as |rec|}} {{rec.name}} — {{rec.price}} {{/each}}

type が html の場合、「content」フィールドはレンダリング可能な HTML 文字列です。解析する必要はありません。以下の例は、HTML mbox に対する一般的な Delivery API 応答を示しています。

{
  "status": 200,
  "prefetch": {
    "mboxes": [
      {
        "index": 0,
        "name": "SummerOffer",
        "options": {
          "content": "<div class=\"offer\"><h2>Summer Sale</h2><p>50% off Smartwatch</p></div>",
          "type": "html"
        }
      }
    ]
  }
}

mbox を取得して抽出し、content を直接レンダリングします。 parseJson をスキップします。

{{externalDataLookup integrationName="target_recommendations" result="targetResponse"}}
{{valueAtPath targetResponse.prefetch.mboxes idx=0 result="summerOffer"}}
{{{summerOffer.options.content}}}