분석 보기

이 페이지에서는 추천 및 검색 앱의 분석을 보는 방법을 설명합니다.

분석을 사용하면 앱의 사용 동향, 검색 및 추천 품질, 최종 사용자 참여에 대한 유용한 정보를 얻을 수 있습니다. Vertex AI Search 콘솔은 Looker를 기반으로 하는 대화형 대시보드 환경을 제공합니다.

• 미디어 추천 앱: 공개 미리보기. 사용자 이벤트 기반의 추천당 측정항목을 확인할 수 있습니다. 기간 및 기기 유형별로 측정항목을 필터링할 수 있습니다.
• 맞춤 검색 및 미디어 검색 앱: 검색 로그 및 사용자 이벤트를 기반으로 검색당 측정항목과 검색 세션당 측정항목을 확인할 수 있습니다. 기간, 쿼리, 기기 유형별로 측정항목을 필터링할 수 있습니다.
• 의료 검색 앱: 공개 미리보기. 검색 로그를 기반으로 검색당 측정항목을 확인할 수 있습니다.

측정항목은 6시간마다 새로고침되므로 앱을 만든 후 애널리틱스 페이지를 사용하려면 몇 시간이 걸릴 수 있습니다.

분석용 데이터 소스

이 섹션에서는 앱 유형에 따른 분석 데이터 소스를 설명합니다.

사용자 이벤트 분석을 볼 수 있으려면 사용자 이벤트 통합을 완료해야 합니다.

업로드하는 사용자 이벤트는 생성되는 분석에 영향을 미칩니다.

미디어 추천 앱에서 일부 측정항목을 보려면 다음 사용자 이벤트가 필요합니다.

• 항목 조회 이벤트. 클릭률에 필요합니다.
• 미디어 완료 이벤트. 재생당 완료율 및 추천당 완료율에 필요합니다.
• 미디어 재생 이벤트. 추천 미디어 재생 횟수, 전체 재생률, 재생당 완료율, 재생당 평균 시청 시간에 필요합니다.

검색 앱에서 일부 측정항목을 보려면 다음 사용자 이벤트가 필요합니다.

• 검색 이벤트. 클릭률에 필요합니다.
• 항목 조회 이벤트. 클릭률에 필요합니다.

다음 정보는 일부 분석에도 사용됩니다.

• 노출수. 사용자 이벤트를 수집할 때 UserEvent.Documents에 연결된 항목을 포함하여 Vertex AI Search에 기인하는 노출수(항목 조회수 또는 클릭수)를 제공할 수 있습니다. 이 정보는 기여 분석과 검색별 측정항목을 계산하는 데 필요합니다.
• 기여 분석 토큰. 기여 분석 토큰은 Vertex AI Search에서 생성되고 각 검색 요청으로 반환되는 고유 ID입니다. 검색으로 인해 발생한 사용자 이벤트에 이 기여 분석 토큰을 UserEvent.attributionToken으로 포함해야 합니다. 이는 검색이 API에서 제공되는지 식별하는 데 필요합니다. Google에서 생성한 기여 분석 토큰이 있는 사용자 이벤트만 측정항목을 계산하는 데 사용됩니다.
• 사용자 에이전트. 기기 유형별로 사용자 이벤트 측정항목을 필터링할 수 있도록 사용자 이벤트에 UserInfo.userAgent를 포함합니다.

검색 로그

검색 앱은 일부 측정항목의 데이터 소스로 검색 로그를 사용합니다.

검색 로그는 검색 요청을 기반으로 합니다. Vertex AI Search가 사용자 세션을 식별하여 세션별 분석 및 더 높은 품질의 검색 결과를 제공할 수 있도록 하려면 선택적 필드인 userPseudoId를 설정하는 것이 좋습니다.

아직 검색 로그나 사용자 이벤트가 없으면 모든 측정항목에 기본값이 표시됩니다.

미디어 추천 분석 보기

참고: 미디어 추천 분석은 공개 미리보기 버전입니다.

다음 안내에 따라 미디어 추천 분석을 확인하세요.

1. Google Cloud 콘솔에서 AI 애플리케이션 페이지로 이동합니다.

   AI Applications

2. 분석을 확인하려는 앱의 이름을 클릭합니다.

3. 분석을 클릭합니다.

4. 측정항목을 필터링하려면 다음 필터 중 하나를 지정한 다음 새로고침 버튼을 클릭하여 적용합니다.

   • 기간. 사전 설정된 기간을 선택하거나 가능한 경우 커스텀 기간을 입력합니다.
   • 기기 유형. 쿼리가 발생한 기기 유형을 선택합니다.

검색 분석 보기

참고:

• 미국 및 EU 멀티 리전의 데이터 스토어에 검색 분석 보기가 공개 미리보기 버전으로 제공됩니다.
• 의료용 Vertex AI Search는 미국 멀티 리전 (`us`)에서만 검색 서비스를 제공하므로 의료 검색 분석은 공개 미리보기로 제공됩니다.
• 검색 분석은 전 세계 데이터 스토어에 정식 버전으로 제공됩니다.
• 기본적으로 위젯의 측정항목은 애널리틱스 페이지에 표시되지 않습니다. 위젯 측정항목을 보려면 Google 계정팀에 문의하여 허용 목록에 추가해 달라고 요청하세요.

다음 안내에 따라 검색 앱의 분석을 확인하세요.

1. Google Cloud 콘솔에서 AI 애플리케이션 페이지로 이동합니다.

   AI Applications

2. 분석을 확인하려는 앱의 이름을 클릭합니다.

3. 분석을 클릭합니다.

4. 탭을 클릭하여 해당 측정항목 그룹을 확인합니다.

   • 검색당. 측정항목은 검색별로 그룹화됩니다. 의료 검색의 경우 이 측정항목 그룹만 사용할 수 있습니다.
   • 세션당. 측정항목은 검색 세션별로 그룹화됩니다.
   • 비교. 기준 측정항목은 비교 기간의 측정항목과 함께 표시됩니다. 기준 측정항목 (이전 기간)과 비교 측정항목 (이후 기간)의 기간을 선택합니다. 이러한 기간은 겹칠 수 없습니다.

5. 측정항목을 필터링하려면 필터를 지정한 다음 새로고침 버튼을 클릭하여 적용합니다.

   미디어 앱과 맞춤 검색 앱의 경우 다음 필터를 사용할 수 있습니다.

   • 기간. 사전 설정된 기간을 선택하거나 가능한 경우 커스텀 기간을 입력합니다.
   • 검색어. 조건과 검색어 값을 선택합니다. 검색어 필터를 여러 개 추가할 수 있습니다. 검색당 및 비교 측정항목에 사용할 수 있습니다.
   • 기기 유형. 쿼리가 발생한 기기 유형을 선택합니다.

   의료 검색 앱의 경우 다음 필터를 사용할 수 있습니다.

   • 기간. 사전 설정된 기간을 선택하거나 가능한 경우 커스텀 기간을 입력합니다. 맞춤 기간의 특정 날짜를 선택하면 해당 날짜는 UTC -08:00 시간대에서 검색이 발생한 날짜입니다.
   • 검색어. 조건과 검색어 값을 선택합니다. 검색어 필터를 여러 개 추가할 수 있습니다.
   • 사용자 위치 검색 요청에 설정된 병원, 클리닉 또는 의료 서비스 제공업체의 위치를 선택합니다. 이 필터는 검색 요청에서 설정된 경우에만 사용할 수 있습니다.
   • 사용자 역할 검색 요청을 보낸 사용자의 직업 카테고리를 선택합니다. 이 필터는 검색 요청에서 설정된 경우에만 사용할 수 있습니다.
   • 사용자 설정 검색 요청에 설정된 의료 설정(예: 입원, 외래 환자, 하이브리드 치료)을 선택합니다. 이 필터는 검색 요청에서 설정된 경우에만 사용할 수 있습니다.

측정항목 정의

다음 표에서는 측정항목이 정의되는 방식을 설명합니다.

미디어 추천 측정항목

측정항목 이름	측정항목 정의	참고
추천 수	총 추천 수
추천 재생 횟수	추천 미디어 항목이 재생된 횟수
추천 클릭수	추천 미디어 항목이 클릭된 횟수
클릭률	추천 클릭수/추천 수	추천 클릭수는 추천으로 인해 발생할 수 있는 항목 조회 이벤트입니다.
추천 미디어 완료 수	추천 미디어 항목이 끝까지 재생된 횟수
추천당 시청 완료율	추천 미디어 항목이 재생된 횟수/추천 수
재생당 완료율	추천 미디어 항목이 끝까지 재생된 횟수/미디어 항목이 재생된 횟수
재생당 평균 시청 시간	추천 미디어 항목이 재생된 시간(초)/추천 미디어 항목이 재생된 횟수
추천당 완료율	미디어 항목이 끝까지 재생된 횟수 / 추천 수
추천당 평균 시청 시간	추천 미디어 항목이 시청된 시간(초)/추천 수

미디어 및 맞춤 검색 측정항목

측정항목 이름	측정항목 정의	참고
검색 횟수	검색 이벤트 수	검색 로그를 기반으로 합니다.
결과 없음 비율	결과가 없는 검색 이벤트 수/검색 수	검색 로그를 기반으로 합니다.
검색당 클릭률(CTR)	검색 클릭수/검색 수	검색 결과 클릭수는 이전 검색 이벤트로 인해 발생할 수 있는 항목 조회 이벤트입니다. 사용자 이벤트를 기반으로 합니다.
의견 좋아요 및 싫어요 수	좋아요 및 싫어요 수	앱 사용자가 보낸 좋아요/싫어요 의견 응답 기록입니다.
싫어요 의견 이유 분류	싫어요 이유의 비율	사용자가 생성된 대답에 싫어요를 표시하면 싫어요를 표시하는 이유를 여러 개 선택할 수 있습니다. 비율은 각 이유가 선택된 빈도를 보여줍니다.
검색 세션 수	검색 세션 수	검색 세션은 검색 이벤트가 하나 이상 포함된 사용자 세션입니다. 사용자 세션(방문이라고도 함)은 연속된 사용자 이벤트 집합입니다. 30분 동안 활동이 없으면 세션이 종료됩니다. 검색 로그를 기반으로 합니다.
검색 방문당 페이지 조회수	검색 세션의 항목 조회 이벤트 수/검색 세션 수	이 측정항목에는 Vertex AI Search로 인한 것인지에 관계없이 검색 방문의 모든 페이지 조회수가 포함됩니다. 사용자 이벤트를 기반으로 합니다.
이탈률	검색 세션의 이탈 횟수/검색 세션 수	검색 세션 이탈은 검색이 한 번 포함된 세션으로 정의되며, 여기서 사용자는 한 번만 검색한 후 사이트를 떠납니다. 사용자 이벤트를 기반으로 합니다.

의료 검색 측정항목

의료 검색 앱에 사용할 수 있는 검색 측정항목은 다음과 같습니다.

측정항목 이름	측정항목 정의	참고
검색 횟수	검색 이벤트 수
결과 없음 수	결과가 없는 검색 이벤트 수
검색당 결과 없음 비율	검색당 결과가 없는 검색 이벤트 수
환자 수	검색이 실행된 환자 ID 수	이는 검색 사용자별로 중복이 제거되지만 환자별로는 중복이 제거되지 않습니다. 예를 들어 사용자 1이 환자 A와 B를 검색하고 사용자 2가 환자 B만 검색하는 경우 개수는 3입니다.
고객 검색 세션 수	검색 사용자 정의 세션 수	검색에서 세션 ID를 전송할 수 있습니다. 자세한 내용은 session를 참조하세요.
방문자 수 검색	검색 요청을 보낸 사용자 수	사용자는 userInfo 필드를 기준으로 집계됩니다.
합성 검색 세션 수	Google 정의 검색 세션 수	검색 세션은 검색 이벤트가 하나 이상 포함된 사용자 세션입니다. 사용자 세션(방문이라고도 함)은 연속된 사용자 이벤트 집합입니다. 30분 동안 활동이 없으면 세션이 종료됩니다.

분석 사용 중지

기존 앱의 분석을 사용 중지할 수는 없지만 앱을 만들 때 분석을 사용 중지한 상태로 만들 수 있습니다.

분석 데이터를 수집하지 않는 검색 앱을 만들려면 다음 단계를 따르세요.

1. 검색 앱 만들기의 REST 안내에 따라 curl 명령어에 다음을 추가합니다.

      "disableAnalytics": true
   

   명령어 예

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "App without analytics",
     "dataStoreIds": ["my-data-store"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "searchEngineConfig": {
        "searchTier": "SEARCH_TIER_ENTERPRISE",
        "searchAddOns": ["SEARCH_ADD_ON_LLM"]
      },
     "disableAnalytics": true
   }'
   
       

   이 명령어는 검색 분석 데이터를 수집하지 않는 앱을 만듭니다.