이 문서는 Recommendations AI, Retail Search, 새로운 Retail 콘솔에 대한 문서입니다. 제한된 GA 단계에서 Retail Search를 사용하려면 Cloud 영업팀에 문의하세요.

Recommendations AI만 사용하는 경우 Recommendations 콘솔에서 Recommendations AI 문서를 참조하세요.

자동 완성

이 페이지에서는 자동 완성 기능과 사용 방법을 소개합니다. Retail Search는 소매업체의 검색창 사전 입력 추천을 위한 자동 완성을 제공합니다.

자동 완성은 사용자가 입력하는 쿼리의 나머지 부분을 예측하여 사용자 검색 환경을 개선할 수 있는 기능입니다. 제공된 BigQuery 추천 데이터 세트 또는 제공한 사용자 이벤트를 통해 생성된 추천을 기반으로 사전 입력 추천을 제공할 수 있습니다.

개요

최종 사용자가 사이트에서 검색어를 입력하기 시작하면 Retail Search가 사용자가 원하는 추천 목록을 제공할 수 있습니다. 예를 들어 사용자가 sh를 입력하면 '신발', '셔츠'가 추천될 수 있습니다.

예측 데이터 소스는 다음 중 하나일 수 있습니다.

  • 업로드할 완성 데이터 세트로, 쿼리를 제안하는 데 사용됩니다. 완성 데이터 가져오기를 참조하세요.

  • 사용자의 검색 이벤트를 기반으로 Retail Search에서 생성하는 머신러닝 기반 자동 완성 데이터 세트입니다.

기기 유형

Retail Search 자동 완성은 MOBILEDESKTOP과 같은 여러 기기 유형을 지원합니다. 기기 유형에 따라 여러 추천을 업로드하거나 가져올 수 있습니다. device_typeCompleteQuery에 지정되지 않은 경우 추천은 모든 기기 유형에 적용됩니다.

검색 사용자 이벤트를 기반으로 생성된 완성 데이터 세트의 경우 다른 기기 유형을 지원하도록 UserEvent.user_info에서 user_agent를 설정합니다. 위키에서 사용자 에이전트를 참조하세요.

추천 데이터 세트

완성 데이터 세트를 업로드하거나 Retail Search가 사용자 이벤트를 기반으로 데이터 세트를 생성할 수 있습니다.

업로드된 완성 데이터 세트

자체 완성 데이터 세트를 업로드할 수 있습니다. 완성 데이터 가져오기의 자세한 안내를 참조하세요.

사용자 이벤트에서 생성된 완성 데이터 세트

Retail Search는 사용자 이벤트를 사용하여 자동 완성 데이터 세트를 생성할 수 있습니다. Retail Search에 업로드된 사용자 이벤트가 많을수록 Retail Search가 더 높은 자동 완성 품질을 제공할 수 있습니다.

Retail Search에 의해 생성된 데이터 세트를 사용 설정하려면 Cloud Retail 지원팀에 문의하세요.

데이터 세트 컨트롤

허용 목록

Retail Search는 자동 완성 추천에서 맞춤법 교정과 같은 후처리를 수행합니다. Retail Search가 후처리를 위해 건너뛰어야 하는 문구의 허용 목록을 만들 수 있습니다.

허용 목록에 포함된 문구는 추천에서 필터링되지 않습니다. 허용 목록은 업로드된 완성 데이터 세트생성된 완성 데이터 세트 모두에서 작동합니다.

예를 들어 'fruit' 또는 'foot' 대신 'froot loops'와 같이 의도적으로 철자가 틀린 브랜드 이름이 있습니다. 완성 데이터 가져오기의 자세한 업로드 안내를 참조하세요.

차단 목록

차단 목록의 구문은 추천에 표시되지 않습니다. 완성 데이터 가져오기의 자세한 업로드 안내를 참조하세요.

완성 가져오기

CompleteQuery API를 따라 추천을 가져옵니다. 예:

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog:completeQuery?query=sho&dataset=user-data&deviceType=DESKTOP&maxSuggestions=5"