Uso de integrações externas para personalização integrations-personalization

Quando type é json, o campo content é uma cadeia de caracteres JSON. Analise-os antes de acessar campos aninhados. O exemplo abaixo mostra uma resposta típica da API de entrega para uma 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"
        }
      }
    ]
  }
}

Use três auxiliares em sequência para buscar, extrair e analisar a resposta do Target.

1. Buscar a resposta do Target. Chame a integração do Target configurada com o externalDataLookup. Defina integrationName como Name dessa integração (substitua o espaço reservado de exemplo target_recommendations). Use o parâmetro result para nomear a variável de modelo que contém a carga completa da API de Entrega — por exemplo, targetResponse.

   Você também pode selecionar a integração diretamente no menu Integrações, na navegação à esquerda do editor de personalização. Consulte Aplicar personalização da integração ao seu conteúdo.

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

2. Extrair uma mbox específica usando valueAtPath. valueAtPath extrai um elemento de uma matriz por seu índice baseado em 0 e o atribui a uma variável de modelo. Use o parâmetro idx para especificar qual elemento acessar.

   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	Descrição
   path	Caminho para a matriz (posicional, sem palavra-chave)
   idx	Índice com base em 0 para acesso ao array (opcional)
   result	Nome da variável para armazenar o valor extraído

   note
   NOTE
   Se idx estiver fora dos limites, a renderização acionará uma exceção. Proteger índices inválidos com {%#if idx >= 0 and idx < count(targetResponse.prefetch.mboxes)%} quando o índice puder ser inválido. Expressões PQL não podem ser usadas como caminho. Disponível desde a versão 2025.9.0.

3. Analise a cadeia de caracteres JSON usando parseJson. O campo mbox options.content é uma cadeia de caracteres JSON bruta. parseJson o converte em um objeto estruturado cujos campos podem ser acessados diretamente no modelo.

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

   table 0-row-2 1-row-2 2-row-2
   Parâmetro	Descrição
   jsonStr	Caminho para o campo de string que contém JSON válido
   result	Nome da variável para armazenar o objeto analisado

   note
   NOTE
   Se a cadeia de caracteres JSON for inválida ou a referência for nula, result será definido como null — nenhum erro de renderização será lançado. Teste com sua resposta real do Target para confirmar se o conteúdo é um JSON válido. Disponível desde: 2026.6.0

4. Acessar os dados. Depois de analisada, use a notação de pontos para acessar os campos a partir de summerOfferContent. Para renderizar uma lista de recomendações:

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

Quando type é html, o campo content é uma cadeia de caracteres de HTML pronta para ser renderizada. Você não precisa analisá-lo. O exemplo abaixo mostra uma resposta típica da API de entrega para uma mbox do 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 e extraia a mbox e, em seguida, renderize content diretamente. Ignorar parseJson.

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