使用外部整合進行個人化 integrations-personalization

當type是json時，content欄位是​JSON字串。 在存取巢狀欄位之前先加以剖析。 以下範例顯示JSON mbox的典型傳送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"
        }
      }
    ]
  }
}

依序使用三個協助程式來擷取、擷取及剖析Target回應。

1. 擷取目標回應。 呼叫您設定的Target與externalDataLookup的整合。 將integrationName設定為該整合的​名稱 （取代範例預留位置target_recommendations）。 使用result引數來命名包含完整傳送API裝載的範本變數，例如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的典型傳送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}}}