Shoply가 사용할 수 있는 상품 메타필드 제어하기

AI 쇼핑 어시스턴트는 상품 정보를 읽고, 질문에 답하며, 추천을 제공하여 고객을 돕도록 설계되었습니다.

하지만 모든 상품 데이터가 고객에게 공개되어야 하는 것은 아닙니다. 일부 상품 메타필드 에는 내부 정보(예: 이익률), 공급업체 세부 정보 또는 비공개로 유지해야 하는 기타 속성이 포함될 수 있습니다. 이런 경우 고객 질문에 답할 때 Shoply가 해당 메타필드를 사용하지 않도록 설정할 수 있습니다.

Shoply는 고객 질문에 답할 때 사용할 수 있는 메타필드를 AI로 자동 판단합니다. 하지만 완전한 제어 권한을 제공하기 위해, Shoply에서는 특정 상품 메타필드 또는 메타필드 네임스페이스 전체를 **블랙리스트(제외)**에 추가할 수 있습니다.

이 가이드에서는 이 기능이 유용한 이유와 구성 방법을 설명합니다.

고급 설정은 어디에서 찾을 수 있나요?

앱 관리자 콘솔의 “설정” 섹션으로 이동한 다음, 아래로 스크롤하여 “고급 설정” 섹션을 찾으세요. 이 섹션에서 다양한 설정을 구성할 수 있도록 JSON 객체 를 입력할 수 있습니다.

블랙리스트 설정

이 설정을 사용하면 고객 질문에 답할 때 Shoply가 특정 상품 메타필드를 사용하지 못하도록 할 수 있습니다.

`blacklist_product_fields`

제외하려는 정확한 메타필드 키(필드 이름)의 목록입니다. 필드 이름은 Shopify에 표시되는 메타필드의 키와 정확히 일치해야 합니다.

메타필드 키 예시:

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

참고: 상품의 공급업체를 표시하고 싶지 않다면 “brand”를 블랙리스트에 추가해야 합니다. 레거시 호환을 위해 Shoply가 brand 메타필드에 공급업체 정보를 저장하기 때문입니다.

`blacklist_display_filters`

필터/패싯 UI에서만 숨길 정확한 메타필드 키의 목록입니다. blacklist_product_fields와 달리, 이 필드들은 고객 질문에 답하기 위한 AI에서 계속 사용할 수 있으며, 검색 인터페이스에서 선택 가능한 필터로 표시되지 않을 뿐입니다.

메타필드에 AI가 알아야 할 유용한 상품 정보가 포함되어 있지만 고객용 필터로는 적합하지 않을 때 유용합니다.

예시:

warehouse_region — AI에 유용한 맥락이지만 고객에게 유용한 필터는 아님
care_instructions — AI 답변에는 좋지만 의미 있는 필터 카테고리는 아님

`blacklist_namespaces`

AI가 무시하도록 할 전체 네임스페이스 의 목록입니다.

예시:

RenterInfo

메타필드가 블랙리스트에 추가된 네임스페이스에 속하면 해당 네임스페이스의 모든 필드가 자동으로 제외됩니다.

전체 네임스페이스가 내부용이거나 민감한 정보인 경우 유용합니다.

블랙리스트 지정 팁

블랙리스트에 추가하는 것이 권장되는 항목:

공급업체 코드
창고 / 재고 세부 정보
내부 주문 처리 메모
다른 앱에서 사용하는 메타필드
고객에게 표시해서는 안 되는 모든 필드

다음과 같은 필드는 블랙리스트에 추가하지 마세요:

상품명
설명
소재
크기, 치수 또는 사양
성분
관리 방법
변형 상품 이름/옵션

(이러한 정보가 있어야 AI가 더 나은 답변을 제공할 수 있습니다.)

태그로 상품 데이터 보강하기

`split_tag_to_metafield_by`

Shopify 태그는 상품에 라벨을 지정하는 편리한 방법이지만, 문자열의 단순 목록으로 저장되므로 구조화된 필터로 사용할 수 없습니다. 이 설정을 사용하면 key:value 형식의 태그를 Shoply가 색인하고 필터링에 사용할 수 있는 적절한 메타필드로 변환할 수 있습니다.

작동 방식:

태그에 사용된 구분 문자로 split_tag_to_metafield_by를 설정하세요. Shoply는 각 태그를 해당 문자로 나누고, 왼쪽을 메타필드 키로, 오른쪽을 값으로 처리한 뒤 그에 따라 색인합니다.

예를 들어 상품에 다음과 같은 태그가 있다고 가정해 보겠습니다:

plaintext


material:aluminum
color:matte-black
compatible-with:iPhone 15

구분 문자를 ":"로 설정하면 다음과 같은 메타필드가 생성됩니다:

키	값
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

이렇게 색인된 메타필드는 기본 Shopify 메타필드와 마찬가지로 Shoply AI 검색에서 패싯 필터로 사용할 수 있습니다.

구분 문자가 포함되지 않은 태그는 이 설정에서 무시되며 일반 태그로 남습니다.

구성 예시:

json


{
  "split_tag_to_metafield_by": ":"
}

사용 시점:

스토어에서 이미 속성에 key:value 태그를 사용하고 있는 경우(예: 대량 가져오기 또는 서드파티 앱으로 생성된 태그)
공식 Shopify 메타필드 정의를 만들지 않고 필터링 가능한 속성을 추가하려는 경우
카탈로그의 태그를 다시 지정하지 않고 구조화된 상품 데이터를 Shoply에 빠르게 노출해야 하는 경우

상품 표시 제어하기

이 설정을 사용하면 채팅 또는 검색 인터페이스에 상품이 표시될 때 어떤 정보가 보이는지 제어할 수 있습니다.

`hide_discount`

true로 설정하면 상품 표시에 할인율(예: “-40%“)이 숨겨집니다. 고객에게 할인을 강조하고 싶지 않을 때 유용합니다.

`hide_price`

true로 설정하면 정가와 할인 가격을 포함한 모든 가격 정보가 숨겨집니다. 고객이 가격을 확인하려면 상품 페이지를 방문하도록 하거나, 채팅/검색 인터페이스에서 가격을 숨겨야 하는 가격 전략을 사용하는 경우 이 설정을 사용하세요.

`hide_review`

true로 설정하면 상품 표시에 리뷰 평점이 표시되지 않습니다. 채팅/검색 인터페이스에서 리뷰 점수가 고객의 결정에 영향을 주지 않도록 하려는 경우 유용합니다.

유효한 JSON 객체 예시

다음은 완전히 유효한 예시입니다:

json


{
  "blacklist_product_fields": [
    "profit_margin",
    "inventory_level"
  ],
  "blacklist_display_filters": [
    "product_type",
    "category_name",
    "warehouse_region",
    "care_instructions"
  ],
  "blacklist_namespaces": [
    "SupplierInfo"
  ],
  "split_tag_to_metafield_by": ":",
  "hide_discount": true,
  "hide_price": false,
  "hide_review": false
}

필요하지 않은 항목은 삭제하거나, 원하는 메타필드 키와 네임스페이스를 추가할 수 있습니다. hide_* 옵션은 원하는 설정에 따라 true 또는 false로 지정하세요.