使用外部集成进行个性化 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响应。 调用您配置的Target与externalDataLookup的集成。 将integrationName设置为该集成的​Name（替换示例占位符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字符串无效或引用为空，则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}}}