Utiliser des intégrations externes pour la personnalisation integrations-personalization

Lorsque type est json, le champ content est une chaîne JSON. Analysez-le avant d’accéder aux champs imbriqués. L’exemple ci-dessous illustre une réponse type de l’API Delivery pour une 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"
        }
      }
    ]
  }
}

Utilisez trois assistants successifs pour récupérer, extraire et analyser la réponse de Target.

1. Récupérer la réponse de Target Appelez votre intégration Target configurée avec externalDataLookup. Définissez integrationName sur le nom de cette intégration (remplacez l’exemple d’espace réservé target_recommendations). Utilisez le paramètre result pour nommer la variable de modèle qui contient la payload complète de l’API de diffusion, par exemple targetResponse.

   Vous pouvez également sélectionner l’intégration directement à partir du menu Intégrations dans le volet de navigation de gauche de l’éditeur de personnalisation. Consultez Application de la personnalisation de l’intégration à votre contenu.

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

2. Extrayez une mbox spécifique à l’aide de valueAtPath. valueAtPath extrait un élément d’un tableau à partir de son son index de base 0 et l’affecte à une variable de modèle. Utilisez le paramètre idx pour spécifier l’élément auquel accéder.

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

   table 0-row-2 1-row-2 2-row-2 3-row-2
   Paramètre	Description
   path	Chemin d’accès au tableau (position, pas de mot-clé)
   idx	Index de base 0 pour l’accès au tableau (facultatif)
   result	Nom de variable pour stocker la valeur extraite

   note
   NOTE
   Si idx est hors limites, le rendu renvoie une exception. Vérifiez que les index sont valides avec {%#if idx >= 0 and idx < count(targetResponse.prefetch.mboxes)%}. Les expressions PQL ne peuvent pas être utilisées comme chemin d’accès. Disponible depuis la version 2025.9.0.

3. Analysez la chaîne JSON à l’aide de parseJson. Le champ options.content de la mbox est une chaîne JSON brute. parseJson la convertit en un objet structuré dont les champs sont directement accessibles dans le modèle.

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

   table 0-row-2 1-row-2 2-row-2
   Paramètre	Description
   jsonStr	Chemin d’accès au champ de chaîne contenant un fichier JSON valide
   result	Nom de la variable pour stocker l’objet analysé

   note
   NOTE
   Si la chaîne JSON n’est pas valide ou si la référence est nulle, result est défini sur null et aucune erreur de rendu n’est renvoyée. Testez votre réponse Target actuelle pour confirmer que le contenu est un JSON valide. Disponible depuis : 2026.6.0

4. Accédez aux données. Une fois l’analyse effectuée, utilisez la notation par points pour accéder aux champs depuis summerOfferContent. Pour effectuer le rendu d’une liste de recommandations :

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

Lorsque type est html, le champ content est une chaîne HTML prête pour le rendu. Il n’est pas nécessaire de l’analyser. L’exemple ci-dessous illustre une réponse type de l’API Delivery pour une 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"
        }
      }
    ]
  }
}

Récupérez et extrayez la mbox, puis effectuez directement le rendu de content. Ignorez parseJson.

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