将分析指标导出到 BigQuery

本页介绍了如何将 Vertex AI Search 零售解决方案分析指标导出到 BigQuery。通过导出分析指标，您可以保留这些指标并编写 SQL 以进行自己的分析。

系统会自动为您生成 Vertex AI Search 零售解决方案分析指标。如需详细了解如何使用分析指标衡量 Vertex AI Search for Retail 对业务的影响，请参阅查看分析。

将指标数据导出到 BigQuery 时存在以下限制：

  • 导出到 Vertex AI Search for Retail 项目中的 BigQuery 表中的数据是授权视图，而不是具体化视图。

  • 您无法更改或更新这些表格中的数据。如果您需要更改或更新数据，请将视图导出或复制到其他目标位置。

  • 您无法导出超过 180 天前的用户事件的指标，也无法导出超过 180 天前生成的指标。您无法检索 180 天内生成的任何指标。

准备工作

您必须先完成准备工作中的步骤，然后才能将指标导出到 BigQuery。这包括导入用户事件，以及（可选）目录信息。

如需详细了解导入，请参阅：

在 BigQuery 中创建数据集

您需要在 BigQuery 中创建一个数据集来存储分析指标数据。

您必须在实现 Vertex AI Search for Retail 的项目中创建数据集。

  1. 如果您之前未在项目中使用过 BigQuery，请启用 BigQuery API，并确保您拥有可让您创建数据集和表的 IAM 角色。

    请参阅开始前须知和使用 IAM 进行访问权限控制

    部分。

  2. 在 BigQuery 中，在 US（美国的多个区域）多区域中创建一个数据集。例如，将其命名为 retail_data。如果您在其他区域创建数据集，将数据导出到 BigQuery 将会失败。不支持为数据集启用 CMEK；启用该功能会导致导出失败。

    如需了解如何创建数据集，请参阅 BigQuery 文档中的创建数据集。

    此数据集将用于存储您导出的数据表。以下步骤介绍了如何导出。

将分析指标导出到 BigQuery 表

使用 exportAnalyticsMetrics 方法将零售清单导出到 BigQuery 表。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：您创建 BigQuery 数据集的 Vertex AI Search for Retail 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 测试，因为 A/B 测试取决于维度 external_experiment_ids，而漫游器过滤会应用于所有流量。

指标维度

计数指标是直接从具有相同维度的相关用户事件中汇总的原始计数。如需解读指标，您需要知道指标基于哪些维度。出于分析指标的目的，搜索和浏览事件被称为展示事件，detail_page_view、add_to_cart 和 purchase 事件被称为转化事件。下表定义了指标维度。

指标维度 说明
日期

生成指标的相关事件的日期。

对于展示指标，这是展示事件的日期。

对于会话和访问者指标，此日期是会话/访问者的首次展示事件的日期。
external_experiment_ids

生成指标的相关事件的实验 ID。

对于展示指标，这是展示事件的实验 ID。

对于会话和访问者指标，此维度是会话/访问者中显示的所有展示事件的唯一外部实验 ID 的串联。例如，如果会话/访问者中有两个搜索事件，第一个搜索事件的 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

生成指标的相关事件的设备类型，例如事件是从移动设备还是桌面设备生成的。

对于展示指标，此维度是指展示事件的设备类型。

对于会话和访问者指标，如果会话/访问者具有多个不同的设备类型，则此字段为空；如果整个会话/访问者只有一种设备类型，则此字段为相应设备类型。
serving_config

生成指标的相关事件的投放配置。

对于展示指标，这是展示事件的投放配置。

对于会话和访问者指标，如果会话/访问者有多个不同的投放配置，则此字段为空；如果整个会话/访问者只有一个投放配置，则此字段为该投放配置。
traffic_destination

生成指标的相关事件的来源。

对于展示次数指标，如果展示由 Google 投放，则为“Google”；如果展示由您自己的解决方案投放，则为“非 Google”。

对于会话和访问者指标，如果会话/访问者同时包含由 Google 和您自己的解决方案投放的展示事件，则此值为“混合”。如果展示事件完全由 Google 投放，则为“Google”；如果展示事件完全由您的解决方案在整个会话/访问者期间投放，则为“非 Google”。
实体

这种类型适用于使用一个商品清单为多个品牌网站或区域提供服务的零售商。实体通常代表品牌或地理位置。

对于展示指标，这是展示事件的实体。

对于会话和访问者指标，这是会话/访问者的展示事件中统计到的前五个实体。

展示次数指标

系统会根据前提条件计算展示次数指标。只有当转化事件（detail_page_view、add_to_cart 和 purchase 事件）符合以下条件时，才能将其归因于展示事件。

  • 展示事件和转化事件具有相同的访问者。

  • 转化事件的商品 ID 必须显示在展示事件的结果中。

  • 转化事件发生在展示事件发生后的必要时间范围内。不同类型的转化事件适用不同的转化时间范围。

    转化路径 转化时间范围
    展示 -> 详情页面浏览 60 秒
    展示 -> 添加到购物车 24 小时
    展示 -> 购买 48 小时

搜索广告展示次数指标

指标名称 说明
search_event 搜索事件数
detail_page_view_from_search 来自搜索的详情页面浏览事件数
add_to_cart_unit_from_search 通过搜索进行的“添加到购物车”次数
purchase_unit_from_search 通过搜索购买的单位数
revenue_from_search 搜索带来的收入
search_event_without_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 会话数

搜索会话指标

搜索会话是指包含至少 1 个搜索事件的会话。请注意，搜索会话也可以是浏览会话，如浏览会话指标所定义。

指标名称 说明
search_session 涉及搜索的会话数
search_event_in_search_session 搜索会话中的搜索事件数
browse_event_in_search_session 搜索会话中的浏览事件数
detail_page_view_in_search_session 搜索会话中的详情页面浏览次数
add_to_cart_in_search_session 搜索会话中的“加入购物车”事件数
add_to_cart_unit_in_search_session 搜索会话中的“加入购物车”单位数
purchase_order_in_search_session 搜索会话中的采购订单数
purchase_unit_in_search_session 搜索会话中的购买单位数
revenue_in_search_session 搜索会话中的收入
bounce_count_in_search_session 在搜索会话中仅查看一个网页后离开网站的访问者的会话数

浏览会话指标

浏览会话是指包含至少 1 个浏览事件的会话。请注意，浏览会话也可以是搜索会话，如搜索会话指标所定义。

指标名称 说明
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 在浏览会话中仅浏览了 1 个网页后离开网站的访问者的会话数

访问者指标

访问者通过访问者 ID 进行唯一标识。访问者指标会汇总访问者的所有用户事件信息。

用于描述访问者指标的维度由访问者的所有用户事件共同定义。如需了解如何为访问者设置维度值，请参阅指标维度。

指标名称 说明
访问者 访问者人数

搜索访问者指标

搜索访问者是指执行了至少 1 项搜索事件的访问者。请注意，根据浏览访问者指标的定义，搜索访问者也可以是浏览访问者。

指标名称 说明
search_visitor 执行过至少一次搜索的访问者数
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 来自搜索访问者的收入

浏览访问者指标

浏览访问者是指执行了至少 1 次浏览事件的访问者。请注意，浏览访问者也可以是搜索访问者，如搜索访问者指标所定义。

指标名称 说明
browse_visitor 至少执行过一次浏览的访问者数
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)

按日期、设备类型和流量目的地计算搜索点击率。

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

获取因浏览而产生的详情页面浏览次数

获取来自 Google 流量浏览事件的详情页面浏览事件（external_experiment_ids 包含 test_arm），并显示所有维度信息。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)

获取最常用的服务配置

获取 2023 年 10 月 1 日至 2023 年 11 月 1 日期间 Google 流量最常用的广告投放配置。每个搜索事件都应具有关联的广告投放配置。

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