查看分析数据

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

通过分析数据，您可以深入了解应用的使用趋势、搜索和推荐质量以及最终用户互动情况。Agent Search 控制台依托 Looker 的支持，能够提供交互式信息中心体验。

• 对于媒体推荐应用：公开预览版。您可以查看以用户事件为依据的每次推荐指标。您可以按日期范围和设备类型过滤指标。
• 对于自定义搜索应用和媒体搜索应用：您可以查看以搜索日志和用户事件为依据的每次搜索指标 和每次搜索会话指标。您可以按日期范围、搜索查询和设备类型过滤指标。
• 对于医疗保健搜索应用：公开预览版。您可以查看以搜索日志为依据的每次搜索指标。

指标大约每 6 小时刷新一次，因此在您创建应用后，可能需要几个小时才能使用分析 页面。

分析数据的数据源

本部分介绍了不同应用类型的分析数据的数据源。

您必须完成用户事件集成，才能查看用户事件分析数据。

您上传的用户事件会影响生成的分析数据。

媒体推荐应用需要以下用户事件才能查看某些指标：

• 商品查看事件。对于点击率是必需的。
• 媒体完整播放事件。对于每次播放的完整播放率和每次推荐的完整播放率是必需的。
• 媒体播放事件。对于推荐媒体播放次数、完整播放率、每次播放的完整播放率和每次播放的平均观看时长是必需的。

搜索应用需要以下用户事件才能查看某些指标：

• 搜索事件。对于点击率是必需的。
• 商品查看事件。对于点击率是必需的。

以下信息也用于某些分析：

• 展示次数 。您可以在注入用户事件时，通过在 UserEvent.Documents 中添加相关联的商品来提供可归因于 Agent Search 的展示次数（商品查看次数或点击次数）。此信息对于归因和计算每次搜索指标是必需的。
• 归因令牌 。归因令牌是由 Agent Search 生成并随每次搜索请求返回的唯一 ID。请务必将该归因令牌作为 UserEvent.attributionToken 添加到因搜索而产生的任何用户事件中。需要使用此信息来确定搜索是否由 API 提供。只有具有 Google 生成的归因令牌的用户事件才用于计算指标。
• 用户代理 。在用户事件中添加 UserInfo.userAgent，以便您可以按设备类型过滤用户事件指标。

搜索日志

搜索应用使用搜索日志作为某些指标的数据源。

搜索日志基于搜索请求。为了让 Agent Search 能够 识别用户会话，从而提供每个会话的分析和更高 质量的搜索结果，Google 强烈建议您设置可选 字段 userPseudoId。

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

查看媒体推荐分析数据

**注意**： 媒体推荐分析数据目前为公开预览版。

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

1. 在 Google Cloud 控制台中，前往 AI Applications 页面。

   AI Applications

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

3. 点击分析 。

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

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

查看搜索分析数据

备注：

• 对于位于美国和欧盟多区域的数据存储区，查看搜索分析数据目前为 公开预览版。
• 由于 Agent Search for healthcare search 仅在美国多区域 (us) 提供医疗保健搜索服务，因此医疗保健搜索的分析数据目前为公开 预览版。
• 搜索分析数据是面向全球数据存储区的正式版。

按照以下说明查看搜索应用的分析数据。

1. 在 Google Cloud 控制台中，前往 AI Applications 页面。

   AI Applications

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

3. 点击分析。

4. 点击一个标签页以查看相应指标组：

   • 每次搜索 。指标按搜索分组。对于医疗保健搜索，这是唯一可用的指标组。
   • 每次会话 。指标按搜索会话分组。
   • 比较 。基准指标与比较时间段的指标一起显示。选择基准指标（较早的时间范围）和比较指标（较晚的时间范围）的日期范围。这些时间范围不能重叠。

5. 如需过滤指标，请指定过滤条件，然后点击刷新 按钮以应用这些过滤条件。

   对于媒体应用和自定义搜索应用，可以使用以下过滤条件：

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

   对于医疗保健搜索应用，可以使用以下过滤条件：

   • 日期范围 。选择预设的日期范围，或者（如果可用）输入自定义的日期范围。如果您为自定义日期范围选择特定日期，则该日期是搜索发生时的日期（采用 UTC-08:00 时区）。
   • 搜索查询 。选择条件和搜索查询值。您可以添加多个搜索查询过滤条件。
   • 用户位置 。选择在搜索请求中设置的医院、诊所或医疗保健服务提供商的位置。只有在搜索请求中设置了此过滤条件时，才能使用此过滤条件。
   • 用户角色 。选择发送搜索请求的用户的职业类别。只有在搜索请求中设置了此过滤条件时，才能使用此过滤条件。
   • 用户设置 。选择在搜索请求中设置的医疗保健设置，例如住院、门诊或混合治疗。只有在搜索请求中设置了此过滤条件时，才能使用此过滤条件。

指标定义

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

媒体推荐指标

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

媒体和自定义搜索指标

指标名称	指标定义	备注
搜索量	搜索事件数	基于搜索日志。
无结果率	无结果的搜索事件数/搜索量	基于搜索日志。
每次搜索的点击率 (CTR)	搜索点击次数/搜索量	搜索点击次数是可以归因于之前搜索事件的商品查看事件。 基于用户事件。
“赞”和“不喜欢”反馈数量	“赞”和“不喜欢”反馈数量	应用用户发送的“我喜欢”/“不喜欢”反馈响应的记录。
“不喜欢”原因细分	“不喜欢”原因所占的百分比	当用户不喜欢生成的回答时，可以选择多个原因来解释为什么不喜欢。 该百分比表示每个原因被选择的频率。
搜索会话数	搜索会话数	搜索会话是指包含至少一个搜索事件的用户会话。用户会话（也称为访问）是一系列连续的用户事件。如果用户无活动 30 分钟，会话就会结束。基于搜索日志。
每次搜索访问的网页浏览量	搜索会话中的商品查看事件数 / 搜索会话数	此指标包括搜索访问中的所有网页浏览量，无论这些网页浏览量是否可以归因于 Agent Search。 基于用户事件。
跳出率	搜索会话中的跳出次数/搜索会话数	搜索会话跳出是指仅包含一次搜索的会话，用户在仅进行一次搜索后就离开了。基于用户事件。

医疗保健搜索指标

医疗保健搜索应用可以使用以下搜索指标。

指标名称	指标定义	备注
搜索量	搜索事件数
无结果数	无结果的搜索事件数
每次搜索的无结果率	每次搜索的无结果搜索事件数
患者数	发生搜索的患者 ID 数	此指标按搜索用户进行去重，但不按患者进行去重。例如，如果用户 1 搜索了患者 A 和 B，而用户 2 仅搜索了患者 B，则患者数为 3。
客户搜索会话数	搜索用户定义会话数	您可以在搜索中发送会话 ID。 如需了解详情， 请参阅 session。
搜索访问者数	发送搜索请求的用户数	系统会根据 字段 userInfo 统计用户数。
合成搜索会话数	Google 定义的搜索会话数	搜索会话是指包含至少一个搜索事件的用户会话。用户会话（也称为访问）是一系列连续的用户事件。如果用户无活动 30 分钟，会话就会结束。

关闭分析功能

您无法为现有应用关闭分析功能，但在创建应用时，可以选择创建时关闭分析功能。

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

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

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