소매업의 이름이 소매업용 Vertex AI Search로 변경됩니다. 새로운 브랜딩이 반영되도록 콘텐츠를 업데이트하는 중입니다.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

제품 속성 정보

커머스용 Vertex AI Search는 색인 생성, 동적 패싯 생성, 검색 가능성, 필터링, 모델 품질을 위해 제품 속성을 사용할 수 있습니다. 이 페이지에서는 제품 속성 구성을 설정하고, 사용 중인 메서드 및 구성에 따라 이러한 구성을 어떻게 처리하는지 설명합니다.

속성 유형

제품 속성은 유형에 따라 기본 설정 및 허용되는 옵션이 다를 수 있습니다.

시스템 속성: 사전 정의된 시스템 속성은 제품에 대한 자세한 정보를 제공하는 기존 Product 필드입니다. 여기에는 브랜드, 재고, 색상, 크기와 같은 제품 속성이 포함됩니다. 제품에 사용 가능한 모든 시스템 속성은 Product 참조 문서를 확인하세요.
커스텀 속성: 커스텀 속성은 Product.attributes 필드를 사용하여 정의하는 추가 속성입니다. 예를 들어 매장 이름, 공급업체 또는 스타일이 포함될 수 있습니다. 커스텀 속성의 예시 및 한도는 Product.attributes 참조 문서를 참조하세요.

참고: 선택된 상위 20개 맞춤 속성은 매월 변경되며, (현재) 선택된 속성은 상거래를 위한 Search 콘솔의 컨트롤 페이지에 있는 속성 컨트롤 탭에 표시됩니다.

상위 20개 맞춤 속성의 예는 다음과 같습니다.
- 이 제품이 속한 제품 라인
- 이 제품의 오프라인 판매량
- 의류의 용도
- 이 제품에 적용되는 특가 및 쿠폰
- 사이트 전체 제품 인기도
인벤토리 수준 속성: 제품에 대한 저장소 수준 정보를 제공하는 시스템 또는 커스텀 속성입니다. 식료품 또는 매장별 프로모션이 있는 제품과 같이 매장과 리전 간에 속성이 크게 다른 제품에 인벤토리 수준 속성을 사용할 수 있습니다.

inventories.price 및 inventories.originalPrice는 상거래를 위한 Vertex AI Search에서 사전 정의된 숫자 시스템 속성입니다. 텍스트 또는 숫자로 된 커스텀 인벤토리 수준 속성을 만들 수 있습니다. 인벤토리 수준 속성은 기본적으로 색인을 생성할 수 있습니다. 인벤토리 수준 속성에는 검색 가능한 동적 패싯 생성을 설정할 수 없습니다.

사용 가능한 구성 설정

속성 구성 설정은 사이트 전반의 검색 및 추천 동작에 영향을 미칩니다.

검색에는 다음 속성 설정이 사용됩니다.

색인 생성 가능: 검색은 이 속성을 사용하여 필터링하고 패싯을 생성할 수 있습니다.
동적 패싯 생성: 검색은 패싯 클릭수 및 조회수와 같은 이전 사용자 동작을 기반으로 이 속성을 동적 패싯으로 자동으로 사용할 수 있습니다. 속성에 동적 패싯 생성을 사용 설정하려면 해당 속성에 대해 색인 생성 가능을 true로 설정해야 합니다.
검색 가능: 이 속성은 검색어로 검색 가능하며 해당 속성에 대한 재현율을 높입니다. 이 컨트롤은 텍스트 속성에만 적용됩니다.
가져오기 가능: true로 설정하면 검색이 검색어에 대한 응답으로 이 속성을 반환합니다. 모든 속성에서 가져오기 가능을 false로 설정하면 검색결과에 제품 이름 또는 제품 이름 및 색상 정보(옵션의 경우)만 포함됩니다. 제품에 대해 REST 필드 RetrievableFields가 지원 중단되었습니다. 대신 검색 가능한 사이트 전체 컨트롤을 사용하세요.

추천은 다음 속성 설정을 사용합니다.

필터링 가능(공개 미리보기): 이 속성은 추천 필터 표현식에 사용할 수 있습니다. 이 컨트롤은 텍스트 속성에만 적용됩니다.

색인 생성 가능

속성을 색인 생성 가능으로 설정하면 검색은 이 속성을 사용하여 필터링하고 패싯을 생성할 수 있습니다.

시스템 속성: 색인 생성 가능성은 항상 사전 정의된 시스템 속성에 사용 설정됩니다. 시스템 속성에서는 이 설정을 사용 중지할 수 없습니다.
커스텀 속성: 기본적으로 사용 설정됩니다. 모든 커스텀 속성의 색인 생성 가능성은 사용 중지할 수 있습니다. 맞춤 속성을 색인 생성 가능하게 만들려면 정규식 패턴 [a-zA-Z0-9][a-zA-Z0-9_]*를 따라야 합니다. 예를 들면 key0LikeThis 또는 KEY_1_LIKE_THIS입니다.
인벤토리 수준 속성: 시스템 인벤토리 수준 속성에 항상 사용 설정됩니다. 이 설정은 변경할 수 없습니다. 커스텀 인벤토리 수준 속성에 대해 기본적으로 사용 설정됩니다. 이 설정은 사용 중지할 수 있습니다.
종속 항목: 해당 사항 없음

색인 구성 변경사항은 카탈로그 데이터를 가져온 직후에 적용됩니다. 그렇지 않으면 변경사항이 적용되는 데 최대 12시간이 걸릴 수 있습니다. 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

동적 패싯 생성

속성에 동적 패싯 생성을 사용 설정하면 검색이 속성을 동적 속성으로 사용할 수 있습니다. 동적 패싯은 속성 클릭 및 조회와 같은 과거 사용자 행동을 기준으로 검색에 자동으로 추가될 수 있습니다.

시스템 속성: 색인 생성 가능성이 true로 설정된 경우 기본적으로 사용 설정됩니다. 모든 시스템 속성에 대해 동적 패싯 생성을 사용 중지할 수 있습니다.
커스텀 속성: 색인 생성 가능성이 true로 설정된 경우 기본적으로 사용 설정됩니다. 모든 커스텀 속성에 동적 패싯 생성을 사용 중지할 수 있습니다.
인벤토리 수준 속성: 지원되지 않습니다.
종속 항목: 속성에 동적 패싯 생성을 사용 설정하려면 먼저 해당 속성에 색인 생성 가능성을 사용 설정해야 합니다.

속성의 동적 패싯 생성 설정은 항상 전역적입니다. 이 속성에 적용하는 동적 패싯 생성 구성은 해당 속성을 사용하는 카탈로그 전체의 제품에서 사용됩니다.

동적 패싯 생성 구성이 변경되는 데 최대 2일이 걸립니다. 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

숫자 커스텀 속성의 경우 요청에서 버킷을 지정해야 합니다. 숫자 값은 자동으로 버케팅되지 않습니다.

검색 가능

속성을 검색 가능으로 설정하면 검색어에서 해당 속성에 대한 재현율이 향상됩니다.

텍스트 속성 값만 검색 가능성을 사용 설정할 수 있습니다. 숫자 속성에는 적용되지 않습니다.

시스템 속성: Product의 사전 정의된 텍스트 시스템 속성에는 상거래를 위한 Vertex AI Search에서 검색 가능성 설정이 구성됩니다. 이 설정은 변경할 수 없습니다.
커스텀 속성: 기본적으로 사용 중지됩니다. 텍스트 커스텀 속성에 이 구성을 사용 설정할 수 있습니다.
인벤토리 수준 속성: 지원되지 않습니다.
종속 항목: 해당 사항 없음
정확한 검색 가능: 카탈로그에 있는 제품과 일치하는 검색어에 대해 타겟팅 검색이 반환됩니다. 이 옵션은 일련번호에 적합합니다. 정확하게 검색 가능한 옵션에 대해 자세히 알아보세요.

검색 가능한 속성이 있는 제품은 해당 속성의 검색결과에 표시될 가능성이 높지만 이를 보장할 수는 없습니다.

정확하게 검색 가능한 옵션

카탈로그 속성 필드인 exact-searchable 옵션에 특정 문자열 쿼리에 대한 특정 값을 부여할 수 있습니다. 쿼리가 카탈로그의 제품과 일치하고 해당 필드의 값이 쿼리에 제공된 문자열인 경우 검색어에 정확히 해당 제품이 반환됩니다. 이 옵션은 고객이 타겟팅된 검색 환경을 기대하는 일련번호에 적합합니다.

일반적으로 맞춤 속성의 경우 ExactSearchableOption 필드는 정확한 값이 있는 제품 속성 (예: ModelId 또는 ManufacturerId)에 유용합니다. product_id과 같은 속성은 기본적으로 정확한 검색이 가능한 기본 색인 필드입니다. item_id 필드는 항상 완전 일치에 사용 설정되어 있으며 사용 중지할 수 없습니다.

검색에서 관련 없는 항목이 반환되지 않도록 하려면 검색 가능 옵션을 battery와 같은 일반 값으로 설정하지 마세요.
검색어가 제대로 처리되지 않도록 하려면 문자열 값 중 하나로 'iphone'이 있을 수 있는 tag과 같은 특수 필드를 정확한 검색 가능으로 설정하지 마세요. 이렇게 하면 제품 카탈로그의 모든 iPhone에 대한 결과가 제한될 수 있습니다.

자세한 내용은 제품 속성 정보를 참조하세요.

속성 동작

기본 및 옵션이 있는 제품 지정을 사용하여 제품 카탈로그를 구성할 때는 필터링을 위해 제품 속성이 처리되는 방식을 알아야 합니다. 동작은 검색 또는 추천을 사용하는지 여부와 카탈로그 분류를 구성하는 방법에 따라 달라집니다.

예측 가능하고 정확한 필터링 동작을 보장하려면 기본 제품과 변형 제품에서 필터링 가능한 속성 정의의 일관성과 완전성을 유지하세요. 이 접근 방식은 정확한 필터링을 지원하여 제품 탐색 및 검색 관련성을 개선합니다.

검색과 추천의 기본 옵션 동작 비교

검색 및 추천 결과에는 기본 항목만 반환되지만, 상거래를 위한 Vertex AI Search는 검색 및 추천 품질을 최적화합니다.

검색 모델의 경우 옵션 속성은 검색 색인의 기본 제품에 사용됩니다. 검색 결과에는 옵션의 속성을 기반으로 기본 제품에 대한 다양한 옵션이 표시됩니다.
추천 모델의 경우 제품 세부정보와 속성이 기본에서 옵션으로 상속되지 않습니다. 추천 품질을 최적화하려면 기본 제품과 변형 제품에 product.categories, product.title, product.attributes, product.prices과 같은 주요 속성에 대한 세부정보가 완전하고 정확해야 합니다.

색인 생성 및 필터링 중 속성 처리

기본과 변형에 동일한 속성이 정의된 경우 변형의 속성이 필터링에 포함됩니다. 예를 들어 기본 제품과 변형 (색상 또는 크기)에 속성이 정의되어 있다고 가정해 보겠습니다. 옵션 속성 값은 주로 필터링에 사용되며, 필터링 중에 시스템은 기본 제품의 옵션 중 하나가 속성 값과 일치하는지 확인합니다. 제품 재고: 기본 제품은 out-of-stock로 표시될 수 있지만 하나 이상의 옵션이 in-stock인 경우 in-stock 필터가 적용되면 기본 제품이 검색 결과에 표시됩니다.

다음과 같은 이유로 기본과 변형에 동일한 필터링 가능 속성을 설정하세요.

필터링 시 변형 제품 속성이 우선합니다. 기본 제품과 변형에 속성이 정의된 경우 변형의 속성이 필터링에 사용됩니다. 예를 들어 기본 제품에 자리표시자 색상이 있지만 옵션에 실제 색상이 있는 경우 옵션의 색상이 채워지고 필터링에 사용됩니다.
재고 관련 속성(예: 재고)의 경우 기본 제품에 옵션이 있으면 기본 제품의 재고는 OUT_OF_STOCK로 설정해야 하며 실제 재고(예: IN_STOCK)는 옵션 수준에서 설정해야 합니다. 이렇게 하면 옵션 중 하나 이상이 재고가 있는 한 기본 제품이 재고가 있는 것으로 간주됩니다. 이 경우 availability: ANY("IN_STOCK")와 같은 필터는 기본 제품을 올바르게 반환합니다.
필터 표현식을 사용하면 예측 응답은 필터의 속성 값과 일치하는 하나 이상의 기본 또는 옵션이 있는 제품이 포함된 기본 제품을 반환합니다.

필터링을 위한 선택적 속성

categories 필드를 깨끗하게 유지하고 분류에 맞게 최적화합니다. 필터링이 더 필요한 경우 categories 필드가 아닌 별도의 맞춤 속성을 사용하여 광범위한 카테고리를 기반으로 구현하세요. 또한 카테고리 추천의 자동 완성 학습에 부정적인 영향을 미치지 않습니다.

예를 들어 일반적으로 필터링을 위해 [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3]와 같은 카테고리를 설정한다고 가정해 보겠습니다. 자동 완성은 지정된 쿼리에 대해 가장 자주 사용되는 카테고리를 집계하므로 lvl1 및 lvl2 (모든 제품)이 추천 카테고리로 표시됩니다.

권장사항

카탈로그가 기본 제품과 변이 제품으로 구성되어 있고 두 제품 모두에 동일한 속성이 정의되어 있는 경우 필터링 시 변이의 속성이 고려됩니다.

속성을 정확하게 입력: 효과를 극대화하려면 기본 제품과 변형 제품 모두 속성, 특히 필터링에 사용되는 속성의 세부정보가 완전하고 정확해야 합니다.
내장 필드 사용: 맞춤 속성에만 의존하지 마세요. 제품 정보를 기본 제공 Product 필드 (brands, colors, sizes, 필수 필드)에 매핑합니다. 기본 제공 필드는 검색 가능성, 색인 가능성, 관련성 최적화에 더 큰 영향을 미칩니다. 커스텀 속성 (Product.attributes)은 사전 정의된 시스템 속성에 맞지 않는 제품 데이터에 사용됩니다.
사이트 전체 검색 가능 필드 컨트롤 설정: API는 변형에 variantRollupKeys를 지원하므로 검색 응답에서 세부정보를 검색할 수 있습니다.

주의: 검색을 사용하는 경우 검색 응답에 제품과 함께 속성이 포함된 Product.retrievableFields가 지원 중단됩니다. 검색 가능한 사이트 전체 컨트롤을 사용하세요.
일관된 카탈로그 언어: 제품 카탈로그를 한 언어로만 작성해야 하고 검색 쿼리를 동일한 언어로 전송해야 합니다. 카탈로그에 여러 언어가 있으면 모델 성능이 저하될 수 있습니다. 언어 코드를 설정하지 않으면 맞춤법 수정과 같은 기능에 영향을 줄 수 있습니다.
가격 정보: 정확한 추천 및 필터링을 위해 기본 제품과 옵션 제품의 가격 정보를 정확하게 입력합니다. 제품에 제품 수준 가격이 없고 오프라인 판매점 인벤토리 가격만 있는 경우 인벤토리 수준 가격의 중간값으로 기본 제품의 가격을 채웁니다.

구성 모드

구성 모드에 따라 속성 구성을 처리하는 방법과 설정할 수 있는 속성 구성이 결정됩니다.

카탈로그 수준 구성 모드(기본값): 이 모드에서는 카탈로그 수준의 속성 구성이 정보 소스로 사용됩니다.
제품 수준 구성 모드(지원 중단됨): 이 모드에서는 제품 수준의 속성 구성이 정보 소스로 사용됩니다.

이전에는 제품 수준 구성이 기본 모드였습니다. 제품 수준 구성 모드를 사용 중이고 카탈로그 수준 구성 모드로 전환해야 하는 경우 지원팀에 문의하세요. 검색은 전환 후 제품 수준 구성 모드로 다시 변경하는 것을 지원하지 않습니다.

구성 모드를 확인하려면 Search for commerce 콘솔 컨트롤 페이지로 이동하세요. 색인 생성 가능 옵션을 사이트 전체 컨트롤 탭의 열로 사용할 수 있는 경우 구성 모델은 카탈로그 수준입니다. 색인 생성 가능 열을 사이트 전체 컨트롤 탭에서 사용할 수 없는 경우 구성 모델은 제품 수준입니다.

구성 방법

다음 방법으로 속성 구성을 설정할 수 있습니다.

Search for commerce 콘솔: Search for commerce 콘솔을 사용하여 카탈로그 수준에서 속성 구성을 설정합니다. 이렇게 하면 모든 제품의 속성이 전역으로 구성됩니다. 콘솔에서 사용할 수 있는 설정은 구성 모드에 따라 다릅니다. 콘솔에서 속성을 구성하는 방법에 대한 자세한 내용은 다음 섹션을 참고하세요.
AttributeConfig API 메서드: API를 사용하여 카탈로그 수준에서 속성 구성을 설정합니다. 이렇게 하면 모든 제품의 속성이 구성됩니다.
Product API 메서드(지원 중단됨): Product API 메서드를 사용하여 제품 수준에서 커스텀 속성을 설정합니다. 이 메서드로 속성을 설정하는 것은 신규 사용자에게 제공되지 않으며 권장되지 않습니다.

콘솔에서 속성 구성

Search for commerce 콘솔 컨트롤 페이지의 사이트 전체 컨트롤 탭에서 모든 제품의 속성 옵션을 전역으로 설정할 수 있습니다. 콘솔에서 이를 설정하는 방법에 대한 자세한 내용은 사이트 전체 속성 컨트롤 관리를 참조하세요.

이 기능을 사용하려면 구성 모드가 카탈로그 수준이어야 합니다.

색인 생성 및 검색이 가능한 속성 구성 설정에 대한 변경은 카탈로그 수집 즉시 적용됩니다. 그렇지 않으면 변경사항이 적용되는 데 최대 12시간 이상이 걸릴 수 있습니다. 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

`AttributesConfig`로 속성 구성

AttributesConfig API 리소스를 사용하면 카탈로그 수준에서 속성 구성을 관리할 수 있습니다.

다음 필드는 카탈로그 수준에서 속성 옵션을 설정합니다.

CatalogAttribute.indexableOption: 속성의 색인 생성 가능한 옵션을 설정합니다.
CatalogAttribute.dynamicFacetableOption: 속성의 동적 패싯 생성 옵션을 설정합니다.
CatalogAttribute.searchableOption: 속성의 검색 가능한 옵션을 설정합니다.
CatalogAttribute.recommendationsFilteringOption(공개 미리보기): 속성의 추천 필터링 옵션을 설정합니다.

모든 속성 구성을 검색하려면 GetAttributesConfig 메서드를 사용합니다.

여러 속성 업데이트

updateAttributesConfig 메서드를 사용하여 카탈로그 수준에서 여러 속성을 업데이트합니다.

요청에 포함하는 카탈로그 속성은 카탈로그에서 업데이트되거나 존재하지 않으면 삽입됩니다. 카탈로그 속성 필드에 값이 없으면 기본값이 할당됩니다.

요청에 허용되는 카탈로그 속성의 최대 개수는 1,000개입니다.

개별 속성 업데이트

다음 메서드는 개별 카탈로그 속성을 업데이트하는 데 사용됩니다.

AddCatalogAttribute: 카탈로그 속성에 개별 속성 구성을 추가합니다.

AddCatalogAttribute에 대한 API 참조 문서를 참조하세요.
ReplaceCatalogAttribute: 개별 속성 구성을 수정합니다. 이렇게 하면 카탈로그 속성을 동일한 CatalogAttribute.key로 업데이트하여 AttributesConfig에서 지정된 CatalogAttribute를 대체합니다.

ReplaceCatalogAttribute에 대한 API 참조 문서를 참조하세요.
RemoveCatalogAttribute: AttributesConfig에서 개별 속성 구성을 삭제합니다.

제품에서 사용하지 않는 CatalogAttributes만 삭제할 수 있습니다. CatalogAttribute가 사용 중인 경우 RemoveCatalogAttribute는 삭제하지 않고 구성 속성을 기본값으로 재설정합니다. 속성이 제품에서 사용되는 경우 CatalogAttribute.inUse가 True로 설정됩니다.

RemoveCatalogAttribute에 대한 API 참조 문서를 참조하세요.

`Product` 메서드로 속성 구성(지원 중단됨)

이 메서드로 속성을 설정하는 것은 신규 사용자에게 제공되지 않으며 권장되지 않습니다.

다음 필드는 Product API 메서드를 사용하여 특정 제품에 대해 색인 생성 및 검색 가능한 설정을 설정합니다.

Product.attributes.indexable.
Product.attributes.searchable 커스텀 속성에만 사용할 수 있습니다.