本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 透過搜尋分析取得洞見
<a name="search-analytics"></a>

**注意**  
功能支援會因索引類型和正在使用的搜尋 API 而有所不同。若要查看您正在使用的索引類型和搜尋 API 是否支援此功能，請參閱[索引類型](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html)。

您可以使用 Amazon Kendra 搜尋*分析*來深入了解搜尋應用程式如何成功或不成功地協助您的使用者尋找資訊。

Amazon Kendra Analytics 提供使用者如何與搜尋應用程式互動的快照，以及搜尋應用程式組態的有效性。您可以使用 [GetSnapshots](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GetSnapshots.html) API 或在主控台的導覽面板上選取**分析**來檢視指標資料。

您可以在自己的自訂儀表板`GetSnapshots`上轉譯 產生的資料。或者，您可以使用 主控台中提供的指標儀表板，其中包含視覺化圖形。透過視覺化儀表板，您可以尋找使用者行為隨時間變化的趨勢或模式，或搜尋應用程式組態的表面問題。例如，顯示每天一致查詢數量且穩定增加的折線圖可能表示採用率和用量增加。另一方面，突然下降可能表示存在必須調查的問題。

您可以使用這些指標在不同資料點之間建立連線，以解決使用者如何查詢資訊或探索商機的問題。例如，文件「AI 如何運作？」 是搜尋結果中最點選的文件，而最熱門的搜尋查詢是「機器學習如何運作？」。這會通知您使用者使用的偏好術語和語言。您可以在文件中整合這些術語，或使用這些術語的自訂同義詞，讓您的文件更容易搜尋您的使用者。

## 搜尋的指標
<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`。您也可以在導覽面板上選取**分析**，在主控台中檢視此指標。

### 零點擊率
<a name="search-zero-click-through-rate"></a>

在搜尋結果中導致零次點按的查詢比例。這可協助您了解內容中的差距，以提供不相關的搜尋結果。對於傳回即時答案的查詢，使用者可能不需要按一下 文件以取得詳細資訊。如需詳細資訊，請參閱[即時回答率](#search-instant-answer-rate)。此外，調校組態等搜尋設定可能會影響搜尋結果中傳回文件的方式。

若要使用 `GetSnapshots` API 在零點擊率上擷取資料，請將 指定`metricType`為 `AGG_QUERY_DOC_METRICS`。您也可以在導覽面板上選取**分析**，在主控台中檢視此指標。

### 零搜尋結果率
<a name="search-zero-results-rate"></a>

導致零搜尋結果的查詢比例。這可協助您了解內容中的差距，不提供相關的搜尋結果。

若要使用 `GetSnapshots` API 擷取零搜尋結果率上的資料，請將 指定`metricType`為 `AGG_QUERY_DOC_METRICS`。您也可以在導覽面板上選取**分析**，在主控台中檢視此指標。

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

傳回即時回答或常見問答集的查詢比例。這可協助您了解即時答案在提供資訊中的角色。

若要使用 `GetSnapshots` API 擷取即時回答率上的資料，請將 指定`metricType`為 `AGG_QUERY_DOC_METRICS`。您也可以在導覽面板上選取**分析**，在主控台中檢視此指標。

### 熱門查詢
<a name="search-top-queries"></a>

使用者搜尋的前 100 個查詢。這可協助您了解哪些查詢很熱門，以及使用者最感興趣的資訊類型。

指標包括查詢搜尋的次數、文件的點擊率、文件的無點擊率、查詢搜尋結果中的平均點擊深度、查詢的即時答案比例，以及查詢前 10 個搜尋結果的平均可信度。

若要使用 `GetSnapshots` API 擷取熱門查詢上的資料，請將 指定`metricType`為 `QUERIES_BY_COUNT`。您也可以在主控台的導覽面板上選取**分析**，然後選取**查詢清單**下的**熱門查詢**，以在主控台中檢視此指標。

### 點按零次的熱門查詢
<a name="search-top-queries-zero-clicks"></a>

在搜尋結果中導致零點選的前 100 個查詢。這可協助您了解內容中的任何差距，其中缺少與某些查詢相關的文件，或您的搜尋應用程式組態傳回不相關的搜尋結果。對於傳回即時答案的查詢，使用者可能不需要按一下 文件以取得詳細資訊。如需詳細資訊，請參閱[即時回答率](#search-instant-answer-rate)。

指標包括查詢導致零次點擊的次數、查詢零次點擊的比例、查詢的即時答案比例，以及查詢前 10 個搜尋結果的平均可信度。

若要使用 `GetSnapshots` API 以零次點擊擷取熱門查詢上的資料，請將 指定`metricType`為 `QUERIES_BY_ZERO_CLICK_RATE`。您也可以在主控台的導覽面板上選取**分析**，然後在查詢**清單**下選取**前零次點選**查詢，以在主控台中檢視此指標。

### 零搜尋結果的熱門查詢
<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`。您也可以在主控台的導覽面板上選取**分析**，然後在**查詢清單**下選取**前零個結果查詢**，以在主控台中檢視此指標。

### 在文件上按一下
<a name="search-top-clicked-docs"></a>

搜尋結果中最多點擊的前 100 個文件。這可協助您了解在使用者查詢資訊時，哪些文件或搜尋結果與您的使用者最相關。

指標包括按一下文件的次數、從使用者收到的類似文件數量 （翻滾）、從使用者收到的不喜歡文件數量 （翻滾）。

若要使用 `GetSnapshots` API 在文件上按一下上方擷取資料，請將 指定`metricType`為 `DOCS_BY_CLICK_COUNT`。您也可以在主控台的導覽面板上選取**分析**，然後選取**查詢清單**下的**按一下前文件**，以在主控台中檢視此指標。

### 查詢總數
<a name="search-total-queries"></a>

您的使用者搜尋的查詢總數。這可協助您了解使用者與搜尋應用程式的參與度。

若要使用 `GetSnapshots` API 擷取總查詢上的資料，請將 指定`metricType`為 `AGG_QUERY_DOC_METRICS`。您也可以在導覽面板上選取**分析**，在主控台中檢視此指標。

### 文件總數
<a name="search-total-docs"></a>

索引中的文件總數。這可協助您比較索引的大小與查詢總數，以檢查查詢數量是否有適當的文件數量。

若要使用 `GetSnapshots` API 擷取總文件上的資料，請將 指定`metricType`為 `AGG_QUERY_DOC_METRICS`。您也可以在導覽面板上選取**分析**，在主控台中檢視此指標。

### 擷取指標資料的範例
<a name="retrieve-metric-data-example"></a>

下列程式碼是擷取上個月熱門查詢資料的範例。

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

**擷取上個月的熱門查詢**

1. 在左側導覽窗格中的**索引**下，選取您的索引，然後選取**分析**。

1. 在**分析**頁面上，選取**本週**按鈕，將擷取資料的時間範圍變更為**上個月**。

1. 在**分析**頁面的**查詢清單**下，選取**熱門查詢**。

------
#### [ 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% 的即時回答率。這表示您的使用者會收到此問題的答案，而不需要按一下提供可用區域資訊的搜尋結果或文件。如果您只查看零次點選，就無法取得完整案例，而且可能對您的搜尋應用程式組態在處理此查詢時是否成功做出錯誤的結論。

另一個可行洞見的範例是探索商機。企業通常會透過分析搜尋指標來尋找成長客戶的機會。最多點擊的文件是「可用區域」。此外，大多數最熱門的搜尋查詢都與 Oceanic 區域中產品可用性的問題有關，其 100% 的即時回答率和高點擊率可提供有關可用區域的詳細資訊，作為回答的一部分。這表示您在此區域的產品或服務具有興趣和需求。

## 視覺化和報告搜尋分析
<a name="search-visualizing-reporting"></a>

有五個指標包含趨勢資料，供您視覺化和尋找隨時間變化的趨勢或模式。如果您使用 主控台，則會提供趨勢資料的圖形。如果您使用 APIs，您可以擷取趨勢資料來建立自己的圖形或視覺化效果。主控台中的大多數圖形都會在您選擇的時段內繪製每日資料點。

主控台提供指標的儀表板，您可以在其中選取您有興趣檢視的圖形和頂端清單。您可以在**分析**首頁上選取**匯出**，以 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`。您可以使用資料來建立自己的圖形，或使用 主控台中提供的圖形。