Verwenden externer Integrationen für die Personalisierung integrations-personalization

Wenn es sich bei type um json handelt, ist das Feld content eine JSON-Zeichenfolge. Führen Sie eine Analyse durch, bevor Sie auf verschachtelte Felder zugreifen. Das folgende Beispiel zeigt eine typische Bereitstellungs-API-Antwort für eine JSON-Mbox.

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

Verwenden Sie drei Helper nacheinander, um die Target-Antwort abzurufen, zu extrahieren und zu analysieren.

1. Abrufen der Target-Antwort. Rufen Sie Ihre konfigurierte Target-Integration mit externalDataLookup auf. Legen Sie integrationName auf den Namen dieser Integration fest (ersetzen Sie den Beispielplatzhalter target_recommendations). Verwenden Sie den Parameter result, um die Vorlagenvariable zu benennen, die die vollständige Payload der Bereitstellungs-API enthält, z. B. targetResponse.

   Sie können die Integration auch direkt über das Menü Integrationen im linken Navigationsbereich des Personalisierungseditors auswählen. Siehe Anwenden der Integrationspersonalisierung auf Ihre Inhalte.

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

2. Extrahieren einer spezifischen Mbox mithilfe von valueAtPath. valueAtPath extrahiert ein Element anhand seines 0-basierten Index aus einem Array und weist es einer Vorlagenvariablen zu. Verwenden Sie den Parameter idx, um anzugeben, auf welches Element zugegriffen werden soll.

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

   table 0-row-2 1-row-2 2-row-2 3-row-2
   Parameter	Beschreibung
   path	Pfad zum Array (Position, kein Keyword)
   idx	0-basierter Index für den Array-Zugriff (optional)
   result	Variablenname zum Speichern des extrahierten Werts

   note
   NOTE
   Wenn idx außerhalb des gültigen Bereichs liegt, löst das Rendern eine Ausnahme aus. Sichern Sie ungültige Indizes mit {%#if idx >= 0 and idx < count(targetResponse.prefetch.mboxes)%}, wenn der Index ungültig sein könnte. PQL-Ausdrücke können nicht als Pfad verwendet werden. Verfügbar seit Version 2025.9.0.

3. Analysieren der JSON-Zeichenfolge mithilfe von parseJson. Das Mbox-Feld options.content ist eine unbearbeitete JSON-Zeichenfolge. parseJson wandelt diese in ein strukturiertes Objekt um, auf dessen Felder anschließend direkt in der Vorlage zugegriffen werden kann.

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

   table 0-row-2 1-row-2 2-row-2
   Parameter	Beschreibung
   jsonStr	Pfad zum Zeichenfolgenfeld, das eine gültige JSON-Zeichenfolge enthält
   result	Variablenname zum Speichern des geparsten Objekts

   note
   NOTE
   Wenn die JSON-Zeichenfolge ungültig ist oder die Referenz null ist, wird result auf null gesetzt – es wird kein Renderfehler ausgelöst. Testen Sie mit Ihrer tatsächlichen Target-Antwort, um zu bestätigen, dass der Inhalt eine gültige JSON-Zeichenfolge ist. Verfügbar seit: 2026.6.0

4. Zugreifen auf die Daten. Verwenden Sie nach der Analyse die Punktnotation, um auf Felder von summerOfferContent zuzugreifen. So rendern Sie eine Liste von Empfehlungen:

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

Wenn es sich bei type um html handelt, ist das Feld content eine renderbereite HTML-Zeichenfolge. Sie müssen sie nicht parsen. Das folgende Beispiel zeigt eine typische Bereitstellungs-API-Antwort für eine HTML-Mbox.

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

Rufen Sie die Mbox ab, extrahieren Sie sie und rendern Sie content direkt. Überspringen Sie parseJson.

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