Uso de integraciones externas para la personalización integrations-personalization

Cuando type es json, el campo content es una cadena JSON. Analícelo antes de acceder a los campos anidados. El ejemplo siguiente muestra una respuesta típica de la API de envío para un mbox JSON.

{
  "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"
        }
      }
    ]
  }
}

Utilice tres ayudantes en secuencia para recuperar, extraer y analizar la respuesta de Target.

1. Recupere la respuesta de Target. Llame a la integración de Target configurada con externalDataLookup. Establezca integrationName en el Nombre de esa integración (reemplace el marcador de posición de ejemplo target_recommendations). Utilice el parámetro result para asignar un nombre a la variable de plantilla que contiene la carga útil completa de la API de envío; por ejemplo, targetResponse.

   También puede seleccionar la integración directamente desde el menú Integraciones en la navegación izquierda del editor de personalización. Ver Aplicar personalización de integración a tu contenido.

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

2. Extraer un mbox específico mediante valueAtPath. valueAtPath extrae un elemento de una matriz por su índice basado en 0 y lo asigna a una variable de plantilla. Utilice el parámetro idx para especificar a qué elemento acceder.

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

   table 0-row-2 1-row-2 2-row-2 3-row-2
   Parámetro	Descripción
   path	Ruta a la matriz (posicional, sin palabra clave)
   idx	Índice basado en 0 para el acceso a la matriz (opcional)
   result	Nombre de variable para almacenar el valor extraído

   note
   NOTE
   Si idx está fuera de los límites, el procesamiento genera una excepción. Proteja los índices no válidos con {%#if idx >= 0 and idx < count(targetResponse.prefetch.mboxes)%} cuando el índice pueda no ser válido. Las expresiones PQL no se pueden usar como ruta. Disponible desde la versión 2025.9.0.

3. Analizar la cadena JSON mediante parseJson. El campo mbox options.content es una cadena JSON sin procesar. parseJson lo convierte en un objeto estructurado a cuyos campos se puede tener acceso directamente en la plantilla.

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

   table 0-row-2 1-row-2 2-row-2
   Parámetro	Descripción
   jsonStr	Ruta al campo de cadena que contiene un JSON válido
   result	Nombre de variable para almacenar el objeto analizado

   note
   NOTE
   Si la cadena JSON no es válida o la referencia es nula, result se establece en null; no se produce ningún error de procesamiento. Pruebe con su respuesta de Target real para confirmar que el contenido es un archivo JSON válido. Disponible desde: 2026.6.0

4. Acceder a los datos. Una vez analizado, utilice la notación de puntos para acceder a los campos de summerOfferContent. Para procesar una lista de recomendaciones:

   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}}

Cuando type es html, el campo content es una cadena de HTML lista para procesar. No es necesario analizarlo. El ejemplo siguiente muestra una respuesta típica de la API de envío para un mbox de HTML.

{
  "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"
        }
      }
    ]
  }
}

Busque y extraiga el mbox y, a continuación, procese content directamente. Omitir parseJson.

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