항목

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

대부분의 사용 사례에서 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 메서드 호출에 포함되기 때문입니다.