本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 通过搜索分析获得见解
<a name="search-analytics"></a>

**注意**  
功能支持因所用索引类型和搜索 API 而异。要查看您使用的索引类型和搜索 API 是否支持此功能，请参阅[索引类型](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html)。

您可以使用 se Amazon Kendra arch *Analytics* 来深入了解您的搜索应用程序如何成功或失败地帮助用户查找信息。

Amazon Kendra Analytics 提供了用户与搜索应用程序的交互方式以及搜索应用程序配置的有效性的快照。您可以使用 [GetSnapshots](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GetSnapshots.html)API 或在控制台的导航面板上选择 **Analytics** 来查看指标数据。

您可以使用 `GetSnapshots` 在自己的自定义构建控制面板上显示生成的数据。或者，您可以使用控制台中提供的指标控制面板，其中包含可视化图表。借助可视化控制面板，您可以查看一段时间内用户行为的趋势或模式，或者发现搜索应用程序配置所存在的问题。例如，显示每天查询数量稳定且稳步增长的折线图可能表明采用率和使用率有所提高。另一方面，突然下降可能表明存在必须调查的问题。

您可以使用这些指标在不同的数据点之间建立联系，以解决用户如何查询信息或发现商机的问题。例如，文档“人工智能的工作原理是什么？” 是搜索结果中点击次数最多的文档，搜索次数最多的查询是“机器学习的工作原理是什么”。这会可以让您了解用户首选的术语和语言。您可以将这些术语编写到您的文档中，也可以为这些术语使用自定义同义词，以便让用户更容易搜索您的文档。

## 搜索指标
<a name="search-analytics-metrics"></a>

有 10 个指标可用于分析您的搜索应用程序的性能或用户正在搜索的信息。要检索指标数据，请在调用 `GetSnapshots` 时指定要检索的指标数据的字符串名称。

您还必须提供查看指标数据的时间间隔或时段。时间间隔使用索引的时区。您可以查看以下时段内的数据：
+ `THIS_WEEK`：本周，从星期日开始到当日的前一天结束。
+ `ONE_WEEK_AGO`：上周，从星期日开始到下一个星期六结束。
+ `TWO_WEEKS_AGO`：上上周，从星期日开始到下一个星期六结束。
+ `THIS_MONTH`：本月，从当月开始第一天开始到当日的前一天结束。
+ `ONE_MONTH_AGO`：上月，从当月的第一天开始到当月最后一天结束。
+ `TWO_MONTHS_AGO`：上上月，从当月的第一天开始，到当月最后一天结束。

在控制台中，支持的时段包括**本周**、**上月**、**本月**、**上月**。



### 点击率
<a name="search-click-through-rate"></a>

搜索结果中产生文档点击的查询比例。这可以让您了解搜索应用程序配置是否可以帮助用户找到与其查询相关的信息。对于返回即时答案的查询，用户可能无需点击文档即可获得更多信息。有关更多信息，请参阅 [即时回答率](#search-instant-answer-rate)。您必须致电[SubmitFeedback](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html)以确保收集到点击反馈。

要使用 `GetSnapshots` API 检索关于点击率的数据，请将 `metricType` 指定为 `AGG_QUERY_DOC_METRICS`。在控制台中选择导航面板上的 **Analytics**，您也可以查看该指标。

### 点击次数为零
<a name="search-zero-click-through-rate"></a>

在搜索结果中点击次数为零的查询比例。这可以帮助您了解内容有哪些差距，为何会提供相关性不大的搜索结果。对于返回即时答案的查询，用户可能无需点击文档即可获得更多信息。有关更多信息，请参阅[即时回答率](#search-instant-answer-rate)。此外，您的搜索设置（例如，调整配置）可能会影响搜索结果中文档的返回方式。

要使用 `GetSnapshots` API 检索点击率为零的数据，请将 `metricType` 指定为 `AGG_QUERY_DOC_METRICS`。在控制台中选择导航面板上的 **Analytics**，您也可以查看该指标。

### 搜索结果率为零
<a name="search-zero-results-rate"></a>

导致搜索结果率为零的查询比例。这可以帮助您了解内容有哪些差距，为何会提供不相关的搜索结果。

要使用 `GetSnapshots` API 检索搜索结果率为零的数据，请将 `metricType` 指定为 `AGG_QUERY_DOC_METRICS`。在控制台中选择导航面板上的 **Analytics**，您也可以查看该指标。

### 即时回答率
<a name="search-instant-answer-rate"></a>

返回具有即时回答或常见问题解答的查询的比例。这可以帮助您了解即时回答在提供信息方面的作用。

要使用 `GetSnapshots` API 检索即时回答率数据，请将 `metricType` 指定为 `AGG_QUERY_DOC_METRICS`。在控制台中选择导航面板上的 **Analytics**，您也可以查看该指标。

### 常用查询
<a name="search-top-queries"></a>

您的用户最常搜索的前 100 个查询。这可以帮助您了解哪些查询很受欢迎，以及您的用户最感兴趣的信息类型。

指标包括搜索查询的次数、点击文档的比例、未点击文档的比例、查询搜索结果中的平均点击深度、查询的即时回答比例以及查询前 10 个搜索结果的平均置信度。

要使用 `GetSnapshots` API 检索有关主要查询的数据，请将 `metricType` 指定为 `QUERIES_BY_COUNT`。在控制台中选择控制台导航面板上的 **Analytics**，然后选择**查询列表**下的**主要查询**，您也可以查看该指标。

### 点击次数为零的主要查询
<a name="search-top-queries-zero-clicks"></a>

在搜索结果中点击次数为零的前 100 个查询。这可以帮助您了解内容有哪些差距，即缺少与某些查询相关的文档，或者您的搜索应用程序配置返回的搜索结果不相关。对于返回即时答案的查询，用户可能无需点击文档即可获得更多信息。有关更多信息，请参阅[即时回答率](#search-instant-answer-rate)。

指标包括产生的点击次数为零的查询数量、点击次数为零的查询比例、即时回答的查询比例以及产生前 10 个搜索结果的查询的平均置信度。

要使用 `GetSnapshots` API 检索有关点击次数为零的主要查询的数据，请将 `metricType` 指定为 `QUERIES_BY_ZERO_CLICK_RATE`。在控制台中选择控制台导航面板上的 **Analytics**，然后选择**查询列表**下的**点击次数为零的主要查询**，您也可以查看该指标。

### 搜索结果为零的主要查询
<a name="search-top-queries-zero-results"></a>

在搜索结果为零的前 100 个查询。这可以帮助您了解内容有哪些差距，即没有与某些查询相关的文档。或者，您的用户可能会使用专业术语进行查询，而可能导致没有搜索结果，这表明您需要创建[自定义同义词](https://docs.aws.amazon.com/kendra/latest/dg/index-synonyms.html)来解决问题。

指标包括导致搜索结果为零的查询数量，搜索结果为零的查询比例，以及该查询的搜索数量相对于所有查询的比例。

要使用 `GetSnapshots` API 检索有关搜索结果为零的主要查询的数据，请将 `metricType` 指定为 `QUERIES_BY_ZERO_RESULT_RATE`。在控制台中选择控制台导航面板上的 **Analytics**，然后选择**查询列表**下的**结果为零的主要查询**，您也可以查看该指标。

### 点击次数最多的文档
<a name="search-top-clicked-docs"></a>

搜索结果中点击次数最多的前 100 个文档。这可以帮助您了解在用户查询信息时，哪些文档或搜索结果与他们最相关。

指标包括点击文档的次数、文档获得用户点喜欢的次数（竖起大拇指）、文档获得用户点不喜欢的次数（倒竖大拇指）。

要使用 `GetSnapshots` API 检索点击次数最多的文档的数据，请将 `metricType` 指定为 `DOCS_BY_CLICK_COUNT`。在控制台中选择控制台导航面板上的 **Analytics**，然后选择**查询列表**下的**点击次数最多的文档**，您也可以查看该指标。

### 查询总数
<a name="search-total-queries"></a>

您的用户搜索的查询总数。这可以帮助您了解用户对搜索应用程序的参与程度。

要使用 `GetSnapshots` API 检索有关查询总数的数据，请将 `metricType` 指定为 `AGG_QUERY_DOC_METRICS`。在控制台中选择导航面板上的 **Analytics**，您也可以查看该指标。

### 文档总数
<a name="search-total-docs"></a>

您的索引中的文档总数。这可以帮助您将索引大小与查询总数进行比较，从而检查文档数量是否有适合查询量。

要使用 `GetSnapshots` API 检索有关文档总数的数据，请将 `metricType` 指定为 `AGG_QUERY_DOC_METRICS`。在控制台中选择导航面板上的 **Analytics**，您也可以查看该指标。

### 检索指标数据的示例
<a name="retrieve-metric-data-example"></a>

以下代码是有关上月主要查询的检索数据的示例。

------
#### [ Console ]

**检索上月的主要查询**

1. 在左侧导航窗格的**索引**下，选择您的索引，然后选择 **Analytics**。

1. 在 **Analytics** 页面上，选择**本周**按钮，将检索数据的时段更改为**上月**。

1. 在 **Analytics** 页面的**查询列表**下，选择**主要查询**。

------
#### [ CLI ]

**检索上月的主要查询**

```
aws kendra get-snapshots \
--index-id index-id \
--interval "ONE_MONTH_AGO" \
--metric-type "QUERIES_BY_COUNT"
```

------
#### [ Python ]

**检索上月的主要查询**

```
import boto3

kendra = boto3.client("kendra")

index_id = "index-id"
interval = "ONE_MONTH_AGO"
metric_type = "QUERIES_BY_COUNT"

snapshots_response = kendra.get_snapshots(
    IndexId = index_id,
    Interval = interval,
    MetricType = metric_type
)

print("Top queries data: " + snapshots_response["snapshotsData"])
```

------
#### [ Java ]

**检索上月的主要查询**

```
package com.amazonaws.kendra;

import software.amazon.awssdk.services.kendra.KendraClient;
import software.amazon.awssdk.services.kendra.model.GetSnapshotsRequest;
import software.amazon.awssdk.services.kendra.model.GetSnapshotsResponse;

public class TopQueriesExample {
    public static void main(String[] args) {
        KendraClient kendra = KendraClient.builder().build();

        String indexId = "indexID";
        String interval = "ONE_MONTH_AGO";
        String metricType = "QUERIES_BY_COUNT";

        GetSnapshotsRequest getSnapshotsRequest = GetSnapshotsRequest
            .builder()
            .indexId(indexId)
            .interval(interval)
            .metricType(metricType)
            .build();

        GetSnapshotsResponse getSnapshotsResponse = kendra.getSnapshots(GetSnapshotsRequest);

        System.out.println(String.format("Top queries data: ", getSnapshotsResponse.snapshotsData()))
```

------

## 从指标到可行见解
<a name="search-actionable-insights"></a>

可行见解是从原始数据中提取的有意义的信息，用于指导您的行动或决策。要从指标中提取含义并用来获得可行的见解，重要的是不仅要分析每个指标，还要在指标之间建立联系。

例如，点击次数为零的主要查询是“当前有哪些区域可用？” 但是，它的即时回答率为 100％。这表明您的用户无需点击搜索结果或点击提供可用区域信息的文档即可获得该问题的答案。如果您只看到点击次数为零，就无法了解全貌，对于搜索应用程序配置能够成功处理该查询，您也可能得出错误的结论。

另一个可行见解的例子是发现商机。通常，企业通过分析搜索指标来寻找获客机会。点击次数最多的文档是“可用区域”。此外，大多数搜索的主要查询都与大洋洲区域的产品供应问题相关，答案中的即时回答率为 100％，有关可用区域的更多信息的点击率很高。这表明该区域对您的产品或服务有兴趣和需求。

## 可视化和报告搜索分析
<a name="search-visualizing-reporting"></a>

有五个指标，包括趋势数据，可供您可视化和查看一段时间内的趋势或模式。如果您使用控制台，则会提供趋势数据图表。如果您使用 APIs，则可以检索趋势数据来创建自己的图表或可视化效果。控制台中的大多数图表都绘制了所选时段内的每日数据点。

控制台提供了一个指标控制面板，您可以在其中选择要查看的图表和排名。在 **Analytics** 主页上选择**导出**，将控制面板上显示的指标以 CSV 格式导出。您可以将这些报告包含在您的业务文档或演示文稿中。

您可以可视化以下指标：

### 查询总数图表
<a name="search-total-queries-graph"></a>

每天查询数量折线图。该图表可帮助您可视化每日用户参与模式。一些例子包括用户参与度稳步增加或下降，或者由于搜索应用程序崩溃或网站问题而导致查询量急剧下降至 0。

如果您使用 API，则可以通过指定 `TREND_QUERY_DOC_METRICS` 来检索这些数据。您可以使用这些数据来创建自己的图表，也可以使用控制台中提供的图表。

### 点击率图表
<a name="click-through-rate-graph"></a>

每日点击比例折线图。该图表可帮助您可视化每日点击率的模式。一些例子包括点击率的稳步增加或降低，或者即时回答的减少可能会影响点击率的增加。

如果您使用 API，则可以通过指定 `TREND_QUERY_DOC_METRICS` 来检索这些数据。您可以使用这些数据来创建自己的图表，也可以使用控制台中提供的图表。

### 零点击率图表
<a name="zero-click-through-rate-graph"></a>

每日零点击比例折线图。该图表可帮助您可视化每日零点击率的模式。一些例子包括零点击率的稳步增加或降低，或者即时回答的增加可能会影响零点击量的增加。

如果您使用 API，则可以通过指定 `TREND_QUERY_DOC_METRICS` 来检索这些数据。您可以使用这些数据来创建自己的图表，也可以使用控制台中提供的图表。

### 零搜索结果率图表
<a name="zero-search-results-rate-graph"></a>

每日零搜索结果比例折线图。该图表可帮助您可视化每日零搜索结果的模式。一些例子包括零搜索结果率的稳步增加或降低，或者索引中文档数量的急剧减少可能会影响零搜索结果的增加。

如果您使用 API，则可以通过指定 `TREND_QUERY_DOC_METRICS` 来检索这些数据。您可以使用这些数据来创建自己的图表，也可以使用控制台中提供的图表。

### 即时回答率图表
<a name="instant-answer-rate-graph"></a>

返回具有即时回答或常见问题解答的查询比例的折线图。该图表可帮助您可视化每日即时回答率的模式。一些例子包括问答类型查询的稳步增加或减少，或者点击次数的减少可能会影响即时回答的增加。

如果您使用 API，则可以通过指定 `TREND_QUERY_DOC_METRICS` 来检索这些数据。您可以使用这些数据来创建自己的图表，也可以使用控制台中提供的图表。