Добавление аналитики в API-интерфейсы поиска BingAdd analytics to the Bing Search APIs

Статистика Bing предоставляет аналитику для API-интерфейсы поиска Bing.Bing Statistics provides analytics for the Bing Search APIs. К этим аналитикам относятся объем вызовов, основные строки запросов, географическое распределение и многое другое.These analytics include call volume, top query strings, geographic distribution, and more. Вы можете включить статистику Bing в портал Azure , перейдя к своему ресурсу 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.

На следующем рисунке показана доступная аналитика для каждой конечной точки API Поиск Bing.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. Убедитесь, что вы вошли с помощью того же учетная запись Майкрософт (MSA), который использовался для регистрации статистики Bing.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. Список содержит несколько идентификаторов, если вы подписаны на несколько уровней API поиска Bing.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.

  • Конечные точки. Конечные точки API-интерфейсов поиска Bing.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 не доступна для следующих конечных точек: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. Вызовы, выполненные извне браузера (например, программы-роботы, POST или с помощью функции «перелистывание» из консольного приложения), группируются в разделе библиотеки.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: 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.

  • Распределение по запрошенным ответам. Поиск в Интернете API отвечает на responseFilter запросы, запрошенные в параметре запроса.Answers Requested Distribution: The Web Search API answers that you requested in the responseFilter query parameter.

  • Распределение по возвращенным ответам. Ответы, которые 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). Сервер определяется с помощью значения заголовка 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