개인화에 외부 통합 사용 integrations-personalization

type이(가) json인 경우 content 필드는 JSON 문자열​입니다. 중첩된 필드에 액세스하기 전에 구문 분석합니다. 아래 예제는 JSON mbox에 대한 일반적인 배달 API 응답을 보여 줍니다.

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

세 개의 도우미를 순서대로 사용하여 Target 응답을 가져오고 추출하고 구문 분석합니다.

1. Target 응답을 가져옵니다. externalDataLookup(으)로 구성된 Target 통합을 호출합니다. integrationName을(를) 해당 통합의 Name(으)로 설정합니다(예제 자리 표시자 target_recommendations 대체). result 매개 변수를 사용하여 전체 배달 API 페이로드가 들어 있는 템플릿 변수의 이름을 지정하십시오(예: targetResponse).

   개인화 편집기의 왼쪽 탐색 영역에 있는 통합 메뉴에서 직접 통합을 선택할 수도 있습니다. 콘텐츠에 통합 개인화 적용을 참조하십시오.

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

2. valueAtPath를 사용하여 특정 mbox를 추출합니다. valueAtPath은(는) 배열에서 0 기반 인덱스로 요소를 추출하여 템플릿 변수에 할당합니다. idx 매개 변수를 사용하여 액세스할 요소를 지정합니다.

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

   table 0-row-2 1-row-2 2-row-2 3-row-2
   매개변수	설명
   path	배열 경로(위치, 키워드 없음)
   idx	스토리지 액세스를 위한 0 기반 인덱스 (선택 사항)
   result	추출된 값을 저장할 변수 이름

   note
   NOTE
   idx이(가) 범위를 벗어나면 렌더링에서 예외가 발생합니다. 인덱스가 잘못되었을 수 있는 경우 {%#if idx >= 0 and idx < count(targetResponse.prefetch.mboxes)%}(으)로 잘못된 인덱스를 보호하십시오. PQL 표현식은 경로로 사용할 수 없습니다. 릴리스 2025.9.0 이후 사용 가능.

3. parseJson을 사용하여 JSON 문자열을 구문 분석합니다. mbox options.content 필드는 원시 JSON 문자열입니다. parseJson은(는) 필드를 템플릿에서 직접 액세스할 수 있는 구조화된 개체로 변환합니다.

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

   table 0-row-2 1-row-2 2-row-2
   매개변수	설명
   jsonStr	유효한 JSON이 포함된 문자열 필드의 경로
   result	구문 분석된 개체를 저장할 변수 이름

   note
   NOTE
   JSON 문자열이 잘못되었거나 참조가 null이면 result이(가) null(으)로 설정됩니다. 렌더링 오류가 발생하지 않습니다. 실제 Target 응답으로 테스트하여 콘텐츠가 유효한 JSON인지 확인합니다. 사용 가능한 날짜: 2026.6.0

4. 데이터에 액세스합니다. 구문 분석되면 점 표기법을 사용하여 summerOfferContent의 필드에 액세스합니다. 권장 사항 목록을 렌더링하려면 다음을 수행하십시오.

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

type이(가) html인 경우 content 필드는 렌더링할 준비가 된 HTML 문자열입니다. 구문 분석할 필요가 없습니다. 아래 예제는 HTML mbox에 대한 일반적인 배달 API 응답을 보여 줍니다.

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

mbox를 가져와서 추출한 다음 content을(를) 직접 렌더링합니다. parseJson을(를) 건너뛰십시오.

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