查看分析数据

本页介绍了如何查看媒体推荐应用和搜索应用的分析数据。

借助分析，您可以深入了解应用的使用趋势、搜索和推荐质量以及最终用户互动情况。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 能够识别用户会话，以便提供每个会话的分析数据和更优质的搜索结果，Google 强烈建议您设置可选字段 SearchRequest.UserPseudoId。

如果还没有任何搜索日志或用户事件，则系统会针对所有指标显示默认值。

查看媒体推荐分析

请按照以下说明查看媒体推荐的分析数据。

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 点击您要查看其分析数据的应用的名称。

3. 点击 Analytics 。

4. 如需过滤指标，请指定以下任意过滤条件，然后点击刷新按钮以应用过滤条件：

   • 日期范围。选择预设的日期范围，或输入自定义日期范围（如果有）。
   • 设备类型。选择查询发生的设备类型。

查看搜索分析

请按照以下说明查看通用搜索应用或媒体搜索应用的分析数据。

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 点击您要查看其分析数据的应用的名称。

3. 点击 Analytics 。

4. 点击相应标签页可查看相应指标组：

   • 每次搜索。指标会按搜索进行分组。
   • 每次会话。指标会按搜索会话进行分组。
   • 比较。基准指标会与对比时间段的指标一起显示。为基准指标（较早的时间范围）和对比指标（较晚的时间范围）选择日期范围。这些时间范围不能重叠。

5. 如需过滤指标，请指定以下任意过滤条件，然后点击刷新按钮以应用过滤条件：

   • 日期范围。选择预设的日期范围，或输入自定义日期范围（如果有）。
   • 搜索查询。选择一个条件和搜索查询值。您可以添加多个搜索查询过滤条件。适用于“每次搜索”和“比较”指标。
   • 设备类型。选择查询发生的设备类型。

指标定义

下表介绍了指标的定义方式。

媒体推荐指标

指标名称	指标定义	备注
推荐数量	推荐总数
推荐内容的播放次数	推荐媒体项的播放次数
推荐内容点击次数	推荐媒体项的点击次数
点击率	推荐点击次数 / 推荐数量	推荐内容点击是指可归因于推荐内容的观看商品事件
推荐媒体完成次数	推荐媒体项完整播放的次数
每次推荐的观看完率	推荐媒体项的播放次数 / 推荐内容数量
每次播放的完整播放率	推荐媒体内容完整播放的次数 / 媒体内容播放的次数
每次播放的平均观看时长	推荐媒体内容的播放时长（以秒为单位）/推荐媒体内容的播放次数
每项推荐的完成率	媒体项完整播放的次数 / 推荐次数
每条推荐的平均观看时长	推荐媒体项的观看时长（以秒为单位）/ 推荐内容数量

搜索指标

指标名称	指标定义	备注
搜索量	搜索事件数	基于搜索日志
无结果率	无结果的搜索事件数 / 搜索次数	基于搜索日志
每次搜索的点击率 (CTR)	搜索点击次数 / 搜索次数	搜索点击是可归因于之前的搜索事件的查看商品事件。基于用户事件
搜索会话计数	搜索会话数	搜索会话是指包含至少 1 个搜索事件的用户会话。用户会话（也称为“访问”）是指一组连续的用户事件。当处于非活动状态的时间超过 30 分钟时，会话将结束。基于搜索日志
每次搜索访问的网页浏览量	搜索会话中的查看商品事件数 / 搜索会话数	此指标包括搜索访问中的所有网页浏览次数，无论这些网页浏览次数能否归因于 Vertex AI Search。基于用户事件
跳出率	搜索会话中的跳出次数 / 搜索会话次数	搜索会话跳出是指仅包含一次搜索的会话，即用户仅执行一次搜索后便离开了。基于用户事件

关闭分析

您无法为现有应用关闭 Google Analytics，但在创建应用时，可以选择在关闭 Google Analytics 的情况下创建应用。

如需创建不会收集分析数据的搜索应用，请执行以下操作：

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
   }'
   
       

   此命令会创建一个不会收集搜索分析数据的应用。