이 페이지는 Cloud Translation API를 통해 번역되었습니다.

분석 보기

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

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

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

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

분석용 데이터 소스

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

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

업로드하는 사용자 이벤트에 따라 생성되는 분석이 달라집니다.

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

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

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

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

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

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

검색 로그

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

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

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

미디어 추천 분석 보기

다음 안내에 따라 미디어 추천에 대한 분석을 확인합니다.

Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.
분석을 확인하려는 앱의 이름을 클릭합니다.
분석을 클릭합니다.
측정항목을 필터링하려면 다음 필터 중 하나를 지정한 다음 새로고침 버튼을 클릭하여 적용합니다.
- 기간. 사전 설정된 기간을 선택하거나 가능한 경우 커스텀 기간을 입력합니다.
- 기기 유형. 쿼리가 발생한 기기 유형을 선택합니다.

검색 분석 보기

다음 안내에 따라 일반 검색 또는 미디어 검색 앱의 분석을 확인하세요.

Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.
분석을 확인하려는 앱의 이름을 클릭합니다.
분석을 클릭합니다.
탭을 클릭하여 해당 측정항목 그룹을 확인합니다.
- 검색당. 측정항목은 검색별로 그룹화됩니다.
- 세션당. 측정항목은 검색 세션별로 그룹화됩니다.
- 비교. 기준 측정항목은 비교 기간의 측정항목과 함께 표시됩니다. 기준 측정항목 (이전 기간) 및 비교 측정항목 (이후 기간)의 기간을 선택합니다. 이러한 기간은 겹칠 수 없습니다.
측정항목을 필터링하려면 다음 필터 중 하나를 지정한 다음 새로고침 버튼을 클릭하여 적용합니다.
- 기간. 사전 설정된 기간을 선택하거나 가능한 경우 커스텀 기간을 입력합니다.
- 검색어. 조건과 검색어 값을 선택합니다. 검색어 필터를 여러 개 추가할 수 있습니다. 검색당 및 비교 측정항목에 사용할 수 있습니다.
- 기기 유형. 쿼리가 발생한 기기 유형을 선택합니다.

측정항목 정의

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

미디어 추천 측정항목

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

검색 측정항목

측정항목 이름	측정항목 정의	참고
검색 횟수	검색 이벤트 수	검색 로그 기반
결과 없음 비율	결과가 없는 검색 이벤트 수/검색 수	검색 로그 기반
검색당 클릭률(CTR)	검색 결과 클릭수/검색 수	검색 결과 클릭수는 이전 검색 이벤트로 인해 발생할 수 있는 항목 조회 이벤트입니다. 사용자 이벤트 기반
검색 세션 수	검색 세션 수	검색 세션은 검색 이벤트가 하나 이상 포함된 사용자 세션입니다. 사용자 세션(방문이라고도 함)은 연속된 사용자 이벤트 집합입니다. 30분 동안 활동이 없으면 세션이 종료됩니다. 검색 로그 기반
검색 방문당 페이지 조회수	검색 세션의 항목 조회 이벤트 수/검색 세션 수	이 측정항목에는 Vertex AI Search로 인한 것인지에 관계없이 검색 방문의 모든 페이지 조회수가 포함됩니다. 사용자 이벤트 기반
이탈률	검색 세션의 이탈 횟수/검색 세션 수	검색 세션 이탈은 검색이 한 번 포함된 세션으로 정의되며, 여기서 사용자는 한 번만 검색한 후 사이트를 떠납니다. 사용자 이벤트 기반

분석 사용 중지

기존 앱의 분석은 사용 중지할 수 없지만 앱을 만들 때 분석을 사용 중지하여 만들 수 있습니다.

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

검색 앱 만들기의 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
}'

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