카탈로그 조회 태그 참조

학습 내용

이메일, SMS 및 푸시 메시지 내에서 카탈로그의 특정 제품 정보를 참조할 수 있는 카탈로그 태그 사용 방법을 알아보세요. 사용자 지정 제품 추천을 만들거나 제품 정보를 상호 참조하려는 경우에 유용합니다. 예를 들어 자체 추천 엔진을 사용하는 경우 자체 제품 추천을 이벤트 또는 프로필 데이터로 Klaviyo 으로 전달한 다음 템플릿에서 해당 데이터를 활용할 수 있습니다.

0}{% catalog %} 태그

1} 태그는 다음 구문을 {% catalog %} 사용합니다:

{% catalog itemID unpublished="cancel" %}
...
{% endcatalog %}

itemID를 참조하려는 제품의 제품 ID로 바꿉니다. 자체 제품 카탈로그에서 동기화된 제품 ID입니다. 이 조회는 SKU가 아닌 제품 ID에 대한 조회입니다.

미게시 포함="취소" 참조된 항목이 미게시인 경우 메시지를 보내지 않도록 합니다. 이 인수는 선택 사항입니다. 

• 메시지에서 참조된 항목이 조회 시점에 카탈로그에 게시되지 않은 경우 전체 메시지를 건너뜁니다.
• 주어진 흐름 메시지의 경우 분석 > 수신자 활동 > 기타로 이동하여 건너뛰었다고 표시된 목록을 확인할 수 있습니다: 카탈로그 항목을 사용할 수 없습니다. 이 목록에는 메시지에 포함된 품목이 품절되었거나 다른 이유로 사용할 수 없어 건너뛴 모든 프로필이 포함됩니다.

이 기능을 사용할 때 카탈로그 태그를 열고 닫는 사이에 클라비요 제품 카탈로그의 itemID와 연결된 항목의 특정 데이터를 참조할 수 있습니다.

1} 블록 내에서 {% catalog %} 참조할 수 있는 데이터는 다음과 같습니다.

메타데이터로 간주되는 추가 데이터 필드가 있을 수 있습니다. 이러한 추가 항목 속성 중 하나를 참조하려면 변수 구문을 사용할 수 있습니다: {{ catalog_item.metadata.color }}. 이 경우 변수는 항목의 메타데이터에 저장된 항목과 관련된 "색상" 값을 가져옵니다.

모든 메타데이터를 포함하여 항목에 저장된 사용 가능한 모든 세부 정보의 미리 보기에 액세스하려면 테스트 템플릿의 텍스트 블록에 다음 코드 조각을 추가하고 itemID를 카탈로그에 있는 현재 제품 중 하나의 제품 ID로 업데이트합니다.

{% catalog itemID %}
{{ catalog_item }}
{% endcatalog %}

그런 다음 메시지를 미리 봅니다. 이 미리 보기는 제품에 사용할 수 있는 모든 데이터의 원시 버전을 제공합니다.

또한 여러 개의 카탈로그가 있는 경우(즉, 여러 개의 사용자 지정 카탈로그를 계정에 동기화하는 경우) {{ catalog_id }} 태그를 사용하여 가져올 카탈로그를 지정할 수 있습니다. 예를 들어 

{% catalog "womens-jewelry-bundle" integration="demandware" catalog_id="catalogID"%} {{ catalog_item.internal_id }} {% endcatalog %}

이벤트와 함께 전달된 아이템 ID 조회

이벤트와 함께 카탈로그 조회를 사용하는 것은 주로 다음 시나리오에서 사용됩니다:

• 제품 추천이 이벤트와 함께 전달되어 메시지에 표시되는 사용자 지정 통합을 사용하는 경우. 예를 들어, 열람한 항목을 기반으로 고유한 추천이 생성되는 검색 포기 메시지를 예로 들 수 있습니다. 고객이 메시지에서 조회한 단일 항목을 채우는 대신 조회한 항목을 기반으로 추천 항목 집합을 생성하여 채울 수 있습니다. 이벤트와 함께 제품 ID 세트를 클라비요에 보내야 합니다.
• 사용자 지정 통합을 사용 중이며 메시지에 포함해야 하는 모든 제품 세부 정보를 보내지 않으려는 경우. 예를 들어, 버려진 장바구니 메시지에서는 버려진 모든 품목의 제품 ID만 보내면 클라비요가 각 품목을 조회하여 모든 관련 세부 정보를 가져올 수 있습니다. 모든 이벤트에 제품 이름, 가격, 이미지 등을 포함할 필요 없이 제품 ID만 클라비요에 전달한 다음 클라비요 제품 카탈로그에서 정보를 조회하면 이 모든 것을 채울 수 있습니다.

이벤트와 함께 {% catalog %} 태그를 사용하는 경우 조회는 카탈로그 항목의 항목 ID(통합에 따라 제품 ID 또는 SKU가 됨)를 기준으로 합니다.

전달된 식별 값이 Item ID인 이벤트의 경우 조회 태그는 다음과 같이 표시됩니다:

{% catalog event.ItemID %}
...
{% endcatalog %}

이 {% catalog %} 블록 내에서 각 항목과 관련하여 채우려는 데이터에 대한 템플릿 변수를 추가합니다(예 제목, 이미지 등)

예를 들어 아래의 샘플 카탈로그 항목 데이터를 사용하여 주요 제품 정보를 참조하는 {% catalog %} 블록을 작성할 수 있습니다:

카탈로그 항목 데이터:

{
  "설명": "모든 클라비요의 표준 이슈입니다. 이 티셔츠는 앞면에는 클라비요 로고가, 뒷면에는 마크 다이어그램이 있습니다.",
  "URL": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "제목": "클래식 클라비요 티셔츠",
  "featured_image": {
   "full": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-full.png"
    },
   "썸네일": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-thumbnail.png"
    }
  },
  "id": "클라비요-티셔츠",
  "메타데이터": {
    "Color": "Grey",
    "Design": "Standard"
  }
}

템플릿 블록 구문:

다음 {% catalog %} 블록의 구문은 이벤트의 각 항목에 대해 카탈로그에서 항목 이미지, 항목 제목 및 항목 설명을 가져옵니다:

{% for item in event.Items %}
	{% catalog item.SKU %}
 		<img src="{{ catalog_item.featured_image.full.src }}"/>
 		{{ catalog_item.title }}
 		{{ catalog_item.description }}
 	{% endcatalog %}
{% endfor %}

조회에서 찾고 있는 항목을 찾을 수 없는 경우에는 메시지를 건너뛰고 전송하지 않습니다.

사용자 지정 속성으로 항목 ID 조회

자체 추천 엔진을 사용하는 경우 추천 항목 ID를 사용자 지정 프로필 속성으로 클라비요의 프로필에 전달할 수 있습니다. {% catalog %} 4} 태그를 사용하면 이 고객에게 메시지를 보낼 때 이러한 제품의 정보를 참조할 수 있습니다.

조회에서 찾고 있는 항목을 찾을 수 없는 경우에는 메시지를 건너뛰고 전송하지 않습니다.

단일 속성에 저장된 여러 항목 ID에 대한 구문

{% for item in person|lookup:'Recommended Products' %}{% catalog item %} 

<img src="{{ catalog_item.featured_image.thumbnail.src }}" style="display: inline-block; border: none" width="150px" />

<p>{{ catalog_item.title }} {% endcatalog %}</p>

{% endfor %}

프로필 속성의 단일 항목 ID 구문

{% catalog person|lookup:"Recommended Products" %} 

<img style="display: inline-block; border: none;" src="{{ catalog_item.featured_image.thumbnail.src }}" width="150px"/>

  <p>{{ catalog_item.title }} {% endcatalog %}</p>

has_category 태그 정보

has_category 태그를 사용하여 카탈로그의 항목이 특정 카테고리에 속하는지 여부를 확인합니다. 특정 항목에 대한 카탈로그 조회 태그 내에서 사용해야 합니다. 

이 태그를 사용하려면 아래 샘플 코드를 사용하여 itemID를 카탈로그의 제품 ID로, category_name을 카테고리 이름의 전체 또는 일부로 대체합니다. 

{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
세일 중입니다!
{% else %}
{% endif %}
{% endcatalog %}

이 예제에서는 제품 제목을 표시한 다음 제품이 카테고리 카테고리_이름에 속하는지 확인합니다. 이 평가가 사실로 확인되면 제품 제목 뒤에 "세일 중입니다!"라는 메시지가 표시됩니다. 

추가 리소스

• 제품 피드 및 추천 사용 방법
• 이메일 템플릿 편집기 개요