將分析新增至 Bing 搜尋 ApiAdd analytics to the Bing Search APIs

Bing 統計資料可為 Bing 搜尋 Api 提供分析。Bing Statistics provides analytics for the Bing Search APIs. 這些分析包括呼叫量、熱門查詢字串、地理分佈等等。These analytics include call volume, top query strings, geographic distribution, and more. 您可以流覽至您的 Azure 資源,然後按一下 [啟用 Bing 統計資料],以在Azure 入口網站中啟用 Bing 統計資料。You can enable Bing Statistics in the Azure portal by navigating to your Azure resource and clicking Enable Bing Statistics.

重要

  • Bing 統計資料不適用於免費試用訂用帳戶,或免費F0定價層的資源。Bing Statistics is not available with free trial subscriptions, or resources on the free F0 pricing tier.
  • 您可能無法使用透過 Bing 統計資料儀表板提供的任何資料,來建立向第三方散發的應用程式。You may not use any data available via the Bing Statistics dashboard to create applications for distribution to third parties.
  • 啟用 Bing 統計資料會稍微增加您的訂用帳戶速率。Enabling Bing Statistics increases your subscription rate slightly. 如需詳細資訊,請參閱定價See pricing for details.

下圖顯示每個 Bing 搜尋 API 端點的可用分析。The following image shows the available analytics for each Bing Search API endpoint.

依端點支援矩陣的分佈情況

存取您的分析Access your analytics

Bing 會每隔24小時更新一次分析資料,最多可維護13個月的歷程記錄,讓您可以從分析儀表板存取。Bing updates analytics data every 24 hours and maintains up to 13 months' worth of history that you can access from the analytics dashboard. 請確定您已使用用來註冊 Bing 統計資料的相同 Microsoft 帳戶(MSA)登入。Make sure you're signed in using the same Microsoft account (MSA) you used to sign up for Bing Statistics.

注意

  • 計量最多可能需要 24 小時才會呈現在儀表板上。It may take up to 24 hours for metrics to surface on the dashboard. 儀表板會顯示上次更新資料的時間與日期。The dashboard shows the date and time the data was last updated.
  • 從啟用 Bing 統計資料增益集起,就可以取得計量。Metrics are available from the time you enable the Bing Statistics Add-in.

篩選資料Filter the data

根據預設,圖表和圖表會顯示您有權存取的所有計量和資料。By default, the charts and graphs display all metrics and data that you have access to. 您可以選取資源、市場、端點,以及感興趣的報告週期,以篩選圖表與圖形中所顯示的資料。You can filter the data shown in the charts and graphs by selecting the resources, markets, endpoints, and reporting period you're interested in. 您可以變更下列篩選準則:You can change the following filters:

  • 資源識別碼:可識別 Azure 訂用帳戶的唯一資源識別碼。Resource ID: The unique resource ID that identifies your Azure subscription. 如果您訂閱一個以上的 Bing 搜尋 API 層,此清單會包含多個識別碼。The list contains multiple IDs if you subscribe to more than one Bing Search API tier. 預設會選取所有資源。By default, all resources are selected.

  • 市場:結果來自的市場。Markets: The markets where the results come from. 例如,en-US (英文,美國)。For example, en-us (English, United States). 預設會選取所有市場。By default, all markets are selected. en-WW市場是 bing 使用的市場,如果電話未指定市場,而且 bing 無法判斷使用者的市場。The en-WW market is the market that Bing uses if the call does not specify a market and Bing is unable to determine the user's market.

  • 端點:Bing 搜尋 API 端點。Endpoints: The Bing Search API endpoints. 此清單包含您有付費訂用帳戶的所有端點。The list contains all endpoints for which you have a paid subscription. 預設會選取所有端點。By default, all endpoints are selected.

  • 時間範圍:報告期間。Time Frame: The reporting period. 您可以指定:You can specify:

    • 全部:包含最多13個月的資料All: Includes up to 13 months' worth of data
    • 過去24小時:包含過去24小時內的分析Past 24 hours: Includes analytics from the last 24 hours
    • 過去一周:包含前七天的分析Past week: Includes analytics from the previous seven days
    • 個月:包括過去30天內的分析Past month: Includes analytics from the previous 30 days
    • 自訂日期範圍:包含來自指定日期範圍的分析(如果有的話)A custom date range: Includes analytics from the specified date range, if available

圖表和圖形Charts and graphs

儀表板會顯示所選端點可用計量的圖表和圖形。The dashboard shows charts and graphs of the metrics available for the selected endpoint. 並非所有端點都能取得所有計量。Not all metrics are available for all endpoints. 每個端點的圖表和圖形都是靜態的 (您無法選取要顯示的圖表和圖表)。The charts and graphs for each endpoint are static (you may not select the charts and graphs to display). 儀表板只會顯示有資料可用的圖表和圖形。The dashboard shows only charts and graphs for which there's data.

以下是可能的計量和端點限制。The following are possible metrics and endpoint restrictions.

  • 呼叫量:顯示在報告期間發出的呼叫次數。Call Volume: Shows the number of calls made during the reporting period. 如果報告期間為一天,圖表會顯示每小時發出的呼叫次數。If the reporting period is for a day, the chart shows the number of calls made per hour. 否則,圖表會顯示報告期間內每日發出的呼叫次數。Otherwise, the chart shows the number of calls made per day of the reporting period.

    注意

    呼叫量可能會和帳單報告有所不同,帳單報告通常只包括成功的呼叫。The call volume may differ from billing reports, which generally includes only successful calls.

  • 熱門查詢:顯示報告期間內的熱門查詢,以及每個查詢的發生次數。Top Queries: Shows the top queries and the number of occurrences of each query during the reporting period. 您可以設定顯示的查詢數目。You can configure the number of queries shown. 例如,您可以顯示前 25、50 或 75 個查詢。For example, you can show the top 25, 50, or 75 queries. 熱門查詢不適用於下列端點:Top Queries is not available for the following endpoints:

    • /images/trending/images/trending
    • /images/details/images/details
    • /images/visualsearch/images/visualsearch
    • /videos/trending/videos/trending
    • /videos/details/videos/details
    • /news/news
    • /news/trendingtopics/news/trendingtopics
    • /suggestions/suggestions

    注意

    某些查詢詞彙可能隱藏起來以移除機密資訊,例如電子郵件、電話號碼、SSN 等。Some query terms may be suppressed to remove confidential information such as emails, telephone numbers, SSN, etc.

  • 地理分佈:搜尋結果的來源市場。Geographic Distribution: The markets where search results originate. 例如, en-us (英文,美國)。For example, en-us (English, United States). Bing 使用 mkt 查詢參數來判斷市場 (如果指定的話)。Bing uses the mkt query parameter to determine the market, if specified. 否則,Bing 會使用訊號 (例如呼叫端的 IP 位址) 來判斷市場。Otherwise, Bing uses signals such as the caller's IP address to determine the market.

  • 回應碼分佈:在報告期間內所有呼叫的 HTTP 狀態碼。Response Code Distribution: The HTTP status codes of all calls during the reporting period.

  • 呼叫來源分佈:使用者使用的瀏覽器類型。Call Origin Distribution: The types of browsers used by the users. 例如,Microsoft Edge、Chrome、Safari 及 FireFox。For example, Microsoft Edge, Chrome, Safari, and FireFox. 從瀏覽器外部(例如 bot、Postman 或從主控台應用程式使用捲曲)所進行的呼叫,會在 [程式庫] 底下分組。Calls made from outside a browser (such as bots, Postman, or using curl from a console app) are grouped under Libraries. 來源是使用要求的使用者代理程式標頭值來判斷的。The origin is determined using the request's User-Agent header value. 如果要求不包含使用者代理程式標頭,Bing 就會嘗試從其他訊號衍生來源。If the request doesn't include the User-Agent header, Bing tries to derive the origin from other signals.

  • 安全搜尋分佈:安全搜尋值的分佈。Safe Search Distribution: The distribution of safe search values. 例如,關閉、中等或嚴格。For example, off, moderate, or strict. safeSearch 查詢參數會包含值 (如果指定的話)。The safeSearch query parameter contains the value, if specified. 否則,Bing 會預設該值為中等。Otherwise, Bing defaults the value to moderate.

  • 要求的散發套件:您在responseFilter查詢參數中要求的 Web 搜尋 API 答案。Answers Requested Distribution: The Web Search API answers that you requested in the responseFilter query parameter.

  • 傳回的答案分佈:Web 搜尋 API 在回應中傳回的答案。Answers Returned Distribution: The answers that Web Search API returned in the response.

  • 回應伺服器分佈:處理 API 要求的應用程式伺服器。Response Server Distribution: The application server that served your API requests. 可能的值為 Bing.com (針對從桌上型與膝上型電腦裝置提供的流量) 和 Bing.com-mobile (針對從行動裝置提供的流量)。The possible values are Bing.com (for traffic served from desktop and laptop devices) and Bing.com-mobile (for traffic served from mobile devices). 伺服器是使用要求的使用者代理程式標頭值來判斷的。The server is determined using the request's User-Agent header value. 如果要求不包含使用者代理程式標頭,Bing 會嘗試從其他訊號衍生伺服器。If the request doesn't include the User-Agent header, Bing tries to derive the server from other signals.

後續步驟Next steps