기본 요건 설정

소매업용 Vertex AI Search를 설정하려면 다음을 수행해야 합니다.

1. 새 프로젝트 만들기 또는 기존 프로젝트 설정
2. 소매업용 Vertex AI Search 사용 설정
3. 제품 카탈로그 및 사용자 이벤트 가져오기

Google Cloud 프로젝트 만들기

1. Google Cloud 콘솔의 리소스 관리 페이지에서 Google Cloud 프로젝트를 만들거나 선택합니다.

   리소스 관리 페이지로 이동

2. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

Vertex AI Search for Retail 설정

소매업용 Vertex AI Search 및 추천을 사용하려면 다음 단계를 수행합니다. 또한 소매업용 Vertex AI Search를 사용 설정하고 추천을 사용하는 경우 비용이 쿼리 수를 기반으로 결정됩니다. 소매업용 Vertex AI Search 가격 책정에 대한 자세한 내용은 검색 요금을 참고하세요.

중요: 소매업용 Vertex AI Search를 사용하려는 모든 제품에 대해 산업용 Vertex AI Search 약관을 수락해야 합니다.

새 프로젝트의 경우

소매업용 Vertex AI Search 설정

1. Google Cloud 콘솔에서 Vertex AI Search for Retail 페이지로 이동합니다.

   Search for Retail 페이지로 이동

2. Vertex AI Search for Retail 설정 페이지에서 API 사용 설정을 클릭합니다.

3. Vertex AI Search for Retail 및 Recommendations AI가 사용으로 표시되면 계속을 클릭합니다.

4. 데이터 사용에 대한 산업용 Vertex AI Search 데이터 사용 약관을 읽고 데이터 사용 약관에 동의하면 수락을 클릭합니다. 검색에 대한 약관이 수락되면 Google Cloud 콘솔에서 확인을 받게 됩니다.

5. Recommendations에만 프로젝트를 사용하려면 시작하기를 클릭합니다.

6. 추천 외에도 검색을 사용 설정하려면 다음을 수행합니다.

   1. 계속을 클릭한 후 Search 사용 설정(선택사항) 페이지에서 사용 설정을 클릭합니다.
   2. 시작하기를 클릭합니다.

   Google Cloud 콘솔에 사용 설정된 소매업용 Vertex AI Search 구성요소가 표시됩니다. 이제 프로젝트의 초기 설정을 구성할 수 있습니다.

기존 프로젝트의 경우

기존 프로젝트에서 계속 진행하려면 다음 단계를 완료하세요.

1. 프로젝트의 Google Cloud 콘솔에서 Search for Retail 페이지로 이동합니다.

   Search for Retail 페이지로 이동

2. 데이터 사용 약관 페이지에서 Discovery Solutions 데이터 사용 약관을 읽고 약관에 동의하면 수락을 클릭합니다.

3. 추천으로만 프로젝트를 사용하려면 시작하기를 클릭합니다.

4. 추천 외에도 검색을 사용 설정하려면 다음을 수행합니다.

   1. 계속을 클릭한 후 Search 사용 설정(선택사항) 페이지에서 사용 설정을 클릭합니다.
   2. 시작하기를 클릭합니다.

중요: 데이터 사용 약관에 동의하기 전에 프로젝트에 대한 Retail 관리자 또는 소유자 역할이 있는지 확인하세요.

검색 기능 사용 중지

Search를 더 이상 사용하지 않으려면 지원 티켓을 제출하여 사용 중지할 수 있습니다.

티켓을 올바른 구성요소로 설정하려면 다음 필드를 선택합니다.

• 카테고리: 머신러닝
• 구성요소: 소매업을 위한 Vertex AI Search: 검색 및 탐색
• 하위 구성요소: 계정 관리 및 결제

지원 티켓 만들기에 대한 자세한 내용은 지원 받기를 참조하세요.

Vertex AI Search for Retail 사용 중지

언제든지 Vertex AI Search for Retail을 사용 중지하여 해제할 수 있습니다. 이렇게 하면 Recommendations와 Search가 모두 사용 중지됩니다.

Vertex AI Search for Retail을 사용 중지하려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔에서 Vertex AI Search for Retail API/서비스 세부정보 페이지로 이동합니다.

   Vertex AI Search for Retail API 서비스 세부정보 페이지로 이동

2. API 사용 중지를 클릭합니다.

3. Vertex AI Search for Retail API를 사용 중지할까요? 상자에서 사용 중지를 클릭합니다.

참고: Vertex AI Search for Retail API를 사용 중지하면 Vertex AI Search for Industry 데이터 사용 약관이 해당 프로젝트에 대해 사용 중지되는 데 몇 시간 정도 걸립니다.

Vertex AI Search for Retail 시작하기

새 프로젝트에 대해 Vertex AI Search for Retail을 설정할 때는 Google Cloud 콘솔에 Vertex AI Search for Retail 프로젝트 구성을 돕는 다음 3개의 패널이 표시됩니다.

• 데이터 > 카탈로그: 제품 카탈로그와 카탈로그를 가져오는 링크가 표시됩니다.

• 데이터 > 이벤트: 사용자 이벤트와 이전 사용자 이벤트를 가져오는 링크가 표시됩니다.

• 서빙 구성: 서빙 구성 세부정보와 새 서빙 구성을 만들 수 있는 링크를 포함합니다.

이러한 패널을 사용해서 데이터를 가져오고 Vertex AI Search for Retail 프로젝트의 초기 구성을 만들 수 있습니다.

제품 카탈로그 가져오기

제품 카탈로그를 가져오려면 데이터 소스에 일련의 단계를 완료하세요. 제품 카탈로그에 대한 자세한 내용은 카탈로그 정보 가져오기를 참조하세요.

판매자 센터 동기화

1. 제품 카탈로그 가져오기를 클릭하여 데이터 가져오기 패널을 엽니다.
2. 제품 카탈로그를 선택합니다.
3. 데이터 소스로 판매자 센터 동기화를 선택합니다.
4. 판매자 센터 계정을 선택합니다. 계정이 표시되지 않으면 사용자 액세스를 확인합니다.
5. 선택사항: 선택한 피드의 제품만 가져오려면 판매자 센터 피드 필터를 선택합니다.
   
   지정하지 않으면 향후 피드를 포함하여 모든 피드의 제품을 가져옵니다.
6. 선택사항: 특정 국가 또는 언어를 타겟팅하는 제품만 가져오려면 고급 옵션 표시를 펼치고 필터링할 판매자 센터 판매 국가 및 언어를 선택합니다.
7. 카탈로그를 업로드할 브랜치를 선택합니다.
8. 가져오기를 클릭합니다.

Cloud Storage

1. 제품 카탈로그 가져오기를 클릭하여 데이터 가져오기 패널을 엽니다.
2. 데이터 소스로 제품 카탈로그를 선택합니다.
3. 카탈로그를 업로드할 브랜치를 선택합니다.
4. Retail 제품 카탈로그 스키마를 스키마로 선택합니다.
5. 데이터의 Cloud Storage 위치를 입력합니다.
6. Search를 사용 설정하지 않은 경우 제품 수준을 선택합니다.
   
   카탈로그를 처음으로 가져오거나 카탈로그를 삭제한 후 다시 가져오는 경우 제품 수준을 선택해야 합니다. 제품 수준 자세히 알아보기 데이터를 가져온 후에 제품 수준을 변경하려면 상당한 노력이 필요합니다.
   
   중요: 변형으로 수집된 제품 카탈로그가 있는 프로젝트에는 Search를 사용 설정할 수 없습니다.
7. 가져오기를 클릭합니다.

BigQuery

1. 제품 카탈로그 가져오기를 클릭하여 데이터 가져오기 패널을 엽니다.
2. 제품 카탈로그를 선택합니다.
3. 데이터 소스로 BigQuery를 선택합니다.
4. 카탈로그를 업로드할 브랜치를 선택합니다.
5. 다음 스키마 중 하나를 선택합니다.
   • Retail 제품 카탈로그 스키마: Vertex AI Search for Retail의 제품 스키마
   • 판매자 센터: 판매자 센터에서 일괄 가져오기에 사용되는 스키마
6. 데이터가 있는 BigQuery 테이블을 입력합니다.
7. 선택사항: 고급 옵션 표시에서 프로젝트의 Cloud Storage 버킷 위치를 데이터의 임시 위치로 입력합니다.
   
   지정하지 않으면 기본 위치가 사용됩니다. 지정하면 BigQuery 및 Cloud Storage 버킷은 같은 리전에 있어야 합니다.
8. Search를 사용 설정하지 않고 판매자 센터 스키마를 사용하는 경우 제품 수준을 선택합니다.
   
   처음 카탈로그를 가져오거나 카탈로그를 삭제한 후 다시 가져오는 경우 제품 수준을 선택해야 합니다. 제품 수준 자세히 알아보기 데이터를 가져온 후에 제품 수준을 변경하려면 상당한 노력이 필요합니다.
   
   중요: 변형으로 수집된 제품 카탈로그가 있는 프로젝트에는 Search를 사용 설정할 수 없습니다.
9. 가져오기를 클릭합니다.

이전 사용자 이벤트 가져오기

이전 사용자 이벤트를 가져오려면 데이터 소스에 일련의 단계를 완료하세요. 이전 사용자 이벤트에 대한 자세한 내용은 이전 사용자 이벤트 가져오기를 참조하세요.

참고: 실시간 사용자 이벤트를 기록하여 추천 및 검색 결과를 생성할 수도 있습니다. 자세한 내용은 실시간 사용자 이벤트 기록을 참조하세요.

Cloud Storage

1. 사용자 이벤트 가져오기를 클릭하여 데이터 가져오기 패널을 엽니다.
2. 사용자 이벤트를 선택합니다.
3. 데이터 소스로 Google Cloud Storage를 선택합니다.
4. 스키마로 Retail 사용자 이벤트 스키마를 선택합니다.
5. 데이터의 Cloud Storage 위치를 입력합니다.
6. 가져오기를 클릭합니다.

BigQuery

1. 사용자 이벤트 가져오기를 클릭하여 데이터 가져오기 패널을 엽니다.
2. 사용자 이벤트를 선택합니다.
3. 데이터 소스로 BigQuery를 선택합니다.

4. 데이터 스키마를 선택합니다.

   • Google 애널리틱스 4: Google 애널리틱스 4 이벤트에 사용합니다.
   • Google 애널리틱스 360: Google 애널리틱스 360에서 홈페이지 조회에서만 이벤트를 가져온 경우를 제외하고는 Google Analytics 360 이벤트에 사용합니다(이 경우 Retail 이벤트 스키마 사용).
   • Retail 사용자 이벤트 스키마: Google 애널리틱스가 아닌 소스에서 이벤트를 가져오고 Google 애널리틱스 360에서 홈페이지 조회에서만 이벤트를 가져오는 데 사용합니다.
5. 데이터가 있는 BigQuery 테이블을 입력합니다.
6. 선택사항: 프로젝트의 Cloud Storage 버킷 위치를 데이터의 임시 위치로 입력합니다.
   지정하지 않으면 기본 위치가 사용됩니다. 지정하면 BigQuery 및 Cloud Storage 버킷은 같은 리전에 있어야 합니다.
7. 선택사항: 고급 옵션 표시에서 프로젝트의 Cloud Storage 버킷 위치를 데이터의 임시 위치로 입력합니다.
   
   지정하지 않으면 기본 위치가 사용됩니다. 지정하면 BigQuery 및 Cloud Storage 버킷은 같은 리전에 있어야 합니다.
8. 가져오기를 클릭합니다.

서빙 구성 만들기

서빙 구성이란 검색 또는 추천 결과를 생성하는 데 사용되는 모델 또는 컨트롤 모음을 연결하는 제공 항목입니다.

참고: Vertex AI Search for Retail은 기본 서빙 구성을 만들기 때문에 커스텀 서빙 구성을 만들고 싶은 경우에는 이 절차가 선택사항입니다.

서빙 구성을 만들려면 다음 단계를 완료하세요.

1. 서빙 구성 패널에서 서빙 구성 만들기를 클릭합니다.
2. 서빙 구성 만들기 페이지에서 서빙 구성이 사용될 제품으로 Search를 선택합니다.
3. 서빙 구성의 이름을 입력합니다.
   
   이름은 1,024자(영숫자 문자 기준) 이하여야 하고 영숫자, 밑줄, 하이픈, 공백만 포함할 수 있습니다.
4. 선택사항: 필요한 경우 ID를 업데이트합니다.
   
   ID는 개발자가 제공한 이름에서 생성되며 프로젝트 전체에서 고유해야 합니다. 50자(영문 기준) 이하여야 하며 공백을 포함할 수 없습니다.
5. 계속을 클릭합니다.
6. 이 서빙 구성에 동적 패싯 생성을 사용 설정할지 여부를 선택합니다.
7. 검색을 최적화할 서빙 컨트롤을 선택하거나 만듭니다.
   
   컨트롤에 대한 자세한 내용은 컨트롤 만들기 및 관리를 참조하세요.

리소스 관리 및 활동 모니터링

프로젝트의 초기 구성을 완료했으면 Google Cloud 콘솔 대시보드에 소매업용 Vertex AI Search 프로젝트의 시스템 상태가 표시됩니다. 콘솔 대시보드를 사용하여 리소스를 관리하고 활동을 모니터링할 수 있습니다.

Search for Retail 콘솔로 이동

API 키 만들기

자바스크립트 픽셀 또는 태그 관리자 태그를 사용하여 사용자의 브라우저에서 사용자 이벤트를 캡처하려면 API 키가 필요합니다. 사용자 이벤트를 캡처하는 방법에 자세한 내용은 실시간 사용자 이벤트 기록을 참조하세요.

userEvents.Collect 메서드 호출을 위한 API 키를 만들려면 다음 단계를 완료합니다.

1. Google Cloud 콘솔 사용자 인증 정보 페이지로 이동합니다.

2. Google Cloud 콘솔 페이지 상단의 프로젝트 드롭다운에서 프로젝트를 선택합니다(프로젝트가 이미 선택되어 있을 수 있음).

3. 사용자 인증 정보 만들기를 클릭한 후 API 키를 선택합니다. 웹사이트 애플리케이션 제한사항을 추가하지 않습니다. 일부 사용자 개인 정보 보호 설정은 리퍼러 URL을 전달하지 않는 것으로 알려져 있습니다.

   • 사용자 이벤트 로깅을 호출할 때 사용할 생성된 API 키를 기록합니다.

4. 보안 강화를 위해서는 https://retail.googleapis.com/*에서 Vertex AI Search for Retail 서비스에 대한 액세스를 제한하기 위해 API 키에 API 제한사항을 추가합니다.

참고: API 키는 userEvents.Collect 메서드 인증을 위해서만 사용됩니다. 다른 API 메서드에는 서비스 계정 또는 사용자 계정을 통한 OAuth 2.0이 필요합니다.

다음 단계

• API 키 제한
• Vertex AI Search for Retail 인증
• Identity and Access Management(IAM)
• Vertex AI Search for Retail 구현