本頁說明如何查看推薦和搜尋應用程式的數據分析。
數據分析可讓您深入瞭解應用程式的使用趨勢、搜尋和建議功能的品質，以及使用者參與度。Vertex AI Search 控制台提供採用 Looker 技術的互動式資訊主頁。
- 媒體推薦應用程式：公開測試版。您可以查看以使用者事件為依據的個別建議指標。您可以依日期範圍和裝置類型篩選指標。
- 自訂搜尋和媒體搜尋應用程式：您可以根據搜尋記錄和使用者事件，查看個別搜尋指標和個別搜尋工作階段指標。您可以依日期範圍、查詢和裝置類型篩選指標。
- 醫療照護搜尋應用程式：公開測試。您可以根據搜尋記錄查看每次搜尋的指標。
指標大約每六小時更新一次，因此建立應用程式後，可能需要數小時才能使用「Analytics」頁面。
用於分析的資料來源
本節說明不同應用程式類型的數據分析資料來源。
您必須完成使用者事件整合，才能查看使用者事件分析資料。
您上傳的使用者事件會影響系統產生的數據分析。
媒體推薦應用程式需要下列使用者事件，才能查看部分指標：
- 查看商品事件。點閱率必須提供這項資訊。
- 媒體完整播放事件。播放完成率和推薦完成率皆須提供這項資料。
- 媒體播放事件。建議媒體播放次數、播放完成率、每次播放的完成率，以及每次播放的平均觀看時間。
搜尋應用程式需要下列使用者事件，才能查看部分指標：
- 搜尋活動。點閱率的必要條件。
- 查看商品事件。點閱率必須提供這項資訊。
以下資訊也會用於部分分析：
- 曝光次數。如要提供可歸因於 Vertex AI Search 的曝光次數 (項目瀏覽或點擊次數)，請在擷取使用者事件時，將相關項目納入
UserEvent.Documents。這項資訊是歸因和計算每次搜尋指標的必要條件。 - 歸因符記。出處權杖是 Vertex AI Search 產生的專屬 ID，會隨每次搜尋要求傳回。請務必在因搜尋而產生的任何使用者事件中，加入該歸因符記
UserEvent.attributionToken。這項資訊有助於判斷搜尋是否由 API 提供。系統只會使用具有 Google 產生歸因權杖的使用者事件來計算指標。 - 使用者代理程式：在使用者事件中加入
UserInfo.userAgent，即可依裝置類型篩選使用者事件指標。
搜尋記錄
搜尋應用程式會將搜尋記錄做為部分指標的資料來源。
搜尋記錄是根據搜尋要求產生，為讓 Vertex AI Search 識別使用者工作階段，以便提供工作階段分析資料和更高品質的搜尋結果，Google 強烈建議您設定選用欄位 userPseudoId。
如果目前沒有任何搜尋記錄或使用者事件，所有指標都會顯示預設值。
查看媒體推薦內容的數據分析
請按照下列說明查看媒體建議的數據分析。
前往 Google Cloud 控制台的「AI Applications」頁面。
按一下要查看數據分析的應用程式名稱。
按一下「數據分析」。
如要篩選指標，請指定下列任一篩選條件，然後按一下「重新整理」按鈕套用篩選條件：
- 日期範圍：選取預設日期範圍，或輸入自訂日期範圍 (如有)。
- 裝置類型。選取發生查詢的裝置類型。
查看搜尋數據分析
請按照下列說明查看搜尋應用程式的數據分析。
前往 Google Cloud 控制台的「AI Applications」頁面。
按一下要查看數據分析的應用程式名稱。
按一下「數據分析」。
按一下分頁標籤，即可查看該指標群組：
- 每次搜尋。指標會依搜尋查詢分組。如果是醫療照護資料搜尋，這是唯一可用的指標群組。
- 每個工作階段。指標會依搜尋工作階段分組。
- 比較。基準指標會與比較期間的指標一併顯示。選取基準指標的日期範圍 (較早的時間範圍) 和比較指標的日期範圍 (較晚的時間範圍)。這些時間範圍不得重疊。
如要篩選指標，請指定篩選器，然後按一下「重新整理」按鈕套用篩選器。
媒體應用程式和自訂搜尋應用程式可使用下列篩選器：
- 日期範圍：選取預設日期範圍，或輸入自訂日期範圍 (如有)。
- 搜尋查詢。選取條件和搜尋查詢值。你可以新增多個搜尋查詢篩選器。適用於「每次搜尋」和「比較」指標。
- 裝置類型。選取發生查詢的裝置類型。
醫療照護搜尋應用程式可使用下列篩選器：
- 日期範圍：選取預設日期範圍，或輸入自訂日期範圍 (如有)。如果您為自訂日期範圍選取特定日期，該日期就是搜尋發生時的 UTC -08:00 時區日期。
- 搜尋查詢。選取條件和搜尋查詢值。您可以新增多個搜尋查詢篩選器。
- 使用者位置。選取搜尋要求中設定的醫院、診所或醫療服務供應商位置。只有在搜尋要求中設定了這項篩選條件，才能使用。
- 使用者角色。選取傳送搜尋要求的使用者職類。只有在搜尋要求中設定了這項篩選條件，才能使用。
- 使用者設定。選取搜尋要求中設定的醫療照護環境，例如住院、門診或混合治療。只有在搜尋要求中設定了這項篩選條件，才能使用。
指標定義
下表說明指標的定義。
媒體推薦指標
| 指標名稱 | 指標定義 | 附註 |
|---|---|---|
| 建議數量 | 建議總數 | |
| 推薦播放次數 | 建議媒體項目的播放次數 | |
| 建議點擊次數 | 建議媒體項目的點擊次數 | |
| 點閱率 | 最佳化建議點擊次數 / 最佳化建議數量 | 建議點擊次數是指可歸因於建議的查看項目事件 |
| 建議媒體完成次數 | 推薦媒體項目完整播放的次數 | |
| 每項建議的播放率 | 建議媒體項目播放次數 / 建議次數 | |
| 每次播放的播放完成率 | 建議媒體項目播放完畢的次數 / 媒體項目播放次數 | |
| 每次播放的平均觀看時間 | 建議媒體項目播放時間 (以秒為單位) / 建議媒體項目播放次數 | |
| 每項建議的完成率 | 媒體項目播放完畢的次數 / 建議次數 | |
| 每項建議的平均觀看時間 | 建議媒體項目觀看時間 (以秒為單位) / 建議次數 |
媒體和自訂搜尋指標
| 指標名稱 | 指標定義 | 附註 |
|---|---|---|
| 搜尋次數 | 搜尋事件數 | 根據搜尋記錄。 |
| 無結果率 | 沒有結果的搜尋事件數量 / 搜尋次數 | 根據搜尋記錄。 |
| 每次搜尋的點閱率 (CTR) | 搜尋點擊次數/搜尋次數 | 搜尋點擊次數是指可歸因於先前搜尋事件的查看項目事件。根據使用者事件。 |
| 喜歡和不喜歡的意見回饋數量 | 喜歡和不喜歡的次數 | 應用程式使用者傳送的「喜歡」/「不喜歡」意見回饋記錄。 |
| Feedback dislike reasons breakdown | 不喜歡原因的百分比 | 使用者不喜歡生成的答案時，可以選取多個原因來說明不喜歡的原因。百分比會顯示每個原因的選取頻率。 |
| 搜尋工作階段次數 | 搜尋工作階段次數 | 搜尋工作階段是包含至少一個搜尋事件的 使用者工作階段 。使用者工作階段 (又稱「造訪」) 是指使用者事件的連續集合。閒置 30 分鐘後，工作階段就會結束。根據搜尋記錄。 |
| 每次搜尋/造訪的網頁瀏覽次數 | 搜尋工作階段中的 view_item 事件數 / 搜尋工作階段數 | 這項指標會納入搜尋造訪中的所有網頁瀏覽次數，無論這些瀏覽次數是否可歸因於 Vertex AI Search。根據使用者事件。 |
| 跳出率 | 搜尋工作階段中的跳出次數 / 搜尋工作階段數 | 搜尋工作階段跳出是指只有一次搜尋的工作階段，使用者在搜尋一次後就離開。根據使用者事件。 |
醫療照護搜尋指標
醫療照護搜尋應用程式可使用下列搜尋指標。
| 指標名稱 | 指標定義 | 附註 |
|---|---|---|
| 搜尋次數 | 搜尋事件數 | |
| 沒有結果計數 | 沒有結果的搜尋事件數量 | |
| 每次搜尋的無結果率 | 每個搜尋事件的無結果搜尋事件數量 | |
| 病患人數 | 已搜尋的病患 ID 數量 | 系統會針對每位搜尋使用者進行重複資料刪除，但不會針對每位病患進行這項操作。舉例來說，如果使用者 1 搜尋病患 A 和 B，而使用者 2 只搜尋病患 B，則計數為 3。 |
| 顧客搜尋工作階段數 | 搜尋使用者定義工作階段數 | 您可以在搜尋中傳送工作階段 ID。
詳情請參閱「session」。 |
| 搜尋訪客人數 | 傳送搜尋要求的使用者人數 | 系統會根據「userInfo」欄位計算使用者人數。 |
| 合成搜尋工作階段計數 | Google 定義的搜尋工作階段數 | 搜尋工作階段是包含至少一個搜尋事件的 使用者工作階段 。使用者工作階段 (又稱「造訪」) 是指使用者事件的連續集合。閒置 30 分鐘後，工作階段就會結束。 |
關閉數據分析功能
您無法為現有應用程式關閉 Analytics，但建立應用程式時，可以選擇關閉 Analytics。
如要建立不會收集分析資料的搜尋應用程式，請按照下列步驟操作：
按照「建立搜尋應用程式」中的 REST 指示操作，並在 curl 指令中加入下列內容：
"disableAnalytics": true