Bing Search API に分析を追加するAdd analytics to the Bing Search APIs

Bing Statistics は、Bing Search API に分析情報を提供します。Bing Statistics provides analytics for the Bing Search APIs. こうした分析には、呼び出しのボリューム、上位のクエリ文字列、地理的な分布などが含まれます。These analytics include call volume, top query strings, geographic distribution, and more. Azure portal で Bing Statistics を有効にするには、Azure リソースに移動し、 [Enable Bing Statistics](Bing Statisticsを有効にする) をクリックします。You can enable Bing Statistics in the Azure portal by navigating to your Azure resource and clicking Enable Bing Statistics.

重要

  • Bing Statistics は、無料試用版サブスクリプション、または無料の F0 価格レベルのリソースでは利用できません。Bing Statistics is not available with free trial subscriptions, or resources on the free F0 pricing tier.
  • Bing Statistics ダッシュボードで入手できるデータを使用して、サード パーティに配布するためのアプリケーションを作成することはできません。You may not use any data available via the Bing Statistics dashboard to create applications for distribution to third parties.
  • Bing Statistics を有効にすると、サブスクリプションの料金が少し上がります。Enabling Bing Statistics increases your subscription rate slightly. 詳細については、価格のページを参照してください。See pricing for details.

次の図は、各 Bing Search 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 Statistics のサインアップに使用したものと同じ 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 Statistics アドインを有効にした時点から利用できるようになります。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:

  • [リソース ID] : Azure サブスクリプションを識別する一意のリソース ID です。Resource ID: The unique resource ID that identifies your Azure subscription. 複数の Bing Search API 階層をサブスクライブしている場合、一覧には複数の ID が含まれます。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. 呼び出しに市場が指定されておらず、Bing がユーザーの市場を特定できない場合、en-WW 市場が 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 Search 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
    • 過去 1 週間:7 日前からの分析情報が含まれますPast week: Includes analytics from the previous seven days
    • 過去 1 か月: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](呼び出しボリューム) : レポート期間中に行われた呼び出しの数を示します。Call Volume: Shows the number of calls made during the reporting period. レポート期間が 1 日の場合、グラフには 1 時間ごとの呼び出し数が示されます。If the reporting period is for a day, the chart shows the number of calls made per hour. それ以外の場合、グラフにはレポート期間の 1 日ごとの呼び出し数が示されます。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](地理的分布) : 検索結果が生成される市場。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.

  • [Response Code Distribution](応答コード分布) : レポート期間中のすべての呼び出しの HTTP 状態コードです。Response Code Distribution: The HTTP status codes of all calls during the reporting period.

  • [Call Origin Distribution](呼び出し元分布) : ユーザーによって使用されたブラウザーの種類です。Call Origin Distribution: The types of browsers used by the users. たとえば、Microsoft Edge、Chrome、Safari、FireFox などです。For example, Microsoft Edge, Chrome, Safari, and FireFox. ブラウザーの外部からの呼び出し (ボット、Postman、コンソール アプリからの curl の使用など) は、[ライブラリ] にまとめられます。Calls made from outside a browser (such as bots, Postman, or using curl from a console app) are grouped under Libraries. 呼び出し元は、要求の User-Agent ヘッダーの値を使用して判断されます。The origin is determined using the request's User-Agent header value. 要求に User-Agent ヘッダーが含まれていない場合、Bing は他の信号から呼び出し元の特定を試みます。If the request doesn't include the User-Agent header, Bing tries to derive the origin from other signals.

  • [Safe Search Distribution](セーフ サーチの分布) : セーフ サーチの値の分布です。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. 指定されていない場合の既定値は中程度です。Otherwise, Bing defaults the value to moderate.

  • [Answers Requested Distribution](要求された回答の分布) : responseFilter クエリ パラメーターで要求した Web Search API の回答です。Answers Requested Distribution: The Web Search API answers that you requested in the responseFilter query parameter.

  • [Answers Returned Distribution](返された回答の分布) : Web Search API が応答で返した回答です。Answers Returned Distribution: The answers that Web Search API returned in the response.

  • [Response Server Distribution](応答サーバーの分布) : 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). サーバーは、要求の User-Agent ヘッダーの値を使用して判断されます。The server is determined using the request's User-Agent header value. 要求に User-Agent ヘッダーが含まれていない場合、Bing は他の信号からサーバーの特定を試みます。If the request doesn't include the User-Agent header, Bing tries to derive the server from other signals.

次の手順Next steps