콘텐츠 반복 기능 사용 방법

학습 내용

클라비요 이메일 템플릿의 섹션 또는 블록에 블록 반복 기능을 사용하는 방법을 알아보세요. 이 기능을 사용하면 수신자의 이벤트 또는 프로필 데이터 또는 데이터 피드에서 데이터 배열(즉, 목록)의 각 항목에 대해 블록 또는 섹션의 콘텐츠를 반복할 수 있습니다.

시작하기 전 안내 사항

이메일에서 이벤트, 프로필 또는 카탈로그 데이터를 사용하는 것이 익숙하지 않다면 먼저 메시지 개인화 참고자료를 확인하세요. 

클라비요의 데이터 유형, 특히 목록(예: 배열)을 이해하는 것도 도움이 될 것입니다. 배열은 동일한 방식으로 구조화된 여러 개의 데이터를 저장합니다. 예를 들어, 고객이 구매한 품목은 주문 완료 이벤트 내에 배열로 저장됩니다. 품목 배열에는 주문한 품목당 1개의 항목이 포함되며, 각 항목에는 품목 이름, 이미지 URL, 수량, 크기, 색상 등 1개 품목에 대한 세부 정보가 포함됩니다. 

콘텐츠 반복 기능 사용 사례

콘텐츠 반복 기능을 사용하려면 데이터 배열 또는 목록이 필요합니다. 아래 표에는 클라비요 계정에 존재할 수 있는 데이터 배열의 몇 가지 예와 샘플 사용 사례가 나와 있습니다. 

콘텐츠 반복 기능은 구독자의 프로필이나 이벤트 데이터 또는 웹 피드 중 하나에 저장된 모든 배열에서 사용할 수 있습니다. 위의 예는 이 기능을 사용하는 방법의 작은 샘플에 불과합니다.

콘텐츠 반복 기능 사용 방법

콘텐츠 반복 기능을 사용하려면 반복하려는 섹션 또는 블록으로 이동한 다음 표시 옵션을 클릭합니다. 콘텐츠 반복 섹션에서 콘텐츠 반복 생성을 클릭합니다. 

두 개의 필드가 표시됩니다: 반복 대상 및 항목 별칭입니다. 이러한 필드를 채우고 반복 콘텐츠를 설정하려면 아래 단계를 따르세요: 

1. "반복 대상" 식별
2. "항목 별칭"을 선택합니다. 
3. 반복되는 콘텐츠 구축
4. 이메일 미리보기

"반복 대상" 식별 

반복할 배열의 이름을 반복 대상 필드에 추가합니다.

배열의 이름을 찾으려면 데이터 소스(예: 프로필 데이터, 이벤트 데이터 또는 데이터 피드)에서 데이터를 확인합니다. 이 예제에서는 이벤트 데이터에서 배열을 찾는 방법을 살펴보겠습니다: 

1. 이메일 템플릿에서 미리 보기 및 테스트를 클릭합니다.
2. 이벤트를 클릭합니다.
3. 이 플로우 이메일을 트리거할 이벤트를 선택합니다(예: 결제 시작).
4. 필요한 정보가 포함된 배열을 찾을 때까지 이벤트의 미리 보기 데이터를 스크롤합니다. 데이터 왼쪽의 화살표 아이콘을 사용하여 필요하지 않은 섹션을 축소하고 탐색하기 쉽게 만들 수 있습니다.
   

   이 예제에는 항목 정보를 저장하는 두 개의 배열이 있습니다: 

   • 항목
     최상위 배열로 각 항목 이름의 간단한 목록을 포함하지만 다른 정보는 포함하지 않습니다.
   • Line_items
     추가 배열 내에 중첩되며 각 항목의 제목, 가격, SKU 및 이미지 URL을 포함한 자세한 내용을 포함합니다.
     

   이 경우 반복 블록에 표시하는 데 필요한 세부 정보가 포함되어 있으므로 더 자세한 배열인 line_items를 사용하고 싶을 것입니다. 반복 대상 필드에 설정할 적절한 변수를 찾으려면 배열의 첫 번째 섹션에서 두 개의 변수를 찾아 복사합니다. 이 예제에서는 variant_price 및 title에 대한 변수를 복사합니다. 다음은 복사한 두 개의 태그입니다: 

   {{ event.extra.line_items.0.variant_price }}

   {{ event.extra.line_items.0.title }}

5. 중괄호는 무시하고 그 안에 있는 변수를 살펴보세요. 두 변수의 시작이 event.extra.line_items.0으로 동일하다는 점에 유의하세요. 

   변수의 이 부분 끝에 있는 점과 숫자까지(단, 제외)를 모두 반복 대상으로 사용합니다. 이 예제에서 반복 대상 필드에 적합한 설정은 event.extra.line_items입니다.

아이템 별칭 선택

아이템 별칭은 특수 문자나 공백 없이 원하는 모든 텍스트를 사용할 수 있습니다. 반복 블록 내에서 이 별칭을 사용하여 위에서 선택한 배열에서 가져와야 하는 변수를 식별할 수 있습니다. 기억하기 쉽도록 간단하지만 설명이 포함된 별칭을 선택하세요. 

예를 들어 블록이 버려진 카트의 항목 목록에서 반복되는 경우 item을 사용하면 좋은 별칭이 됩니다. 블로그 글 목록에서 블록이 반복되는 경우 별칭으로 post를 사용할 수 있습니다.

원하는 별칭을 사용할 수 있지만, 배열의 변수에 해당 별칭을 일관되게 사용해야 합니다(다음 단계에 설명된 대로). 

반복 대상 및 항목 별칭 필드를 채우고 나면 변경 사항 저장을 클릭하고 콘텐츠 작성을 시작합니다. 

반복되는 블록/섹션 만들기

반복 대상 및 항목 별칭 설정을 설정한 후에는 콘텐츠 블록에 개인화 태그를 추가하여 반복합니다. 프로필 및 이벤트 데이터를 포함하여 모든 유형의 변수를 이 블록에 추가할 수 있지만 배열에서 가져오는 태그(예: 주문한 항목 목록)는 약간 조정해야 합니다. 

위의 예에서 사용된 전체 제목 및 이형 상품 가격 변수는 다음과 같습니다: 

{{ event.extra.line_items.0.variant_price }}

{{ event.extra.line_items.0.title }}

위의 변수를 블록에 추가하면 배열의 항목당 블록이 한 번씩 반복되지만, 반복될 때마다 배열의 첫 번째 항목의 제목과 가격이 표시됩니다. 

각 품목의 제목과 가격을 표시하려면 반복 설정(event.extra.line_items)에서 텍스트를 교체합니다, 뒤에 점과 숫자(.0)를 더한 후 아이템 별칭(항목)을 입력합니다. 이 예제의 결과 변수는 다음과 같습니다: 

{{ item.variant_price }}

{{ item.title }}

배열에 포함하려는 다른 변수에 대해서도 이 과정을 반복합니다. 

이메일 미리보기 및 문제 해결

반복 블록을 작성했으면 이메일을 미리 봅니다. 이메일이 이벤트 데이터를 참조하는 경우 블록을 작성하는 데 사용한 것과 동일한 이벤트(즉, 이 플로우를 트리거할 이벤트)를 선택합니다. 블록이 프로필 데이터를 참조하는 경우 올바른 변수가 있는 프로필을 선택합니다. 

미리보기 이메일의 반복 블록이 비어 있거나 예상한 모든 콘텐츠가 포함되어 있지 않은 경우 위의 단계로 돌아가세요. 위의 단계에 따라 반복 대상, 항목 별칭 및 모든 사용자 지정 변수가 올바르게 구성되었는지 확인하세요. 그런 다음 사용 중인 미리보기 데이터를 검토하여 올바른 이벤트를 선택했는지, 선택한 샘플 이벤트에 필요한 데이터가 포함되어 있는지 확인합니다. 

추가 리소스

• 메시지 개인화 참조
• 이메일 템플릿 편집기 가이드