미리보기에서 모의 JSON으로 메시지 테스트

capture와 json_parse를 사용하여 메시지 내에서 API 또는 항목 스타일 JSON을 모의 구성하면, Campaign을 시작하거나 Canvas를 트리거하거나 실시간으로 연결된 콘텐츠를 호출하기 전에 작성기 미리보기에서 Liquid와 레이아웃을 검증할 수 있습니다.

이 예제에 대하여

가상의 의류 소매 브랜드인 Flash & Thread는 연결된 콘텐츠 응답, Canvas 컨텍스트 변수 또는 오브젝트 배열 프로필 데이터에 의존하는 메시지를 작성합니다. 모든 반복마다 실제 API 호출을 트리거하거나 Campaigns를 실행하면 개발 속도가 느려집니다.

이 패턴은 모의 JSON 페이로드를 메시지 본문에 임베드하고, capture로 저장한 다음 json_parse로 파싱하여 Liquid가 미리보기 섹션에서 구조화된 필드를 참조할 수 있도록 합니다. 실시간 연결된 콘텐츠 호출, API 트리거 Canvas 진입 또는 테스트 전송이 필요하지 않습니다.

이 패턴은 메시지 개발 중에 사용하세요. 실제 트리거, 테스트 전송 또는 Canvas의 사용자 경로 미리보기를 사용하는 포괄적인 테스트를 대체하지는 않습니다.

고려 사항

• 이 접근 방식은 개발 중 작성기 미리보기를 지원합니다. 고객에게 출시하기 전에 테스트 전송과 라이브 경로 확인을 실행하세요.
• capture 블록만으로는 JSON을 문자열로 저장합니다. json_parse를 적용한 후에만 필드를 참조하세요. 그렇지 않으면 미리보기 출력이 비어 있을 수 있습니다.
• 모의 JSON은 유효해야 합니다. 유효하지 않은 JSON은 json_parse가 실패하거나 예상치 못한 구조를 반환하게 합니다.
• 출시 전에 모의 블록을 교체하거나 제거하세요. 또는 프로덕션 Liquid에서 모의 데이터가 미리보기에서만 사용되도록 보호하세요(예: 출시 전에 삭제하는 주석 플래그 사용).
• 이 문서의 Liquid 스니펫은 예시입니다. 사용 중인 채널과 실제 페이로드 형태에서 테스트하세요.
• 프로덕션에서 연결된 콘텐츠를 사용하는 경우, 모의 블록을 제거하고 라이브 URL 태그를 사용하세요. API 호출하기를 참조하세요.

설정

이 예제에서는 listings를 반복하는 이메일을 위해 연결된 콘텐츠 스타일의 제품 목록 응답을 모킹합니다.

1단계: 메시지에서 모의 JSON 캡처하기

capture를 사용하여 JSON 문자열을 저장합니다. 블록 내부에서는 유효한 JSON 구문(키와 문자열 값에 큰따옴표)을 사용하세요.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{% capture mock_response %}
{
  "success": true,
  "listings": [
    {
      "id": 45731,
      "name": "Summit Trail Jacket",
      "image_url": "https://example.com/images/trail-jacket.png",
      "price": {
        "actual": "89.00",
        "currency": "USD"
      },
      "link": "https://example.com/products/trail-jacket",
      "product_category": "Outerwear",
      "properties": {
        "size": "L",
        "colour": "Navy",
        "limited_edition": false
      },
      "out_of_stock": false
    }
  ]
}
{% endcapture %}

2단계: json_parse로 JSON 파싱하기

파싱된 구조를 변수에 할당하면 나머지 메시지에서 참조할 수 있습니다.

1

{% assign response_json = mock_response | json_parse %}

json_parse 없이 캡처된 문자열에 도트 표기법을 사용하면(예: {{ mock_response.listings }}) 미리보기에서 일반적으로 빈 값으로 렌더링됩니다.

3단계: Liquid에서 파싱된 필드 참조하기

파싱된 배열을 반복하면서 실시간 API 응답과 동일한 방식으로 필드를 렌더링합니다.

1
2
3

{% for listing in response_json.listings %}
{{ listing.name }} — {{ listing.price.actual }} {{ listing.price.currency }}
{% endfor %}

메시지 작성기에서 미리보기 섹션으로 이동하여 필드가 올바르게 렌더링되는지 확인합니다.

4단계: 다른 JSON 형태에 동일한 패턴 적용하기

동일한 capture + json_parse 흐름으로 다음을 모킹할 수 있습니다.

출시 전에 모의 변수를 프로덕션 Liquid(Canvas 컨텍스트 변수, 커스텀 속성 또는 연결된 콘텐츠 태그)로 교체하세요.

관련 문서

• 테스트 메시지 보내기
• Canvas에서 사용자 경로 미리보기
• 고급 Liquid 필터 (json_parse)
• 연결된 콘텐츠
• 객체 배열
• 컨텍스트 변수