이 페이지에서는 사용 사례, 해당 성능 등급 및 데이터 품질을 평가하고 어떤 성능 등급을 잠금 해제했는지 확인할 수 있도록 Search for Retail 콘솔을 확인하는 방법을 설명합니다. 각 성능 등급은 업그레이드 차단 데이터 요구사항이 모두 충족되면 자동으로 활성화됩니다. 또한 다음 등급으로 업그레이드하려면 모든 이전 등급의 요구사항이 충족되어야 합니다.
사용 사례 검색
검색은 두 가지 사용 사례의 검색 결과를 제공합니다.
- 텍스트 쿼리 검색: 쇼핑객이 텍스트 쿼리를 입력하고 일련의 관련 결과를 가져와 애플리케이션에서 항목을 찾을 때 사용됩니다.
- 검색 탐색: 쇼핑객이 홈 개선 매장의 소매 사이트에서 '어플라이언스' 카테고리 웹페이지와 같은 특정 매장 페이지에 방문하고 해당 카테고리에서 정렬된 항목을 탐색하는 경우에 사용됩니다.
이러한 사용 사례의 차이점에 대한 자세한 내용은 텍스트 검색 및 검색 탐색 정보를 참조하세요.
성능 등급
텍스트 쿼리 검색과 검색 탐색에는 검색 결과를 개선하는 다양한 성능 등급이 있습니다. 성능 등급을 잠금 해제하려면 소매업용 Vertex AI Search에 업로드하는 사용자 이벤트와 카탈로그 데이터를 사용합니다.
다음 성능 등급은 사용 사례, 텍스트 쿼리 검색, 탐색 모두에 사용 가능합니다.
텍스트 쿼리 검색
등급 1
관련성:
- 결과는 검은색 드레스를 쿼리한 경우 드레스의 검은색 정도와 같이 쿼리 관련성 정도에 따라 반환됩니다.
최소 데이터 요구사항:
- 카탈로그
- 쿼리
등급 2
관련성 및 인기도:
- 쿼리된 검색어에서 가장 인기 있는 항목의 등급 1을 미세 조정합니다.
- 마찬가지로 관련 제품의 순위는 사이트에서의 제품 인기도에 따라 결정됩니다.
최소 데이터 요구사항: 데이터 클릭
등급 3
수익 최적화 순위: 관련 결과 순위는 특정 사이트 전체 활동에 따른 제품 구매 가능성을 기준으로 결정됩니다.
최소 데이터 요구사항: 대량의 사용자 이벤트
등급 4
맞춤형 수익 최적화 순위:
- 관련 결과 순위는 개별 사용자의 선호도와 사용자의 사이트 전체 활동에 따른 제품 구매 가능성을 기준으로 결정됩니다.
- 제품 순위는 사이트를 검색하거나 탐색하는 순 사용자와의 '일치도'를 기준으로 결정됩니다.
최소 데이터 요구사항:
- 대량의 사용자 이벤트
visitorID
또는userId
와 일치하며 사용자 이벤트 전반에서 일관된 형식을 갖습니다.
찾아보기
브론즈
무작위 결과
- 필터에 맞는 검색 결과가 무작위 순서로 표시됩니다.
실버
인기도
- 결과는 카테고리와의 관련성에 따라 반환됩니다.
골드
수익 최적화 순위
- 관련 결과 순위는 사이트 전체 활동에 따른 제품 구매 가능성을 기준으로 결정됩니다.
플래티넘
맞춤형 수익 최적화 순위
- 관련 결과 순위는 개별 사용자의 선호도와 사이트 전체 활동에 따른 제품 구매 가능성을 기준으로 결정됩니다.
Search for Retail 콘솔에는 각 등급의 데이터 요구사항을 충족하는지 확인할 수 있는 데이터 품질 페이지가 있습니다.
다음 섹션에서는 현재 매개변수에 따라 데이터가 속한 등급을 알려주는 데이터 품질 알림에 가입하는 방법을 보여줍니다. 또한 이러한 알림은 검색 결과를 가장 효과적으로 최적화하는 데 필요한 특정 사용 사례 데이터 요구사항에 대한 가이드 역할을 합니다.
데이터 품질 확인
데이터를 업로드한 후 Search for Retail 콘솔로 이동하여 사용 사례의 각 성능 등급에 대한 데이터 검사 측정항목을 확인합니다.
Search for Retail 콘솔의 데이터 품질 페이지로 이동합니다.
데이터 품질 페이지로 이동검색 사용 사례의 데이터 검사 측정항목을 봅니다.
- 텍스트 검색 측정항목의 경우 검색 탭을 클릭합니다.
- 검색 측정항목을 찾아보려면 찾아보기 탭을 클릭합니다.
페이지 상단에서 각 성능 등급 문제 점수 카드를 확인합니다.
- '사용 중'으로 라벨이 지정된 경우: 해당 등급의 모든 차단 문제를 해결하여 잠금 해제했습니다.
- 차단 문제가 없는 경우: 해당 계층의 데이터 검사를 통과했습니다. 이 등급 및 모든 이전 등급에 차단 문제가 없는 경우 모델을 학습 및 준비하고 새로 잠금 해제된 등급을 활성화하는 데 약 24시간이 걸립니다.
- 차단 문제가 있는 경우: 해당 계층의 측정항목을 확인하여 해당 계층을 잠금 해제하려면 해결해야 하는 데이터 문제를 확인합니다.
각 성능 등급의 데이터 검사 측정항목 테이블을 확인하여 등급 업그레이드를 차단하거나 검색 성능에 영향을 줄 수 있는 문제 목록을 확인합니다.
상태 열에서 각 데이터 검사 측정항목의 우선순위 수준을 확인합니다.
- 업그레이드 차단: 검색에서 사용 사례를 다음 성능 등급으로 업그레이드하지 못하게 하는 데이터 문제를 식별합니다. 등급을 잠금 해제하려면 해당 성능 등급 및 이전 등급에 대한 모든 업그레이드 차단 데이터 검사를 통과해야 합니다.
- 성능 기준: 업그레이드를 차단하지는 않지만 텍스트 검색이나 검색 탐색 성능에 상당한 영향을 미칠 수 있는 데이터 문제를 식별합니다.
- 준수: 데이터 검사를 통과했음을 나타냅니다.
- 사용 불가: 비업그레이드 차단 데이터 검사가 아직 완료되지 않았음을 나타냅니다. 이러한 측정항목의 값은 해당 사항 없음으로 표시됩니다. 데이터를 가져온 후 일부 데이터 검사를 계산하는 데 최대 24시간이 걸릴 수 있습니다.
측정항목에 대한 자세한 내용을 보려면 세부정보를 클릭하여 측정항목 설명, 데이터 검사 타임스탬프, 기준값을 표시하는 세부정보 패널을 확인합니다.
측정항목 세부정보 패널에서 기준을 확인하여 해당 측정항목의 데이터 검사를 통과하고 결과를 개선하는 데 필요한 값을 확인합니다. 모든 기준이 모든 측정항목에 적용되는 것은 아닙니다.
- 차단 기준: 이 측정항목 데이터 검사를 통과하는 데 필요한 기준입니다.
- 중요 기준: 반드시 충족해야 하는 기준입니다. 이 기준을 충족하지 못하면 성능에 상당한 부정적인 영향이 미칠 수 있습니다.
- 경고 기준: 충족해야 하는 권장 기준입니다. 이 기준을 충족하지 못하면 성능에 약간의 영향이 미칠 수 있습니다.
데이터 문제를 해결하기 위해 더 많은 데이터를 가져오려면 공개 문서의 이전 사용자 이벤트 가져오기 또는 카탈로그 정보 가져오기를 참조하세요.
권장사항
- 검색 요청 및 사용자 이벤트에서 로그인한 사용자에 대해 방문자 ID 외에도 사용자 ID를 제공합니다. 이렇게 하면 검색에서 사용자가 여러 기기에 로그인하여 발생한 이벤트를 기반으로 사용자 결과를 맞춤설정할 수 있습니다.
- 지연이 발생하는 일괄 업로드 대신 실시간으로 사용자 이벤트를 전송합니다. 이렇게 하면 검색이 사이트에서의 사용자 최근 활동을 사용하여 맞춤설정할 수 있습니다.
- 모든 사용자 이벤트를 업로드합니다. 예를 들어 검색으로 인해 발생한 이벤트만 제출하지 않습니다.
맞춤설정 사용 중지
맞춤설정을 사용 중지하려면 ServingConfig.personalizationSpec
을 mode.DISABLED
로 설정합니다.
데이터 품질 알림
대시보드의 측정항목 값이 만족에서 불만족으로 변경되면 데이터 품질 알림이 트리거됩니다. 알림은 이메일로 전송됩니다.
Cloud Monitoring 관련 알림을 보려면 알림 설정으로 이동합니다.
데이터 품질 보기
Search for Retail 콘솔의 데이터 품질 페이지로 이동합니다.
데이터 품질 페이지로 이동
행 하나는 측정항목 하나에, 측정항목 하나는 알림 하나에 해당합니다.
데이터 품질 알림 설정
REST
UpdateAlertConfig API를 호출합니다.
curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \ "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \ --data ' { "alertPolicies": [ { "alertGroup": "search-data-quality", "enrollStatus": "ENROLLED", "recipients": [ { "emailAddress": "EMAIL_ADDRESS_1" }, { "emailAddress": "EMAIL_ADDRESS_2" } ] } ] }'
다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDEMAIL_ADDRESS_1
,EMAIL_ADDRESS_2
: 알림을 등록하려는 이메일 주소입니다. SMTP(간이 전자 우편 전송 프로토콜)를 준수해야 합니다. 알림 정책 하나에 이메일 주소를 최대 20개까지 추가할 수 있습니다.
콘솔
Search for Retail 콘솔의 데이터 품질 페이지로 이동합니다.
데이터 품질 페이지로 이동상단에서 settings 알림 구성을 클릭합니다.
이메일 주소를 하나 이상 추가합니다. 이메일 주소는 SMTP(간이 전자 우편 전송 프로토콜)를 준수해야 합니다. 알림 정책 하나에 이메일 주소를 최대 20개까지 추가할 수 있습니다.
제출을 클릭합니다.
데이터 품질 알림 사용 중지
REST
UpdateAlertConfig API를 호출합니다.
curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \ "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \ --data ' { "alertPolicies": [ { "alertGroup": "search-data-quality", "enrollStatus": "DECLINED", "recipients": [ ] } ] }'
다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 ID
콘솔
Search for Retail 콘솔의 데이터 품질 페이지로 이동합니다.
데이터 품질 페이지로 이동상단에서 settings 알림 구성을 클릭합니다.
기존 이메일을 모두 삭제합니다.
제출을 클릭합니다.
문제 해결
다음은 몇 가지 일반적인 문제와 이를 해결하는 방법입니다.
데이터 검사가 통과되지 않음
데이터 검사가 통과되지 않으면 데이터 품질 페이지에서 해당 측정항목의 세부정보를 클릭하여 해당 측정항목에 대한 자세한 설명과 데이터 검사를 통과하는 데 필요한 기준을 확인합니다.
데이터 요구사항을 이미 충족했으면 타임스탬프 섹션에서 해당 측정항목이 마지막으로 계산된 시점을 확인합니다. 최근에 상당한 양의 데이터 형식을 다시 지정하거나 데이터를 수집한 경우 측정항목을 다시 계산하는 데 몇 시간이 걸릴 수 있습니다.
데이터 요구사항을 충족하지 않았다면 데이터 검사 요구사항을 충족하기 위해 데이터 형식을 다시 지정하거나 더 많은 데이터를 수집해야 할 수 있습니다. 데이터가 측정항목 기준을 충족하는지 확인한 후 형식이 다시 지정된 데이터를 다시 가져오거나 추가 데이터를 가져온 후 측정항목이 다시 계산될 때까지 기다립니다.
측정항목 값이 해당 사항 없음으로 표시
업로드된 데이터가 없거나 측정항목이 아직 계산되지 않은 경우 측정항목 값이 '해당 사항 없음'으로 표시됩니다. 데이터를 가져온 후 일부 데이터 검사를 계산하는 데 최대 24시간이 걸릴 수 있습니다.
성능 등급에 차단 문제가 없지만 사용되지 않음
문제를 해결하려면 다음 단계를 수행합니다.
이전 등급에 차단 데이터 문제가 있는지 확인합니다. 다음 등급으로 업그레이드하려면 모든 이전 등급의 요구사항이 충족되어야 합니다.
24시간 동안 기다립니다. 모든 업그레이드 차단 데이터 검사가 통과한 후 모델을 학습 및 준비하고 새로 잠금 해제된 등급을 활성화하는 데 약 24시간이 걸립니다.
모든 업그레이드 차단 데이터 검사를 통과한 후 2일 내에 성능 등급이 사용 중으로 표시되지 않으면 소매용 Vertex AI Search 지원팀에 프로젝트 번호와 프로젝트 ID를 알려 도움을 요청하세요.
추가 데이터 요구사항 정보
소매업용 Vertex AI Search 데이터 요구사항에 대한 자세한 내용은 다음 문서를 참조하세요.
- 사용자 이벤트 데이터 업로드 시 소매업용 Vertex AI Search의 일반 요구사항: 사용자 이벤트 요구사항
- 검색 결과를 가져오기 위한 최소 사용자 이벤트 요구사항: 검색 요구사항
- 카탈로그 데이터 요구사항: 카탈로그 데이터 품질 측정항목