Shoply가 사용할 수 있는 제품 메타필드를 제어하는 방법

AI 쇼핑 도우미는 제품 정보를 읽고, 질문에 답하고, 추천을 제공하여 고객을 돕도록 설계되어 있습니다.

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

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

이 가이드에서는 이것이 왜 유용한지와 설정 방법을 설명합니다.

Advanced Settings는 어디에서 찾을 수 있나요?

앱의 관리자 콘솔에서 “Settings” 섹션으로 이동한 다음, 아래로 스크롤하여 “Advanced Settings” 섹션을 찾으세요. 이 섹션에서는 다양한 설정을 구성하기 위해 JSON 객체 를 제공할 수 있습니다.

더 넓은 범위의 데이터 정책은 Shoply가 사용할 수 있는 정보를 확인하세요.

Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide. Click the screenshot to view it at full size.

블랙리스트 설정

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

개별 필드가 아니라 전체 항목을 숨기려면 전체 제품을 인덱싱에서 제외하세요.

`blacklist_product_fields`

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

메타필드 키 예시:

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

참고: 제품의 vendor를 표시하지 않으려면 블랙리스트에 “brand”를 추가해야 합니다. 이는 Shoply가 레거시 이유로 vendor 정보를 저장할 때 brand 메타필드를 사용하기 때문입니다.

`blacklist_display_filters`

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

어떤 속성이 표시되는지에 대한 배경 설명은 Shoply가 제품 필터를 생성하는 방법을 참고하세요.

이 기능은 메타필드에 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 Search에서 패싯 필터로 사용할 수 있습니다.

구분자를 포함하지 않는 태그는 이 설정에서 무시되며 일반 태그로 유지됩니다.

설정 예시:

json


{
  "split_tag_to_metafield_by": ":"
}

이 기능을 사용하면 좋은 경우:

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

제품 표시 제어

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

유지하는 필드의 시각적 표시를 변경하려면 CSS로 product-card 스타일을 사용자 지정할 수 있습니다.

`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로 설정하세요.