BigQuery로 분석 측정항목 내보내기

이 페이지에서는 소매업 분석용 Vertex AI Search 측정항목을 BigQuery로 내보내는 방법을 설명합니다. 분석 측정항목을 내보내면 측정항목을 유지하고 자체 분석을 위해 SQL을 작성할 수 있습니다.

소매업 분석용 Vertex AI Search 측정항목은 자동으로 생성됩니다. 분석 측정항목으로 소매업용 Vertex AI Search의 비즈니스 영향을 측정하는 방법에 대한 자세한 내용은 분석 보기를 참조하세요.

BigQuery로 측정항목 데이터를 내보내는 경우 다음과 같은 제한사항이 있습니다.

  • 소매업용 Vertex AI Search 프로젝트에서 BigQuery 테이블로 내보내는 데이터는 구체화된 뷰가 아닌 승인된 뷰입니다.

  • 이러한 테이블의 데이터는 변경하거나 업데이트할 수 없습니다. 데이터를 변경하거나 업데이트해야 하는 경우 뷰를 다른 대상으로 내보내거나 복사하세요.

  • 180일이 지난 사용자 이벤트의 측정항목 또는 180일 이전에 생성된 측정항목은 내보낼 수 없습니다. 180일 기간 이전에 생성된 측정항목은 검색할 수 없습니다.

시작하기 전에

측정항목을 BigQuery로 내보내려면 먼저 시작하기 전에의 절차를 완료해야 합니다. 여기에는 사용자 이벤트 및 카탈로그 정보(선택사항) 가져오기가 포함됩니다.

가져오기에 대한 자세한 내용은 다음을 참조하세요.

BigQuery에서 데이터 세트 만들기

분석 측정항목 데이터를 보관하려면 BigQuery에서 데이터 세트를 만들어야 합니다.

소매업용 Vertex AI Search를 구현한 동일한 프로젝트에서 데이터 세트를 만들어야 합니다.

  1. 이전에 프로젝트에서 BigQuery를 사용한 적이 없는 경우 BigQuery API를 사용 설정하고 데이터 세트와 테이블을 만들 수 있는 IAM 역할이 있는지 확인합니다.

    시작하기 전에 및 IAM으로 액세스 제어를

    BigQuery 문서에서 참조하세요.

  2. 멀티 리전 미국(미국의 여러 리전)에서 BigQuery의 데이터 세트를 만듭니다. 예를 들어 이름을 retail_data로 지정합니다. 다른 리전에 데이터 세트를 만들면 데이터를 BigQuery로 내보낼 수 없습니다. 데이터 세트용 CMEK는 지원되지 않으므로 사용 설정 시 내보내기가 실패합니다.

    데이터 세트 만들기에 대한 자세한 내용은 BigQuery 문서의 데이터 세트 만들기를 참조하세요.

    이 데이터 세트는 내보내는 데이터 테이블을 저장하는 데 사용됩니다. 다음 절차에서는 내보내는 방법을 설명합니다.

분석 측정항목을 BigQuery 테이블로 내보내기

exportAnalyticsMetrics 메서드를 사용하여 소매업 카탈로그를 BigQuery 테이블로 내보냅니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: BigQuery 데이터 세트를 만든 소매업용 Vertex AI Search API 프로젝트의 ID입니다.
  • DATASET_ID: BigQuery에서 데이터 세트 만들기에서 만든 데이터 세트의 이름입니다. 예를 들어 retail_data 또는 retail_metrics_data를 사용합니다.
  • TABLE_ID_PREFIX: 테이블 ID의 프리픽스입니다. 이 프리픽스는 빈 문자열일 수 없습니다. 서픽스 retail_analytics_metrics가 추가되어 테이블 이름을 완성합니다. 예를 들어 프리픽스가 test면 테이블 이름은 test_retail_analytics_metrics입니다.

JSON 요청 본문:

{
  "catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
  "outputConfig":
  {
    "bigqueryDestination":
    {
      "datasetId": "DATASET_ID",
        "tableIdPrefix": "TABLE_ID_PREFIX",
        "tableType": "view"
    }
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/12310973052792775280",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2.ExportAnalyticsMetricsResponse",
    "outputResult": {
      "bigqueryResult": [
        {
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID_PREFIX_retail_analytics_metrics"
        }
      ]
    }
  }
}

측정항목 정의

내보낸 측정항목은 개수 측정항목입니다. 봇 필터링은 측정항목 계산에서 일부 이벤트를 제외할 수 있으므로 일부 측정항목에서 드리프트가 약간 발생할 수 있습니다. 봇 필터링은 보다 정확한 성능 측정을 제공하는 데 도움이 될 수 있습니다. 봇 필터링은 모든 트래픽에 적용되는 반면 A/B 테스트(external_experiment_ids 측정기준에 따름)에는 영향을 미치지 않습니다.

측정항목 측정기준

개수 측정항목은 동일한 측정기준을 사용하여 관련 사용자 이벤트에서 직접 집계된 원시 개수입니다. 측정항목을 해석하려면 측정항목의 기반이 되는 측정기준을 알아야 합니다. 분석 측정항목을 위해 검색 및 탐색 이벤트는 노출 이벤트라고 하고 detail_page_view, add_to_cart, purchase 이벤트는 전환 이벤트라고 합니다. 다음 표에서는 측정항목 측정기준을 정의합니다.

측정항목 측정기준 설명
date

측정항목을 생성한 관련 이벤트의 날짜입니다.

노출 측정항목의 경우 노출 이벤트의 날짜입니다.

세션 및 방문자 측정항목의 경우 세션/방문자의 첫 번째 노출 이벤트의 날짜입니다.
external_experiment_ids

측정항목을 생성한 관련 이벤트의 실험 ID입니다.

노출 측정항목의 경우 노출 이벤트의 실험 ID입니다.

세션 및 방문자 측정항목의 경우 세션/방문자 내에 나타나는 모든 노출 이벤트의 고유 외부 실험 ID의 연결입니다. 예를 들어 세션/방문자 내에 2개의 검색 이벤트가 있는 경우 첫 번째 검색 이벤트에 external_experiment_ids 'test_arm_1,test_arm_2'가 포함되고, 두 번째 검색 이벤트에 external_experiment_ids 'test_arm_1', test_arm_3'이 포함되고, 세션/방문자의 external_experiment_ids가 'test_arm_1,test_arm_2,test_arm_3'이 됩니다.
device_type

측정항목을 생성한 관련 이벤트의 기기 유형입니다(예: 이벤트가 휴대기기 또는 데스크톱 기기에서 생성된 경우).

노출 측정항목의 경우 노출 이벤트의 기기 유형입니다.

세션 및 방문자 측정항목의 경우 세션/방문자에게 고유 기기 유형이 2개 이상 있으면 비어 있고 전체 세션/방문자에 대해 기기 유형이 하나만 있으면 하나입니다.
serving_config

측정항목을 생성한 관련 이벤트의 제공 구성입니다.

노출 측정항목의 경우 노출 이벤트의 게재 구성입니다.

세션 및 방문자 측정항목의 경우 세션/방문자에게 고유 제공 구성이 2개 이상 있으면 비어 있고 전체 세션/방문자에 대해 제공 구성이 하나만 있으면 하나입니다.
traffic_destination

측정항목을 생성한 관련 이벤트의 소스입니다.

노출 측정항목의 경우 Google에서 노출을 제공하는 경우 'Google', 자체 솔루션에서 노출을 제공하는 경우 'Google 외'로 표시합니다.

세션 및 방문자 측정항목의 경우 세션/방문자에 Google 및 자체 솔루션에서 제공하는 노출 이벤트가 둘 다 있는 경우 '혼합'입니다. 노출 이벤트를 Google에서만 제공하는 경우 'Google'이고, 전체 이벤트/방문자에 대한 노출 이벤트를 자체 솔루션에서 전적으로 제공하는 경우 'Google 외'입니다.
항목

하나의 제품 카탈로그로 여러 브랜드 사이트 또는 지역을 제공하는 소매업체에서 사용합니다. 항목은 일반적으로 브랜드 또는 위치를 나타냅니다.

노출 측정항목의 경우 노출 이벤트의 항목입니다.

세션 및 방문자 측정항목의 경우 세션/방문자에 대한 노출 이벤트의 상위 5개 집계 항목입니다.

노출 측정항목

노출 측정항목은 기본 요건에 따라 계산됩니다. 전환 이벤트(detail_page_view, add_to_cart, purchase 이벤트)는 다음 기준과 일치하는 경우에만 노출 이벤트에 다시 기여할 수 있습니다.

  • 노출 이벤트 및 전환 이벤트의 방문자는 동일합니다.

  • 전환 이벤트의 제품 ID가 노출 이벤트의 결과에 나타나야 합니다.

  • 전환 이벤트는 노출 이벤트가 발생 후 필수 기간 내에 있습니다. 다양한 유형의 전환 이벤트에는 서로 다른 전환 기간이 적용됩니다.

    전환 경로 전환 기간
    노출 -> 세부정보 페이지 조회 60초
    노출 -> 장바구니에 추가 24시간
    노출 -> 구매 48시간

검색 노출 측정항목

측정항목 이름 설명
search_event 이벤트 수 검색
search_page_view_from_search 검색의 세부정보 페이지 조회 이벤트 수
search_to_cart_unit_from_search 검색에서 장바구니에 추가 단위 수
purchase_unit_from_search 검색에서 구매 단위 수
revenue_from_search 검색으로 발생한 수익
search_event_less_result 결과가 없는 검색 이벤트 수
search_request_personalization_enabled 맞춤설정이 사용 설정된 검색 요청 수
search_request_personalization_result_served 맞춤설정된 결과와 함께 제공된 검색 요청 수

탐색 노출 측정항목

측정항목 이름 설명
browse_event 이벤트 수 탐색
detail_page_view_from_Browse 탐색에서 세부정보 페이지 조회 이벤트 수
add_to_cart_unit_from_browse 탐색에서 장바구니에 추가 단위 수
purchase_unit_from_browse 탐색에서 구매 단위 수
revenue_from_browse 탐색으로 발생한 수익
browse_event_without_result 결과가 없는 탐색 이벤트 수
browse_request_personalization_enabled 맞춤설정이 사용 설정된 탐색 요청 수
browse_request_personalization_result_served 맞춤설정된 결과와 함께 제공된 탐색 요청 수

세션 측정항목

세션은 사용자와 시스템 간의 지속적인 상호작용 기간으로 정의됩니다. 모든 사용자 이벤트는 세션의 시작을 표시하고 다음 30분 동안 다른 이벤트가 발생하지 않으면 세션 종료로 표시됩니다. 세션은 사용자 이벤트가 발생할 때마다 30분 더 연장됩니다. 세션이 종료된 후 사용자가 시스템에 다시 참여하면 새 세션이 시작됩니다.

세션 측정항목을 특성화하는 측정기준은 세션 내 모든 사용자 이벤트로 함께 정의됩니다. 세션에 대해 측정기준 값이 설정되는 방식은 측정항목 측정기준을 참조하세요.

측정항목 이름 설명
session 세션 개수

검색 세션 측정항목

검색 세션은 검색 이벤트를 한 개 이상 포함하는 세션입니다. 검색 세션은 탐색 세션 측정항목에 정의된 대로 탐색 세션일 수도 있습니다.

측정항목 이름 설명
search_session 검색과 관련된 세션 수
search_event_in_search_session 검색 세션 내 검색 이벤트 수
browse_event_in_search_session 검색 세션 내의 탐색 이벤트 수
search_page_view_in_search_session 검색 세션 내의 세부정보 페이지 조회수
search_to_cart_in_search_session 검색 세션 내에서 장바구니에 추가 이벤트 수
search_to_cart_unit_in_search_session 검색 세션 내에서 장바구니에 추가 단위 수
search_order_in_search_session 검색 세션 내 구매주문서 수
search_unit_in_search_session 구매 검색 세션 내 구매 단위 수
search_in_search_session 검색 세션으로 발생한 수익
search_session_session_count_in 검색 세션 중 한 페이지만 조회한 후 사이트를 떠나는 방문자의 세션 수

탐색 세션 측정항목

탐색 세션은 하나 이상의 탐색 이벤트를 포함합니다. 탐색 세션은 검색 세션 측정항목에 정의된 대로 검색 세션일 수도 있습니다.

측정항목 이름 설명
browse_session 탐색과 관련된 세션 수
search_event_in_browse_session 탐색 세션 내의 검색 이벤트 수
browse_event_in_browse_session 탐색 세션 내의 탐색 이벤트 수
detail_page_view_in_browse_session 탐색 세션 내의 세부정보 페이지 조회수
add_to_cart_in_browse_session 탐색 세션 내에서 장바구니에 추가 이벤트 수
add_to_cart_unit_in_browse_session 탐색 세션 내에서 장바구니에 추가 단위 수
purchase_order_in_browse_session 탐색 세션 내 구매주문서 수
purchase_unit_in_browse_session 탐색 세션 내 구매 단위 수
revenue_in_browse_session 탐색 세션으로 발생한 수익
bounce_count_in_browse_session 탐색 세션 중 한 페이지만 조회한 후 사이트를 떠나는 방문자의 세션 수

방문자 측정항목

방문자는 방문자 ID로 고유하게 식별됩니다. 방문자 측정항목은 방문자의 모든 사용자 이벤트 정보를 집계합니다.

방문자 측정항목의 특성을 나타내는 측정기준은 방문자의 모든 사용자 이벤트에 의해 함께 정의됩니다. 방문자의 측정기준 값이 설정되는 방식은 측정항목 측정기준을 참조하세요.

측정항목 이름 설명
방문자 방문자 수

검색 방문자 측정항목

검색 방문자는 하나 이상의 검색 이벤트를 수행하는 방문자입니다. 검색 방문자는 탐색 방문자 측정항목에 정의된 대로 탐색 방문자일 수도 있습니다.

측정항목 이름 설명
search_visitor 1회 이상 검색한 방문자 수
search_event_from_search_visitor 검색 방문자의 검색 이벤트 수
browse_event_from_search_visitor 검색 방문자의 탐색 이벤트 수
detail_page_view_from_search_visitor 검색 방문자의 세부정보 페이지 조회수
add_to_cart_from_search_visitor 검색 방문자의 장바구니에 추가 이벤트 수
add_to_cart_unit_from_search_visitor 검색 방문자의 장바구니에 추가 단위 수
purchase_order_from_search_visitor 검색 방문자의 구매주문서 수
purchase_unit_from_search_visitor 검색 방문자의 구매 단위 수
revenue_from_search_visitor 검색 방문자로부터 발생한 수익

탐색 방문자 측정항목

탐색 방문자는 하나 이상의 탐색 이벤트를 수행하는 방문자입니다. 탐색 방문자는 검색 방문자 측정항목에 정의된 대로 검색 방문자일 수도 있습니다.

측정항목 이름 설명
browse_visitor 1회 이상 탐색한 방문자 수
search_event_from_browse_visitor 탐색 방문자의 검색 이벤트 수
browse_event_from_browse_visitor 탐색 방문자의 탐색 이벤트 수
detail_page_view_from_browse_visitor 탐색 방문자의 세부정보 페이지 조회수
add_to_cart_from_browse_visitor 탐색 방문자의 장바구니에 추가 이벤트 수
add_to_cart_unit_from_browse_visitor 탐색 방문자의 장바구니에 추가 단위 수
purchase_order_from_browse_visitor 탐색 방문자의 구매주문서 수
purchase_unit_from_browse_visitor 탐색 방문자의 구매 단위 수
revenue_from_browse_visitor 탐색 방문자로부터 발생한 수익

사용 예시

측정항목 데이터를 다른 대상으로 복사하거나 내보내는 경우 SQL을 사용하여 내보낸 측정항목에 대한 상위 수준 또는 특정 정보를 가져올 수 있습니다. SQL을 사용하여 내보낸 측정항목을 탐색하는 일반적인 방법은 다음 섹션에 나와 있습니다.

클릭률(CTR) 계산

트래픽 대상별 기기 유형당 날짜별 검색 CTR을 계산합니다.

SELECT
  `date`,
  device_type,
  traffic_destination,
  SUM(detail_page_view_from_search) / SUM(search_event) as search_CTR
FROM copied_table
GROUP BY `date`, device_type, traffic_destination

탐색 기반 세부정보 페이지 조회 수 가져오기

test_arm을 포함하는 external_experiment_ids를 사용하여 Google 트래픽에 대한 탐색 이벤트에서 가져온 세부정보 페이지 보기 이벤트를 가져오고 모든 차원 정보를 표시합니다. external_experiment_ids는 반복되는 string입니다.

SELECT
  `date`,
  external_experiment_ids,
  device_type,
  serving_config,
  traffic_destination,
  entity,
  detail_page_view_from_browse
FROM copied_table
WHERE
  traffic_destination = 'Google' AND 'test_arm' in UNNEST(external_experiment_ids)

가장 많이 사용되는 제공 구성 가져오기

Google 트래픽에 대해 '2023-10-01'과 '2023-11-01' 간에 가장 많이 사용되는 제공 구성을 가져옵니다. 각 검색 이벤트에는 연결된 제공 구성이 있어야 합니다.

SELECT
  serving_config,
  SUM(search_event) as total_search_count
FROM copied_table
WHERE `date` between '2023-10-01' and '2023-11-01' AND traffic_destination = 'Google'
GROUP BY serving_config
ORDER BY total_search_count