本页介绍了如何查看媒体推荐应用和搜索应用的分析数据。
Analytics 可让您深入了解使用趋势、搜索情况以及建议 质量和最终用户互动情况Vertex AI Agent Builder 控制台 提供由 Looker 提供支持的互动式信息中心体验。
- 对于媒体推荐应用：公开预览版。您可以根据用户事件查看每个推荐的指标。您可以按日期范围和设备类型过滤指标。
- 对于通用搜索应用和媒体搜索应用：您可以根据搜索日志和用户事件查看每次搜索的指标和每次搜索会话的指标。您可以按日期范围、查询和设备类型过滤指标。
指标大约每 6 小时刷新一次，因此您在创建应用后可能需要等待几个小时才能使用分析页面。
用于分析的数据源
本部分介绍了根据应用类型进行分析的数据源。
您必须完成用户事件集成 查看用户事件分析数据
您上传的哪些用户事件会影响生成的分析数据。
媒体推荐应用需要以下用户事件才能查看某些指标：
- 商品查看事件。点击率的必需字段。
- 媒体播放完毕事件。每次播放完成率和每次推荐完成率的必填项。
- 媒体播放事件。对于推荐媒体播放计数是必需的， 播放率、每次播放的完整播放率以及每次播放的平均观看时长。
搜索应用需要以下用户事件才能查看部分指标：
- 搜索事件。对于点击率是必填项。
- View-item 事件。对于点击率是必填项。
以下信息还会用于某些分析：
- 展示次数。您可以在提取用户事件时在
UserEvent.Documents中添加关联的商品，以提供归因于 Vertex AI Search 的展示次数（商品浏览或点击）。系统需要这些信息来进行归因和计算每次搜索的指标。 - 归因令牌。归因令牌是由
Vertex AI Search 随每个搜索请求一起返回。请确保
将该归因令牌作为
UserEvent.attributionToken添加到 用户事件。这是确定搜索 由该 API 提供。系统仅会使用包含 Google 生成的归因令牌的用户事件来计算指标。 - 用户代理。在用户事件中包含
UserInfo.userAgent，以便 您可以按设备类型过滤用户事件指标
搜索日志
搜索应用会将搜索日志用作某些指标的数据源。
搜索日志基于搜索请求。要允许 Vertex AI Agent Builder
识别用户会话，以便提供每次会话的分析数据，以及提高
搜索结果，Google 强烈建议您将可选的
字段 SearchRequest.UserPseudoId。
如果还没有任何搜索日志或用户事件，则系统会针对所有指标显示默认值。
查看媒体推荐分析数据
请按照以下说明查看媒体推荐的分析数据。
在 Google Cloud 控制台中，前往 Agent Builder 页面。
点击您要查看分析数据的应用的名称。
点击 Analytics 。
要过滤指标，请指定以下任意过滤条件，然后点击 刷新按钮以应用这些更改：
- 日期范围。选择预设的日期范围，或输入自定义日期范围（如果有）。
- 设备类型。选择发生查询的设备类型。
查看搜索分析数据
请按照以下说明查看一般搜索或媒体的分析数据 搜索应用。
在 Google Cloud 控制台中，前往 Agent Builder 页面。
点击您要查看其分析数据的应用的名称。
点击 Analytics 。
点击相应标签页可查看相应指标组：
- 依据搜索。指标按搜索分组。
- 基于会话。指标按搜索会话分组。
- 比较。基准指标会与 对比期。选择基准指标的日期范围（ 较早的时间范围）和比较指标（较晚的时间范围）。这些 时间范围不能重叠
要过滤指标，请指定以下任意过滤条件，然后点击 刷新按钮以应用这些更改：
- 日期范围。选择预设的日期范围，或输入自定义日期范围（如果有）。
- 搜索查询。选择条件和搜索查询值。您 可以添加多个搜索查询过滤条件。适用于“每次搜索”和“比较”指标。
- 设备类型。选择发生查询的设备类型。
指标定义
下表介绍了指标的定义方式。
媒体推荐指标
| 指标名称 | 指标定义 | 备注 |
|---|---|---|
| 建议数量 | 建议总数 | |
| 推荐播放次数 | 推荐媒体项的播放次数 | |
| 推荐内容点击次数 | 推荐媒体项获得的点击次数 | |
| 点击率 | 推荐点击次数/推荐数量 | 推荐内容点击是指可归因于推荐内容的观看商品事件 |
| 推荐媒体完整播放次数 | 推荐的媒体项完整播放的次数 | |
| 每条推荐的观看完率 | 推荐媒体项的播放次数 / 推荐数量 | |
| 每次播放的完整播放率 | 推荐媒体内容完整播放的次数/媒体内容播放的次数 | |
| 每次播放的平均观看时长 | 推荐媒体项的播放时长（以秒为单位）/推荐媒体项的播放次数 | |
| 每条建议的完成率 | 媒体项完整播放的次数/推荐次数 | |
| 每条推荐的平均观看时长 | 推荐媒体项的观看时长（以秒为单位）/推荐内容数量 |
搜索指标
| 指标名称 | 指标定义 | 备注 |
|---|---|---|
| 搜索次数 | 搜索事件数 | 基于搜索日志 |
| 无结果率 | 无结果的搜索事件数 / 搜索次数 | 基于搜索日志 |
| 点击率 每次搜索的点击率 (CTR) | 搜索点击次数 / 搜索次数 | 搜索点击是可归因于之前的搜索事件的查看商品事件。基于用户事件 |
| 搜索会话计数 | 搜索次数 会话 | 搜索会话是指包含至少 1 个搜索事件的用户会话。用户会话（也称为“访问”）是指一组连续的用户事件。如果存在 30 分钟 处于非活跃状态， 会话结束。基于搜索日志 |
| 每次搜索访问的网页浏览量 | 查看项计数 搜索结果中的活动 每次搜索的会话数 会话次数 | 此指标包括搜索访问中的所有网页浏览次数，无论这些网页浏览次数能否归因于 Vertex AI Search。基于用户事件 |
| 跳出率 | 搜索会话中的跳出次数 / 搜索会话次数 | 搜索会话 “跳出”的定义是 单个会话 用户搜索的内容 仅制作 一个搜索。创建基础 用户事件 |