查看分析資料

本頁面說明如何查看推薦內容和搜尋應用程式的數據分析。

數據分析可讓您深入瞭解應用程式的使用趨勢、搜尋和推薦功能品質，以及最終使用者的參與度。AI 應用程式控制台提供採用 Looker 技術的互動式資訊主頁體驗。

• 媒體推薦應用程式：公開測試版。您可以查看根據使用者事件計算的個別推薦指標。您可以依據日期範圍和裝置類型篩選指標。
• 自訂搜尋和媒體搜尋應用程式：您可以根據搜尋記錄和使用者事件，查看個別搜尋和個別搜尋工作階段的指標。您可以依據日期範圍、查詢和裝置類型篩選指標。
• 醫療照護搜尋應用程式：公開測試。您可以根據搜尋記錄查看個別搜尋的指標。

指標會每六小時更新一次，因此建立應用程式後，您可能需要等待幾個小時才能使用「Analytics」頁面。

數據分析的資料來源

本節說明分析資料來源，並依應用程式類型而異。

您必須完成使用者事件整合，才能查看使用者事件分析資料。

您上傳的使用者事件會影響產生的分析資料。

媒體推薦應用程式需要下列使用者事件才能查看部分指標：

• View-item 事件點閱率的必要屬性。
• 媒體完成事件。必須提供每次播放的完成率和每項推薦的完成率。
• 媒體播放事件。這是推薦媒體播放次數、播放完率、每次播放的完成率和平均觀看時間的必要參數。

搜尋應用程式需要下列使用者事件才能查看部分指標：

• 搜尋事件：點閱率的必要屬性。
• View-item 事件點閱率的必要屬性。

以下資訊也會用於部分數據分析：

• 曝光次數。您可以在擷取使用者事件時，在 UserEvent.Documents 中加入相關項目，藉此提供可歸因於 Vertex AI Search 的曝光次數 (項目瀏覽或點擊)。這項資訊是歸因和計算每項搜尋指標所需。
• 歸因符記。歸因權杖是 Vertex AI Search 產生的專屬 ID，並會隨每個搜尋要求傳回。請務必將歸因符記納入 UserEvent.attributionToken，並與任何搜尋結果的使用者事件搭配使用。這項屬性可用於判斷 API 是否提供搜尋結果。只有含有 Google 產生歸因權杖的使用者事件才會用於計算指標。
• 使用者代理程式：將 UserInfo.userAgent 與使用者事件一併納入，以便依裝置類型篩選使用者事件指標。

搜尋記錄

搜尋應用程式會使用搜尋記錄做為部分指標的資料來源。

搜尋記錄是根據搜尋要求產生。為了讓 AI 應用程式能夠識別使用者工作階段，進而提供每個工作階段的分析資料和更高品質的搜尋結果，Google 強烈建議您設定選用欄位 SearchRequest.UserPseudoId。

如果尚未有任何搜尋記錄或使用者事件，所有指標都會顯示預設值。

查看媒體推薦分析

請按照下列說明查看媒體推薦的數據分析。

1. 前往 Google Cloud 控制台的「AI Applications」頁面。

   AI 應用程式

2. 按一下要查看數據分析的應用程式名稱。

3. 按一下「數據分析」。

4. 如要篩選指標，請指定下列任一篩選器，然後按一下「Refresh」按鈕套用篩選器：

   • 日期範圍。選取預設日期範圍，或輸入自訂日期範圍 (如果可用)。
   • 裝置類型。選取發生查詢的裝置類型。

查看搜尋數據分析

請按照下列操作說明，查看搜尋應用程式的數據分析。

1. 前往 Google Cloud 控制台的「AI Applications」頁面。

   AI 應用程式

2. 按一下要查看數據分析的應用程式名稱。

3. 按一下「數據分析」。

4. 按一下分頁標籤即可查看該指標群組：

   • 單次搜尋。指標會依搜尋項目分組。醫療照護資料搜尋功能僅提供這個指標群組。
   • 每個工作階段。指標會依搜尋工作階段分組。
   • 比較。基準指標會與比較期間的指標一併顯示。選取基準指標 (較早的時間範圍) 和比較指標 (較晚的時間範圍) 的日期範圍。這些時間範圍不得重疊。

5. 如要篩選指標，請指定篩選器，然後按一下「重新整理」按鈕套用篩選器。

   媒體應用程式和自訂搜尋應用程式可使用下列篩選器：

   • 日期範圍。選取預設日期範圍，或輸入自訂日期範圍 (如果可用)。
   • 搜尋查詢。選取條件和搜尋查詢值。您可以新增多個搜尋查詢篩選器。適用於「每個搜尋」和「比較」指標。
   • 裝置類型。選取發生查詢的裝置類型。

   醫療照護搜尋應用程式可使用下列篩選器：

   • 日期範圍。選取預設日期範圍，或輸入自訂日期範圍 (如果可用)。選取自訂日期範圍的特定日期時，該日期是指 UTC-08:00 時區的搜尋日期。
   • 搜尋查詢。選取條件和搜尋查詢值。您可以新增多個搜尋查詢篩選器。
   • 使用者位置。選取搜尋要求中設定的醫院、診所或醫療服務供應商位置。只有在搜尋要求中設定此篩選器時，才能使用。
   • 使用者角色。選取傳送搜尋要求的使用者工作類別。只有在搜尋要求中設定此篩選器時，才能使用。
   • 使用者設定。選取搜尋要求中設定的醫療照護設定，例如住院、門診或混合式治療。只有在搜尋要求中設定此篩選器時，才能使用。

指標定義

下表說明指標的定義方式。

媒體推薦指標

指標名稱	指標定義	附註
最佳化建議數量	推薦內容總數
推薦內容播放次數	推薦媒體項目的播放次數
推薦內容點擊次數	建議媒體項目的點擊次數
點閱率	推薦點擊次數 / 推薦次數	「推薦點擊」是指可歸因於推薦內容的「查看項目」事件
推薦媒體完成次數	推薦媒體項目播放完畢的次數
每個推薦內容的播放完率	推薦媒體項目的播放次數 / 推薦次數
每次播放的完成率	推薦媒體項目播放完畢的次數 / 媒體項目播放次數
每次播放的平均觀看時間	推薦媒體項目的播放時間 (以秒為單位)/推薦媒體項目的播放次數
每項最佳化建議的完成率	媒體項目播放完畢的次數 / 推薦次數
每項推薦內容的平均觀看時間	觀看建議媒體項目的時間 (以秒為單位)/推薦次數

媒體和自訂搜尋指標

指標名稱	指標定義	附註
搜尋數	搜尋事件數	根據搜尋記錄。
無結果比率	沒有結果的搜尋事件數量/搜尋次數	根據搜尋記錄。
每項搜尋的點閱率 (CTR)	搜尋點擊次數 / 搜尋次數	搜尋點擊是指可歸因於先前搜尋事件的檢視項目事件。根據使用者事件。
意見回饋「喜歡」和「不喜歡」次數	按讚和按不喜歡的次數	記錄應用程式使用者傳送的讚/倒讚意見回饋回應。
不喜歡原因分析	不喜歡原因的百分比	使用者不喜歡系統產生的答案時，可以選取多個原因來說明不喜歡的原因。百分比代表每個原因的選取頻率。
搜尋工作階段計數	搜尋工作階段數量	搜尋工作階段是指至少包含一個搜尋事件的使用者工作階段。使用者工作階段 (也稱為「造訪」) 是一系列連續的使用者事件。閒置 30 分鐘後，工作階段就會結束。根據搜尋記錄。
每個搜尋瀏覽的網頁瀏覽次數	搜尋工作階段中的 View-Item 事件數量 / 搜尋工作階段數量	這項指標會納入搜尋造訪中的所有網頁瀏覽次數，無論是否可歸因於 Vertex AI Search 皆然。根據使用者事件。
跳出率	搜尋工作階段中的跳出次數 / 搜尋工作階段數	搜尋工作階段跳出率的定義為單一搜尋的工作階段，使用者只執行一次搜尋後就離開。根據使用者事件。

醫療照護搜尋指標

醫療照護搜尋應用程式可使用下列搜尋指標。

指標名稱	指標定義	附註
搜尋數	搜尋事件數
沒有結果計數	沒有結果的搜尋事件數量
每項搜尋的無結果比率	每項搜尋中沒有結果的搜尋事件數
病患人數	搜尋作業所涉及的病患 ID 數量	這項資料會依搜尋使用者進行去重，但不會依病患進行去重。舉例來說，如果使用者 1 搜尋病患 A 和 B，而使用者 2 只搜尋病患 B，則計數為三。
顧客搜尋工作階段數量	搜尋使用者定義的工作階段數量	您可以在搜尋中傳送工作階段 ID。詳情請參閱 session。
搜尋訪客人數	傳送搜尋要求的使用者人數	系統會根據 userInfo 欄位計算使用者。
合成搜尋工作階段計數	Google 定義的搜尋工作階段數	搜尋工作階段是指至少包含一個搜尋事件的使用者工作階段。使用者工作階段 (也稱為「造訪」) 是一系列連續的使用者事件。閒置 30 分鐘後，工作階段就會結束。

關閉數據分析

您無法為現有應用程式關閉 Analytics，但建立應用程式時，可以選擇關閉 Analytics。

如要建立不會收集分析資料的搜尋應用程式，請按照下列步驟操作：

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

   這個指令會建立不會收集搜尋分析資料的應用程式。