카탈로그 조회 태그 참조

학습 내용

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

{% catalog %} 태그

{% catalog %} 태그는 다음 구문을 사용해요:

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

itemID를 참조하려는 제품의 제품 ID로 바꿔 주세요. 이는 자체 제품 카탈로그에서 동기화된 제품 ID입니다. 참고: 이 조회는 SKU가 아니라 제품 ID에 대해서만 적용돼요.

unpublished="cancel"을 포함하면 참조된 항목이 게시되지 않은 경우 메시지가 전송되지 않도록 할 수 있어요. 이 인수는 선택 사항이에요.

• 조회 시점에 메시지에서 참조한 항목 중 하나라도 카탈로그에 미게시 상태이면 메시지 전체가 건너뛰어져요.
• 특정 플로우 메시지의 경우 분석 > 수신자 활동 > 기타로 이동하면 건너뜀: 카탈로그 항목을 사용할 수 없음으로 표시된 목록을 확인할 수 있어요. 이 목록에는 메시지에 포함된 항목이 품절이거나 기타 사유로 사용할 수 없어 건너뛴 모든 프로필이 포함돼요.

이 기능을 사용할 때는 여는 카탈로그 태그와 닫는 카탈로그 태그 사이에서 Klaviyo 제품 카탈로그의 itemID와 연결된 항목의 특정 데이터를 참조할 수 있어요.

다음 데이터는 {% catalog %} 블록 내에서 참조할 수 있어요.

메타데이터로 간주되는 추가 데이터 필드가 있을 수 있어요. 이러한 추가 항목 속성 중 하나를 참조하려면 변수 구문을 사용할 수 있어요: {{ catalog_item.metadata.color }}. 이 경우 변수는 항목의 메타데이터에 저장된 항목과 연결된 “color” 값을 가져와요.

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

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

그런 다음 메시지를 미리보기하세요. 이 미리보기에서는 제품에 사용할 수 있는 모든 데이터의 원시 버전을 확인할 수 있어요.

카탈로그 ID로 필터링

여러 카탈로그가 있는 경우 {{catalog id}} 태그를 사용해 어떤 카탈로그에서 가져올지 지정할 수 있어요. 예를 들어 Shopify 같은 Klaviyo 연동을 통해 동기화된 카탈로그, API를 통해 동기화된 카탈로그 또는 커스텀 카탈로그 피드가 있을 수 있어요. 태그 세부 정보는 연동에 따라 달라질 수 있어요. 다음 예에서는 여러 카탈로그가 동일한 Klaviyo 계정에 동기화되어 있으며, API 카탈로그에 포함된 특정 제품에서 제품 설명을 가져오려고 해요.

먼저, 카탈로그 ID를 찾으세요:

1. Klaviyo에서 콘텐츠 > 제품으로 이동하세요.
2. 모든 카탈로그 드롭다운에서 사용할 카탈로그를 선택하세요.
   

3. URL에서 카탈로그 ID를 복사하세요.
   

그런 다음 항목 ID를 찾으세요:

1. 카탈로그를 선택한 후, 카탈로그에서 사용할 제품을 선택하세요.
2. 제품 세부정보 페이지에서 Item ID가 표시돼요.
   

위 예시의 경우 코드는 다음과 같이 표시돼요:

{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935"%} {{ catalog_item.description }}{% endcatalog %}

로케일별 필터링

Klaviyo의 Shopify 카탈로그처럼 로캘을 인식하는 카탈로그는 로캘별로 검색할 수 있어요. 로캘의 언어와 지역은 ISO 3166 및 639 표준을 사용해 2자리 국가 코드와 언어 코드로 참조할 수 있어요. 현지화된 제품을 찾을 수 없으면 기본 제품 정보가 사용돼요.

{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935" language='fr' region='CA' %} {{ catalog_item.description }}{% endcatalog %}

이벤트와 함께 전달된 항목 ID 조회

이벤트와 함께 카탈로그 조회를 사용하는 경우는 대부분 다음과 같은 시나리오에서 사용돼요:

• 이벤트와 함께 전달된 제품 추천을 메시지에 표시하는 맞춤 연동을 사용 중인 경우예요. 예를 들어, 조회한 상품을 기반으로 고유한 추천이 생성되는 탐색 이탈 메시지 같은 경우요. 메시지에 고객이 조회한 단일 상품을 채우는 대신, 조회한 해당 상품을 기반으로 추천 상품 세트를 생성해 채울 수 있어요. 상품 ID 세트를 이벤트와 함께 Klaviyo로 전송해야 해요.
• 커스텀 연동을 사용 중이고 메시지에 포함되어야 하는 모든 제품 세부 정보를 전송하고 싶지 않은 경우가 있어요. 예를 들어 장바구니 이탈 메시지의 경우, 이탈된 모든 항목의 제품 ID만 전송하면 Klaviyo에서 각 항목을 조회해 관련된 모든 세부 정보를 가져올 수 있어요. Klaviyo에 제품 ID만 전달한 다음 Klaviyo 제품 카탈로그에서 정보를 조회하면 이 모든 내용을 채울 수 있으므로, 모든 이벤트에 제품명, 가격, 이미지 등을 포함할 필요는 없어요.

이벤트와 함께 {% catalog %} 태그를 사용하는 경우 조회는 카탈로그 항목의 Item ID를 기준으로 합니다(연동에 따라 Product ID 또는 SKU 중 하나일 수 있음).

식별 값으로 상품 ID가 전달되는 이벤트의 경우, 조회 태그는 다음과 같이 표시돼요:

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

이 {% catalog %} 블록에서 각 항목과 관련해 채우고 싶은 데이터(예: 템플릿 태그 제목, 이미지 등)를 위한 템플릿 태그를 추가합니다.

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

카탈로그 항목 데이터:

{
  "description": "Standard issue for all Klaviyos. This t-shirt has the Klaviyo logo on the front and mark diagram on the back.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "title": "Classic Klaviyo T-Shirt",
  "featured_image": {
    "full": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-full.png"
    },
    "thumbnail": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-thumbnail.png"
    }
  },
  "id": "KLAVIYO-TSHIRT",
  "metadata": {
    "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를 Klaviyo의 프로필에 전달할 수 있어요. {% catalog %} 태그를 사용하면 이 고객에게 메시지를 보낼 때 이러한 제품 중 어떤 제품에서든 정보를 참조할 수 있어요.

조회에서 찾으려는 항목을 찾지 못하면 메시지는 건너뛰며 전송되지 않아요.

단일 속성에 저장된 여러 항목 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 %}
I am on sale!
{% else %}
{% endif %}
{% endcatalog %}

이 예시는 제품 제목을 표시한 다음, 제품이 category_name 카테고리에 속하는지 확인합니다. 이 값이 true로 평가되면 제품 제목 뒤에 “할인 중이에요!”라는 메시지가 표시됩니다.