이 페이지에서는 검색 사용 사례, 해당 성능 등급 및 데이터 품질을 평가하고 어떤 성능 등급을 잠금 해제했는지 확인할 수 있도록 Search for commerce 콘솔을 확인하는 방법을 설명합니다. 각 성능 등급은 업그레이드 차단 데이터 요구사항이 모두 충족되면 자동으로 활성화됩니다. 또한 다음 등급으로 업그레이드하려면 모든 이전 등급의 요구사항이 충족되어야 합니다.
사용 사례 검색
검색은 두 가지 사용 사례의 검색 결과를 제공합니다.
- 텍스트 쿼리 검색: 쇼핑객이 텍스트 쿼리를 입력하고 일련의 관련 결과를 가져와 애플리케이션에서 항목을 찾을 때 사용됩니다.
- 검색 탐색: 쇼핑객이 홈 개선 매장의 소매 사이트에서 '어플라이언스' 카테고리 웹페이지와 같은 특정 매장 페이지에 방문하고 해당 카테고리에서 정렬된 항목을 탐색하는 경우에 사용됩니다.
이러한 사용 사례의 차이점에 대한 자세한 내용은 텍스트 검색 및 검색 탐색 정보를 참조하세요.
검색 성능 등급 잠금 해제
텍스트 쿼리 검색과 검색 탐색에는 검색 결과를 개선하는 다양한 성능 등급이 있습니다. 성능 등급을 잠금 해제하려면 커머스용 Vertex AI Search에 업로드하는 사용자 이벤트와 카탈로그 데이터를 사용해야 합니다.
다음 성능 등급은 사용 사례, 텍스트 쿼리 검색, 탐색 모두에 사용 가능합니다.
텍스트 쿼리 검색
등급 1
관련성
결과는 검은색 드레스를 쿼리한 경우 드레스의 검은색 정도와 같이 쿼리 관련성 정도에 따라 반환됩니다.
최소 데이터 요구사항
- 카탈로그
- 텍스트 쿼리
데이터 확인
- 제품에 설명이 있어야 합니다.
- 검색 요청의 95% 이상에서 쿼리 확장이 사용 설정되어 있어야 합니다.
detail-page-view이벤트와 검색 이벤트의 비율이 4% 이상이어야 합니다.- 제품에는 검색어에서 구분할 수 있는 고유한 제목이 있어야 합니다.
- 제품 제목은 2개 이상의 단어로 구성되어야 합니다.
- 제품의 95% 이상에 제목이 있어야 합니다.
- 제품에 액세스할 수 있는 유효한 URI가 있어야 합니다.
- 카탈로그에 검색 가능한 맞춤 속성이 5개 이상 있어야 합니다.
- 모든 제품의 정확히 일치 필드에는 실제 단어가 포함되어서는 안 되며 정확히 하나의 토큰이어야 합니다.
등급 2
관련성 및 인기도
- 쿼리된 검색어에서 가장 인기 있는 항목의 등급 1을 미세 조정합니다.
- 마찬가지로 관련 제품의 순위는 사이트에서의 제품 인기도에 따라 결정됩니다.
데이터 확인
Tier 2를 잠금 해제하기 위해 차단 업그레이드:
- 지난 90일 동안 텍스트 검색 및 탐색 이벤트가 100,000개 이상 가져오거나 기록되어야 합니다.
성능에 중요:
- 지난 90일 동안의 이벤트 중 95% 이상이 제품과 조인되어야 합니다.
- 지난 7일 동안 후속 페이지가 있는 검색 이벤트가 1.5% 이상입니다. 즉, 연결된 모든 검색 결과 페이지와 제품 노출이 포함됩니다.
- 지난 7일 동안의 검색 이벤트 중 95% 이상이 제품 노출과 연결되어야 합니다.
- 지난 90일 동안
detail-page-view,add-to-cart,purchase이벤트가 각각 10, 000개 이상 발생해야 합니다. - 지난 90일 동안의 검색 요청 중 70% 이상에 연결된 이벤트가 있어야 합니다.
- 지난 90일 동안의 검색 이벤트 중 95% 이상에 기여 분석 토큰이 있습니다.
- 지난 7일 동안 가장 인기 있는 방문자 ID와 연결된 이벤트가 100,000개 이상
등급 3
매출 최적화
수익 최적화를 사용 설정하려면 사용자 상호작용이 하나 이상 있는 250,000개 이상의 검색 이벤트를 모델링하세요.
데이터 확인
Tier 3를 잠금 해제하기 위해 차단 업그레이드:
수익 최적화가 제대로 작동하려면 제품의 95% 에 가격이 있어야 합니다. 이를 위해서는 기본 제품 또는 기본 제품의 옵션 중 하나 이상의 가격이 책정되어 있어야 합니다. 제품의 재고가 소진되면 가격을 삭제하는 대신 제품에
out-of-stock속성을 부여합니다.지난 90일 동안 사용자 상호작용 (동일한 방문자 ID와 검색 이벤트에 포함된 제품 중 하나가 있는
detail-page-view,add-to-cart또는purchase이벤트가 뒤따름)과 연결된 검색 이벤트가 250,000개 이상이어야 합니다.기준을 충족하려면 검색 사용자 이벤트 중 최소 250,000개에 검색 이벤트 직후에 발생한
detail-page-view이벤트가 있어야 합니다. 지난 30일 동안 1억 개 이상의 이벤트를 업로드한 경우 이 측정항목은 지난 30일 동안 계산됩니다. 그 외의 경우 기간은 90일입니다.검색 이벤트에 기여한
detail-page-view이벤트가 하나 이상 있는 제품이 100개 이상이어야 합니다. 지난 30일 동안 1억 개 이상의 이벤트를 업로드한 경우 이 측정항목은 지난 30일 동안 계산됩니다. 그 외의 경우 기간은 90일입니다.
성능에 중요:
검색 이벤트는 쿼리 (텍스트) 또는 카테고리 페이지 (탐색)와 연결되어야 합니다. 둘 다 비어 있는 검색 이벤트는 없어야 합니다. 두 필드가 모두 채워진 검색 이벤트가 많을수록 좋습니다.
검색 요청에 빈 쿼리가 있으면 안 됩니다. 검색 이벤트와 마찬가지로 검색 요청에는 쿼리 (텍스트)와 페이지 카테고리 (탐색)가 모두 채워져 있어야 합니다. 이 측정항목은 지난 60일 동안의 모든 검색 요청의 비율로 계산됩니다.
이 기준점을 충족하려면 1,000개의
detail-page-view이벤트마다 지난 90일 동안의add-to-cart이벤트가 20개 이상이어야 합니다.add-to-cart이벤트 1,000개당 지난 90일 동안 발생한purchase이벤트가 25개 이상이어야 합니다.
등급 4
맞춤형 수익
Tier 4는 맞춤설정 기능을 추가하여 Tier 3를 기반으로 합니다.
데이터 확인
차단을 업그레이드하여 Tier 4 잠금 해제:
지난 30일 동안 Vertex AI Search for Commerce (기존 엔진 아님)에서 제공한
search이벤트가 100,000개 이상이어야 합니다.맞춤 검색 결과를 캐시하지 마세요. 방문자 ID가 서로 다른 여러 검색 사용자 이벤트에 동일한 기여 분석 토큰이 있는 경우 캐싱이 감지됩니다. 이 측정항목은 Vertex AI 토큰이 있는 가장 최근의 검색 이벤트 100,000개를 기준으로 계산됩니다.
일관된
visitorId(로그인한 사용자의 경우userId)는 이벤트와 검색 요청 전반에서 추적해야 합니다. 최근 사용자 이벤트 100,000개에 대해SearchRequests와 사용자 이벤트 간의 방문자 ID 일치율이 10% 이상이어야 합니다.
성능에 중요:
맞춤설정 품질을 개선하려면 검색 API 요청과 검색 이벤트 간에 방문자 ID가 10% 이상 일치해야 합니다.
검색 이벤트의 1% 이상에 사용자 ID가 설정되어 있어야 합니다.
검색 요청의 1% 이상에 사용자 ID가 설정되어 있어야 합니다.
찾아보기
브론즈
무작위 결과를 위한 기준 탐색
- 필터에 맞는 검색 결과가 무작위 순서로 표시됩니다.
최소 데이터 요구사항
- 카탈로그
- 카테고리 페이지 (탐색) 쿼리
실버
인기도
- 결과는 카테고리와의 관련성에 따라 반환됩니다.
데이터 확인
업그레이드 차단을 해제하여 실버 등급 획득:
- 지난 90일 동안 텍스트 검색 또는 탐색 이벤트를 100,000개 이상 가져오거나 기록해야 합니다.
성능에 중요:
제품에 액세스할 수 있는 유효한 URI가 있어야 합니다. (권장: > 95.0%)
제품의 95% 이상에 제목이 있어야 합니다. (권장: > 95.0%)
제품 제목은 2개 이상의 단어를 포함해야 합니다. (권장: 80.0% 초과)
제품에 설명이 있어야 합니다. (권장: 90.0% 초과)
제품에는 검색어에서 구분할 수 있는 고유한 제목이 있어야 합니다. (권장: 50.0% 미만)
탐색 요청의 90% 이상에 필터와 page_category가 설정되어 있어야 합니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: 90.0% 초과)
지난 90일 동안의
detail-page-view,add-to-cart,purchase이벤트를 더 많이 가져오거나 기록합니다. (권장: > 10,000)결과가 거의 없는 탐색 요청은 필터가 지나치게 제한적이기 때문일 수 있습니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: 10.0% 미만)
제품이 너무 많은 요청은 요청 필터에 카테고리 제한이 누락되었음을 나타낼 수 있습니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: 10.0% 미만)
지난 90일 동안의
details-page-view이벤트를 더 많이 가져오거나 기록합니다. (권장: > 0.04)
골드
수익 최적화 순위
이 등급은 탐색된 카테고리 내에서 수익 기반 목표에 맞게 제품 순위를 최적화합니다.
데이터 확인
업그레이드 차단 해제하여 골드 이용하기:
검색된 제품의 95% 이상에 유효한 가격 정보가 있어야 합니다. 기본 제품 또는 가격이 책정된 변형 중 하나 이상이 필요합니다. 제품의 재고가 소진된 경우 가격을 지우지 마세요.
지난 90일 동안 동일한 방문자 ID를 사용하고 검색 이벤트에 포함된 제품 중 하나를 사용한
detail-page-view,add-to-cart또는purchase이벤트가 뒤따르는 탐색 검색 사용자 이벤트가 250,000개 이상입니다.지난 90일 동안 기준점을 충족하기 위해 탐색 이벤트 직후에 발생한 가져오거나 기록된
detail-page-view이벤트가 250,000개 이상이어야 합니다.지난 90일 동안 다양한 제품에 대해 가져오거나 기록된
detail-page-view이벤트가 100개 이상
성능에 중요:
탐색 요청 및 이벤트의 95% 이상에 정확히 일치하는 필터 값이 있어야 합니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: > 95.0%)
탐색 요청 및 이벤트의 95% 이상에서 page_category 값이 정확히 일치해야 합니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: > 95.0%)
탐색 이벤트의 95% 이상에 기여 분석 토큰이 있어야 합니다. 이 측정항목은 지난 90일 동안의 데이터를 기반으로 계산됩니다. (권장: > 95.0%)
탐색 요청의 70% 이상에 연결된 사용자 이벤트가 있어야 합니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: 70.0% 초과)
검색 이벤트에서 검색어와 페이지 카테고리가 모두 비어 있으면 안 됩니다. (권장: 5.0% 미만)
검색 이벤트에 쿼리와 페이지 카테고리가 모두 채워져서는 안 됩니다. (권장: 10.0% 미만)
탐색 요청에는 페이지 카테고리가 채워져 있어야 합니다. 페이지 카테고리가 없는 탐색 요청은 사용자가 어떤 페이지에 있는지 알 수 없으므로 수익에 최적화되지 않습니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: 5.0% 미만)
검색 요청에는 쿼리 또는 페이지 카테고리가 채워져 있어야 하지만 둘 다 채워져서는 안 됩니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: 10.0% 미만)
add-to-cart이벤트 1,000개당 지난 90일 동안 발생한purchase이벤트가 25개 이상이어야 합니다. (권장: > 0.02)detail-page-view이벤트 1,000개당 지난 90일 동안 발생한add-to-cart이벤트가 20개 이상이어야 합니다. (권장: > 0.025)
플래티넘
맞춤형 수익 최적화 순위
이 등급은 탐색된 카테고리 내에서 맞춤형 제품 순위를 제공하여 개별 사용자 행동 및 선호도를 기반으로 수익을 최적화하는 것을 목표로 합니다.
데이터 확인
플래티넘 등급을 이용하려면 업그레이드 차단:
지난 90일 동안 Vertex AI Search for Commerce 탐색 사용자 이벤트가 100,000개 이상에 Vertex AI 기여 분석 토큰이 있어야 합니다. 모든 탐색 노출이 이벤트로 기록되고 기여 분석 토큰이 포함되어 있는지 확인합니다.
Vertex AI에서 제공하는 탐색 결과의 99.0% 이상이 캐시되지 않아야 합니다. 맞춤 검색 결과는 캐시하면 안 됩니다. 방문자 ID가 서로 다른 여러 탐색 사용자 이벤트의 기여 분석 토큰이 동일한 경우 캐싱이 감지됩니다. 이는 Vertex AI 토큰이 있는 가장 최근의 탐색 이벤트 100,000개를 기준으로 계산됩니다.
방문자 ID가 탐색 API 요청과 해당 탐색 사용자 이벤트 간에 10.0% 이상 일치해야 합니다. 이는 Vertex AI에서 제공한 가장 최근의 탐색 이벤트 100,000개를 기준으로 계산됩니다.
성능에 중요:
사용자 ID를 사용하여 더 많은 사용자 이벤트를 가져오거나 기록하여 개인 최적화 품질을 개선하세요. 이 측정항목은 지난 7일 동안 계산됩니다. (권장: > 1.0%)
맞춤설정 품질을 개선하려면 검색 요청의 사용자 ID 값이 해당 검색 이벤트의 사용자 ID와 일치해야 합니다. 이 측정항목은 지난 60일 동안 계산됩니다. (권장: 10.0% 초과)
커머스를 위한 Search 콘솔에는 각 등급의 데이터 요구사항을 충족하는지 확인할 수 있는 페이지가 있습니다.
다음 섹션에서는 현재 매개변수에 따라 데이터가 속한 등급을 알려주는 데이터 품질 알림에 가입하는 방법을 보여줍니다. 또한 이러한 알림은 검색 결과를 가장 효과적으로 최적화하는 데 필요한 특정 사용 사례 데이터 요구사항에 대한 가이드 역할을 합니다.
데이터 품질 확인
데이터를 업로드한 후 Search for commerce 콘솔로 이동하여 사용 사례의 각 성능 등급에 대한 데이터 검사 측정항목을 확인합니다.
커머스를 위한 Search 콘솔의 데이터 품질 페이지로 이동합니다.
데이터 품질 페이지로 이동검색 사용 사례의 데이터 검사 측정항목을 봅니다.
- 텍스트 검색 측정항목의 경우 검색 탭을 클릭합니다.
- 검색 측정항목을 찾아보려면 찾아보기 탭을 클릭합니다.
페이지 상단에서 각 성능 등급 문제 점수 카드를 확인합니다.
- '사용 중'으로 라벨이 지정된 경우: 해당 등급의 모든 차단 문제를 해결하여 잠금 해제했습니다.
- 차단 문제가 없는 경우: 해당 계층의 데이터 검사를 통과했습니다. 이 등급 및 모든 이전 등급에 차단 문제가 없는 경우 모델을 학습 및 준비하고 새로 잠금 해제된 등급을 활성화하는 데 약 24시간이 걸립니다.
- 차단 문제가 있는 경우: 해당 등급의 측정항목을 확인하여 해당 등급을 잠금 해제하려면 해결해야 하는 데이터 문제를 확인합니다.
각 성능 등급의 데이터 검사 측정항목 테이블을 확인하여 등급 업그레이드를 차단하거나 검색 성능에 영향을 줄 수 있는 문제 목록을 확인합니다.
상태 열에서 각 데이터 검사 측정항목의 우선순위 수준을 확인합니다.
- 업그레이드 차단: 검색에서 사용 사례를 다음 성능 등급으로 업그레이드하지 못하게 하는 데이터 문제를 식별합니다. 등급을 잠금 해제하려면 해당 성능 등급 및 이전 등급에 대한 모든 업그레이드 차단 데이터 검사를 통과해야 합니다.
- 성능 기준: 업그레이드를 차단하지는 않지만 텍스트 검색이나 검색 탐색 성능에 상당한 영향을 미칠 수 있는 데이터 문제를 식별합니다.
- 준수: 데이터 검사를 통과했음을 나타냅니다.
- 사용 불가: 비업그레이드 차단 데이터 검사가 아직 완료되지 않았음을 나타냅니다. 이러한 측정항목의 값은 해당 사항 없음으로 표시됩니다. 데이터를 가져온 후 일부 데이터 검사를 계산하는 데 최대 24시간이 걸릴 수 있습니다.
측정항목에 대한 자세한 내용을 보려면 세부정보를 클릭하여 측정항목 설명, 데이터 검사 타임스탬프, 기준값을 표시하는 세부정보 패널을 확인합니다.
측정항목 세부정보 패널에서 기준을 확인하여 해당 측정항목의 데이터 검사를 통과하고 결과를 개선하는 데 필요한 값을 확인합니다. 모든 기준이 모든 측정항목에 적용되는 것은 아닙니다.
- 차단 기준: 이 측정항목 데이터 검사를 통과하는 데 필요한 기준입니다.
- 중요 기준: 반드시 충족해야 하는 기준입니다. 이 기준을 충족하지 못하면 성능에 상당한 부정적인 영향이 미칠 수 있습니다.
- 경고 기준: 충족해야 하는 권장 기준입니다. 이 기준을 충족하지 못하면 성능에 약간의 영향이 미칠 수 있습니다.
데이터 문제를 해결하기 위해 더 많은 데이터를 가져오려면 공개 문서의 이전 사용자 이벤트 가져오기 또는 카탈로그 정보 가져오기를 참조하세요.
권장사항
- 검색 요청 및 사용자 이벤트에서 로그인한 사용자에 대해 방문자 ID 외에도 사용자 ID를 제공합니다. 이렇게 하면 검색에서 사용자가 여러 기기에 로그인하여 발생한 이벤트를 기반으로 사용자 결과를 맞춤설정할 수 있습니다.
- 지연이 발생하는 일괄 업로드 대신 실시간으로 사용자 이벤트를 전송합니다. 이렇게 하면 검색이 사이트에서의 사용자 최근 활동을 사용하여 맞춤설정할 수 있습니다.
- 모든 사용자 이벤트를 업로드합니다. 예를 들어 검색으로 인해 발생한 이벤트만 제출하지 않습니다.
상위 수익 최적화 등급의 기능 선택
커머스용 Vertex AI Search가 업그레이드되어 데이터가 수익 최적화 검색 기능을 사용할 수 있는 상위 성능 등급에 도달한 소매업체를 지원합니다. 이제 상위 등급의 다음 소매업체에서 기능 선택을 사용할 수 있습니다.
- 탐색: 실버 및 골드
- 검색: 3등급 및 4등급
순위 업그레이드가 필요한 이유
커머스용 대규모 Vertex AI Search 고객의 제품 카탈로그에는 최대 10,000개의 맞춤 속성이 있는 반면, 이전에는 순위 모델에 모든 고객에게 공유되는 정적 제품 기능 (예: 가격, 평균 평점)이 20개밖에 없었습니다. 그 결과 순위 모델의 제품 데이터가 매우 불완전해졌으며 패션, 하드웨어, 가정용품과 같은 다양한 소매 도메인과 사용 사례에 맞게 제품 기능을 맞춤설정할 수 없었습니다.
커스텀 속성을 모델링할 수 없으므로 일부 사용자는 중요하다고 생각하는 속성을 정적(고정) 제품 기능에 포함했습니다. 하지만 이 방법은 수작업이 필요했고 소수의 속성에만 적용할 수 있었습니다.
동적 커스텀 기능 선택
커머스용 Vertex AI Search는 수익 최적화 등급을 업그레이드하여 맞춤 속성을 자동으로 선택합니다. 이번 업그레이드에서는 관련 커스텀 속성을 순위 지정 프로세스에 통합합니다.
- 각 소매업체의 모든 커스텀 속성을 검토하고 정적 제품 기능 집합에 추가할 가장 유용한 속성을 선택합니다.
- 각 소매업체에 대해 선택된 속성을 표시합니다.
- 정기적으로 (30일마다 한 번) 기능 선택 프로세스를 반복합니다.
요약하자면 상거래를 위한 Vertex AI Search를 사용하면 순위 모델이 모델에 사용할 수 있는 잠재적 새로운 기능에 최대 100회 이상 액세스할 수 있을 뿐만 아니라 각 고객의 속성도 정기적으로 업데이트되어 시즌별 판매 및 기타 동적 데이터 변경사항에 적응할 수 있습니다.
업그레이드된 순위 솔루션은 데이터 품질을 개선하기 위해 정기적으로 업데이트되는 커스텀 속성을 활용하여 더 강력한 검색 통계를 제공합니다.
제품에 대한 완전한 지식
- 특성 선택: 커머스용 Vertex AI Search 알고리즘은 각 소매업체에 대해 가장 중요한 커스텀 속성을 최대 20개 선택합니다.
- 이점: 할인 코드, 제품, 스타일 사양과 같은 제품에 관한 추가 정보를 활용하여 순위 정확성을 개선할 수 있습니다.
- 표시 여부: 소매업체는 선택한 커스텀 속성을 확인하고 유지보수 및 업데이트 상태를 확인할 수 있습니다.
- 맞춤설정 및 학습: 고객은 선택한 커스텀 속성에서 패턴을 파악하고 다른 관련 속성을 추가하여 순위 실적을 더욱 높일 수 있습니다.
사용 중인 속성을 확인하는 방법
고객이 충분한 사용자 이벤트 데이터 포인트로 상위 등급을 사용 설정한 경우 이제 새로운 맞춤 속성 정보가 콘솔에서 상거래를 위한 Search의 데이터 품질 페이지에 있는 텍스트 검색 또는 탐색 검색 탭 아래에 나열됩니다. 여기에서 커머스용 Vertex AI Search 시스템에서 선택한 맞춤 속성을 확인할 수 있습니다.

커스텀 속성으로 할 수 있는 작업
- 모델에 영향을 미칠 수 있으므로 선택한 속성을 유지하고 삭제하거나 지원 중단하지 마세요.
- 자동 선택된 속성의 범위를 개선하여 더 많은 제품에 이러한 필드를 작성합니다.
- 커스텀 속성이 자동으로 선택되는 동향을 검토합니다. 다른 유사한 속성이 있으면 카탈로그에 추가합니다. 이러한 속성은 특성 검색 알고리즘에서 선택하는 후보가 됩니다.
- 문자열 값 대신 숫자 값을 할당하여 숫자 속성을 올바르게 주석 처리합니다. 예를 들어 텍스트 ('10.5') 대신 숫자 값
10.5을 제공합니다.
맞춤설정 사용 중지
맞춤설정을 사용 중지하려면 ServingConfig.personalizationSpec을 mode.DISABLED로 설정합니다.
데이터 품질 알림
대시보드의 측정항목 값이 만족에서 불만족으로 변경되면 데이터 품질 알림이 트리거됩니다. 알림은 이메일로 전송됩니다.
Cloud Monitoring 관련 알림을 보려면 알림 설정으로 이동합니다.
데이터 품질 보기
커머스를 위한 Search 콘솔의 데이터 품질 페이지로 이동합니다.
데이터 품질 페이지로 이동행, 측정항목, 알림 검토: 행 하나는 측정항목 하나에, 측정항목 하나는 알림 하나에 해당합니다.
데이터 품질 알림 설정
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 프로젝트의 ID입니다.EMAIL_ADDRESS_1,EMAIL_ADDRESS_2: 알림을 등록하려는 이메일 주소입니다. SMTP를 준수해야 합니다. 알림 정책 하나에 이메일 주소를 최대 20개까지 추가할 수 있습니다.
콘솔
커머스를 위한 Search 콘솔의 데이터 품질 페이지로 이동합니다.
데이터 품질 페이지로 이동상단에서 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 콘솔의 데이터 품질 페이지로 이동합니다.
데이터 품질 페이지로 이동settings 알림 구성을 클릭합니다.
기존 이메일을 모두 삭제합니다.
제출을 클릭합니다.
문제 해결
다음은 일반적인 문제를 해결하는 방법입니다.
데이터 검사가 통과되지 않음
데이터 검사가 통과되지 않으면 데이터 품질 페이지에서 해당 측정항목의 세부정보를 클릭하여 해당 측정항목에 대한 자세한 설명과 데이터 검사를 통과하는 데 필요한 기준을 확인합니다.
데이터 요구사항을 이미 충족했으면 타임스탬프 섹션에서 해당 측정항목이 마지막으로 계산된 시점을 확인합니다. 최근에 상당한 양의 데이터 형식을 다시 지정하거나 데이터를 수집한 경우 측정항목을 다시 계산하는 데 몇 시간이 걸릴 수 있습니다.
데이터 요구사항을 충족하지 않았다면 데이터 검사 요구사항을 충족하기 위해 데이터 형식을 다시 지정하거나 더 많은 데이터를 수집해야 할 수 있습니다. 데이터가 측정항목 기준을 충족하는지 확인한 후 형식이 지정된 데이터를 다시 가져오거나 추가 데이터를 가져온 후 측정항목이 다시 계산될 때까지 기다립니다.
측정항목 값이 해당 사항 없음으로 표시
업로드된 데이터가 없거나 측정항목이 아직 계산되지 않은 경우 측정항목 값이 '해당 사항 없음'으로 표시됩니다. 데이터를 가져온 후 일부 데이터 검사를 계산하는 데 최대 24시간이 걸릴 수 있습니다.
성능 등급에 차단 문제가 없지만 사용되지 않음
문제를 해결하려면 다음 단계를 수행합니다.
이전 등급에 차단 데이터 문제가 있는지 확인합니다. 다음 등급으로 업그레이드하려면 모든 이전 등급의 요구사항이 충족되어야 합니다.
24시간 동안 기다립니다. 모든 업그레이드 차단 데이터 검사가 통과한 후 모델을 학습 및 준비하고 새로 잠금 해제된 등급을 활성화하는 데 약 24시간이 걸립니다.
모든 업그레이드 차단 데이터 검사를 통과한 후 2일 내에 성능 등급이 사용 중으로 표시되지 않으면 상거래를 위한 Vertex AI Search 지원팀에 프로젝트 번호와 프로젝트 ID를 알려 도움을 요청하세요.
추가 데이터 요구사항 정보
상거래용 Vertex AI Search 데이터 요구사항에 대한 자세한 내용은 다음 문서를 참고하세요.
- 사용자 이벤트 데이터 업로드 시 커머스용 Vertex AI Search의 일반 요구사항: 사용자 이벤트 요구사항
- 검색 결과를 가져오기 위한 최소 사용자 이벤트 요구사항: 검색 요구사항
- 카탈로그 데이터 요구사항: 카탈로그 데이터 품질 측정항목