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

제품 속성 정보

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

속성 유형

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

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

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에서 검색 가능성 설정이 구성됩니다. 이 설정은 변경할 수 없습니다.
커스텀 속성: 기본적으로 사용 중지됩니다. 텍스트 커스텀 속성에 이 구성을 사용 설정할 수 있습니다.
인벤토리 수준 속성: 지원되지 않습니다.
종속 항목: 해당 사항 없음

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

구성 모드

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

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

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

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

구성 방법

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

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

콘솔에서 속성 구성

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

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

색인 생성 및 검색이 가능한 속성 구성 설정에 대한 변경은 카탈로그 수집 즉시 적용됩니다. 그렇지 않으면 변경사항이 적용되는 데 최대 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 커스텀 속성에만 사용할 수 있습니다.