항목

이 페이지에서는 항목과 그 사용 방법 및 이유를 소개합니다.

대부분의 사용 사례에서 Vertex AI Search for Retail에는 항목이 필요하지 않습니다. 하지만 단일 제품 카탈로그에서 여러 브랜드 또는 지역에 서비스를 제공하는 소매업체는 항목을 사용하면 더 나은 결과를 얻을 수 있습니다.

개요

프로젝트에 여러 항목을 설정하면 다른 지역 또는 국가에 거주하거나 기업에 속한 다른 브랜드 사이트에서 쇼핑하는 쇼핑객의 다양한 행동과 선호도를 고려할 수 있습니다.

사용 사례 예시: 두 국가

소매업체인 예시 조직은 미국과 캐나다 모두에서 웹사이트를 운영하고 있습니다.

예시 조직은 두 국가의 쇼핑객 간 차이를 고려하여 탐색 및 검색결과를 제공하고 자동 완성 추천 용어를 제공하려고 합니다. 따라서 예시 조직은 org_usorg_ca의 두 가지 항목을 지정합니다.

쇼핑객이 방문한 웹사이트(.com 또는 ca)에 따라 사용자 이벤트에 항목 값이 태그됩니다. 쇼핑객이 검색 요청을 하면 항목 값이 요청에 포함됩니다.

두 국가에는 7월에 서로 다른 중요한 공휴일이 있습니다. 항목이 설정된 상태에서 쇼핑객이 예시 조직 사이트에서 July를 검색하면 미국 쇼핑객은 독립기념일 테마 상품을 먼저 제공받고 캐나다 쇼핑객은 캐나다의 날 테마 상품을 받게 됩니다.

마찬가지로 캐나다 쇼핑객을 위한 추천은 독립기념일보다 캐나다의 날 상품을 표시할 가능성이 더 높습니다.

사용 사례 예시: 인수

대기업 예시 조직은 최근에 스타트업 예시 조직을 인수했습니다. 카탈로그는 결합되어 있지만 스타트업의 브랜드와 웹사이트는 충성도가 높기 때문에 계속 사용됩니다.

대기업은 스타트업 사이트에서 발생한 사용자 이벤트에 태그를 지정하기 위해 startup 항목을 만듭니다. 이렇게 하면 스타트업 사이트에 제공되는 검색, 탐색, 자동 완성, 추천 제안이 스타트업 사이트의 쇼핑객의 선호도를 고려하게 됩니다.

여러 프로젝트 또는 여러 항목

Vertex AI Search for Retail을 설정할 때는 여러 다른 프로젝트 또는 동일한 프로젝트의 여러 다른 항목을 사용하여 여러 쇼핑객 모집단에 대해 서로 다른 제안을 얻을 수 있습니다.

일부 애플리케이션의 경우 개별 프로젝트가 필요합니다. 다른 애플리케이션의 경우 항목 설정이 더 나은 솔루션입니다.

다음과 같은 경우에 항목을 사용합니다.

  • 항목 간에 완전히 또는 부분적으로 공유되는 카탈로그

  • 다음 중 하나 이상에 해당하는 경우:

    • 동일한 국가 또는 언어 지역의 브랜드 여러 개(예: 기존 브랜드 및 인수된 브랜드(google_homenest))

    • 동일한 국가의 여러 리전(예: enterprise_eastenterprise_west)

    • 1개 브랜드에서 동일한 언어를 사용하는 여러 국가(예: brand_usbrand_ca)

다음과 같은 경우 항목 대신 별도의 프로젝트를 사용합니다.

  • 결합할 수 없는 카탈로그 또는 결합된 경우 거의 겹치지 않는 카탈로그

  • 다른 언어가 필요한 항목. 프로젝트당 하나의 언어만 허용됩니다.

사용자 이벤트 및 항목

항목 기능을 활용하려면 사용자 이벤트에 항목 필드를 추가합니다.

  • 검색 및 자동 완성: search 유형의 사용자 이벤트에 entity 필드를 포함합니다.

    다른 사용자 이벤트 유형에 항목 필드를 포함하면 문제 해결에 도움이 될 수 있지만 검색 또는 자동 완성 응답의 품질에 영향을 주지 않습니다.

  • 권장사항: 최대한 많은 사용자 이벤트 유형에 항목 필드를 포함하세요.

일반적으로 항목 특성이 최적의 제안을 반환하기까지 30~90일의 사용자 이벤트 데이터가 필요합니다.

요청에서 항목이 누락된 경우 요청은 결과의 항목에 대해 가정하지 않습니다. 지정된 항목이 있거나 없는 사용자 이벤트를 기반으로 하는 평균 결과를 얻게 됩니다.

검색 및 항목

항목을 고려한 검색 또는 탐색 결과를 얻으려면 다음 안내를 따르세요.

  1. 검색 사용자 이벤트(eventType="search")에 entity 필드를 포함합니다. 예시는 검색 사용자 이벤트에 전체 객체 예시를 참조하세요.

  2. entity 필드를 검색 요청에 추가합니다. 검색 요청을 수행하는 방법에 대한 자세한 내용은 검색 결과 가져오기를 참조하세요.

자동 완성 및 항목

항목을 고려하여 자동 완성 결과를 가져오려면 다음 안내를 따르세요.

권장사항 및 항목

entity 필드를 사용자 이벤트에 추가한 후에는 추천 항목을 활용하기 위해 추가 조치를 취할 필요가 없습니다. 항목 값이 사용자 이벤트의 일부이므로 predict 메서드 호출에 포함되기 때문입니다.