Utilizzo di integrazioni esterne per la personalizzazione integrations-personalization

Quando type è json, il campo content è una stringa JSON. Analizzalo prima di accedere ai campi nidificati. L’esempio seguente mostra una tipica risposta dell’API di consegna per una 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"
        }
      }
    ]
  }
}

Utilizza tre helper in sequenza per recuperare, estrarre e analizzare la risposta di Target.

1. Recupera la risposta di Target. Chiamare l’integrazione di Target configurata con externalDataLookup. Imposta integrationName sul Nome di tale integrazione (sostituisci il segnaposto di esempio target_recommendations). Utilizza il parametro result per denominare la variabile modello che contiene il payload completo dell’API di consegna, ad esempio targetResponse.

   Puoi anche selezionare l’integrazione direttamente dal menu Integrazioni nell’area di navigazione a sinistra dell’editor di personalizzazione. Vedi Applica personalizzazione integrazione al contenuto.

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

2. Estrarre una mbox specifica utilizzando valueAtPath. valueAtPath estrae un elemento da un array in base al relativo indice basato su 0 e lo assegna a una variabile di modello. Utilizzare il parametro idx per specificare a quale elemento accedere.

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

   table 0-row-2 1-row-2 2-row-2 3-row-2
   Parametro	Descrizione
   path	Percorso dell’array (posizionale, nessuna parola chiave)
   idx	Indice basato su 0 per l’accesso all’array (facoltativo)
   result	Nome della variabile per memorizzare il valore estratto

   note
   NOTE
   Se idx supera i limiti, il rendering genera un'eccezione. Controllare gli indici non validi con {%#if idx >= 0 and idx < count(targetResponse.prefetch.mboxes)%} quando l'indice potrebbe non essere valido. Le espressioni PQL non possono essere utilizzate come percorso. Disponibile dalla versione 2025.9.0.

3. Analizzare la stringa JSON utilizzando parseJson. Il campo mbox options.content è una stringa JSON non elaborata. parseJson lo converte in un oggetto strutturato i cui campi sono quindi accessibili direttamente nel modello.

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

   table 0-row-2 1-row-2 2-row-2
   Parametro	Descrizione
   jsonStr	Percorso del campo stringa contenente JSON valido
   result	Nome della variabile per memorizzare l’oggetto analizzato

   note
   NOTE
   Se la stringa JSON non è valida o il riferimento è nullo, result è impostato su null. Non viene generato alcun errore di rendering. Esegui il test con la risposta Target effettiva per confermare che il contenuto è un JSON valido. Disponibile da: 2026.6.0

4. Accedere ai dati. Dopo l’analisi, utilizzare la notazione del punto per accedere ai campi da summerOfferContent. Per eseguire il rendering di un elenco di consigli:

   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, il campo content è una stringa di HTML pronta per il rendering. Non è necessario analizzarlo. L’esempio seguente mostra una tipica risposta dell’API di consegna per una mbox 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"
        }
      }
    ]
  }
}

Recupera ed estrai la mbox, quindi esegui direttamente il rendering di content. Ignora parseJson.

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