将分析指标导出到 BigQuery

本页面介绍了如何将 Vertex AI Search for Retail 分析指标导出到 BigQuery。导出分析指标可让您保留 并编写 SQL 以便进行您自己的分析。

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

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

  • 导出到 BigQuery 表中的 用于零售的 Vertex AI Search 项目是已获授权的视图，而非 具体化视图。

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

  • 您无法导出超过 180 天或 在超过 180 天之前生成的指标。生成的所有指标 否则将无法检索。

准备工作

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

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

在 BigQuery 中创建数据集

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

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

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

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

    部分。

  2. 在 BigQuery 中创建数据集，位于美国（此区域中的多个区域 美国）多区域。例如，将其命名为 retail_data。如果您在其他区域创建数据集，将数据导出到 BigQuery 将会失败。数据集的 CMEK 不是 支持；则会导致导出失败。

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

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

将 Google Analytics 指标导出到 BigQuery 表

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

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

  • PROJECT_ID： 您在其中创建了 BigQuery 的 Vertex AI Search for Retail API 项目 数据集。
  • 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 分钟内没有发生其他事件时，系统就会标记该会话。通过 只要在 启动会话。会话结束后，当用户再次与系统互动时，系统会开始新的会话。

描述会话指标特征的维度由所有 会话内的用户事件请参阅指标 维度用作为 会话。

指标名称 说明
session 会话次数

搜索会话指标

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

指标名称 说明
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