Adicionar análise ao APIs de Pesquisa do BingAdd analytics to the Bing Search APIs

As estatísticas do Bing fornecem análises para o APIs de Pesquisa do Bing.Bing Statistics provides analytics for the Bing Search APIs. Essas análises incluem o volume de chamada, as principais cadeias de caracteres de consulta, a distribuição geográfica e muito mais.These analytics include call volume, top query strings, geographic distribution, and more. Você pode habilitar as estatísticas do Bing no portal do Azure navegando até o recurso do Azure e clicando em habilitar estatísticas do Bing.You can enable Bing Statistics in the Azure portal by navigating to your Azure resource and clicking Enable Bing Statistics.

Importante

  • As estatísticas do Bing não estão disponíveis com assinaturas de avaliação gratuitas ou recursos no tipo F0 de preço gratuito.Bing Statistics is not available with free trial subscriptions, or resources on the free F0 pricing tier.
  • Não é possível usar dados disponíveis por meio do painel das Estatísticas do Bing para criar aplicativos para distribuição a terceiros.You may not use any data available via the Bing Statistics dashboard to create applications for distribution to third parties.
  • A habilitação das estatísticas do Bing aumenta um pouco sua taxa de assinatura.Enabling Bing Statistics increases your subscription rate slightly. Consulte os preços para obter detalhes.See pricing for details.

A imagem a seguir mostra a análise disponível para cada ponto de extremidade de API Pesquisa do Bing.The following image shows the available analytics for each Bing Search API endpoint.

Distribuição por matriz de suporte de ponto de extremidade

Acessar sua análiseAccess your analytics

O Bing atualiza dados de análise a cada 24 horas e mantém um histórico de até 13 meses que você pode acessar por meio do painel de análise.Bing updates analytics data every 24 hours and maintains up to 13 months' worth of history that you can access from the analytics dashboard. Verifique se você está conectado usando o mesmo conta Microsoft (MSA) usado para se inscrever nas estatísticas do Bing.Make sure you're signed in using the same Microsoft account (MSA) you used to sign up for Bing Statistics.

Observação

  • Pode demorar até 24 horas para que as métricas apareçam no painel.It may take up to 24 hours for metrics to surface on the dashboard. O painel mostra a data e hora em que os dados foram atualizados pela última vez.The dashboard shows the date and time the data was last updated.
  • As métricas estarão disponíveis a partir do momento que você habilitar o suplemento de Estatísticas do Bing.Metrics are available from the time you enable the Bing Statistics Add-in.

Filtrar os dadosFilter the data

Por padrão, os gráficos exibem todas as métricas e os dados aos quais você tem acesso.By default, the charts and graphs display all metrics and data that you have access to. É possível filtrar os dados mostrados nos gráficos e grafos, selecionando os recursos, mercados, pontos de extremidade e período de relatório nos quais está interessado.You can filter the data shown in the charts and graphs by selecting the resources, markets, endpoints, and reporting period you're interested in. Você pode alterar os seguintes filtros:You can change the following filters:

  • ID do recurso: a ID exclusiva do recurso que identifica a assinatura do Azure.Resource ID: The unique resource ID that identifies your Azure subscription. Se você assinar mais de uma camada de API de Pesquisa do Bing, a lista conterá várias IDs.The list contains multiple IDs if you subscribe to more than one Bing Search API tier. Por padrão, todos os recursos são selecionados.By default, all resources are selected.

  • Mercados: os mercados de onde vêm os resultados.Markets: The markets where the results come from. Por exemplo, en-us (inglês, Estados Unidos).For example, en-us (English, United States). Por padrão, todos os mercados são selecionados.By default, all markets are selected. O en-WW mercado é o mercado que o Bing usa se a chamada não especificar um mercado e o Bing não puder determinar o mercado do usuário.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.

  • Pontos de extremidade: os pontos de extremidade de API de Pesquisa do Bing.Endpoints: The Bing Search API endpoints. A lista contém todos os pontos de extremidade para os quais você tem uma assinatura paga.The list contains all endpoints for which you have a paid subscription. Por padrão, todos os pontos de extremidade são selecionados.By default, all endpoints are selected.

  • Período: o período do relatório.Time Frame: The reporting period. É possível especificar:You can specify:

    • Todas: Inclui um valor de dados de até 13 mesesAll: Includes up to 13 months' worth of data
    • Últimas 24 horas: Inclui análise das últimas 24 horasPast 24 hours: Includes analytics from the last 24 hours
    • Última semana: Inclui análise dos sete dias anterioresPast week: Includes analytics from the previous seven days
    • Mês passado: Inclui análise dos últimos 30 diasPast month: Includes analytics from the previous 30 days
    • Um intervalo de datas personalizado: Inclui a análise do intervalo de datas especificado, se disponívelA custom date range: Includes analytics from the specified date range, if available

Gráficos e grafosCharts and graphs

O painel mostra gráficos e grafos das métricas disponíveis para o ponto de extremidade selecionado.The dashboard shows charts and graphs of the metrics available for the selected endpoint. Nem todas as métricas estão disponíveis para todos os pontos de extremidade.Not all metrics are available for all endpoints. Os gráficos e grafos de cada ponto de extremidade são estáticos (não é possível selecionar os gráficos e grafos a serem exibidos).The charts and graphs for each endpoint are static (you may not select the charts and graphs to display). O painel mostra apenas gráficos e grafos para os quais há dados.The dashboard shows only charts and graphs for which there's data.

A seguir estão as possíveis métricas e restrições de ponto de extremidade.The following are possible metrics and endpoint restrictions.

  • Volume de chamadas: mostra o número de chamadas feitas durante o período do relatório.Call Volume: Shows the number of calls made during the reporting period. Se o período do relatório for de um dia, o gráfico mostrará o número de chamadas feitas por hora.If the reporting period is for a day, the chart shows the number of calls made per hour. Caso contrário, o gráfico mostra o número de chamadas feitas por dia do período do relatório.Otherwise, the chart shows the number of calls made per day of the reporting period.

    Observação

    O volume de chamadas pode diferir dos relatórios de cobrança, que geralmente incluem apenas chamadas com êxito.The call volume may differ from billing reports, which generally includes only successful calls.

  • Principais consultas: mostra as principais consultas e o número de ocorrências de cada consulta durante o período do relatório.Top Queries: Shows the top queries and the number of occurrences of each query during the reporting period. É possível configurar o número de consultas mostradas.You can configure the number of queries shown. Por exemplo, é possível mostrar as 25, 50 ou 75 principais consultas.For example, you can show the top 25, 50, or 75 queries. As principais consultas não estão disponíveis para os pontos de extremidade a seguir: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

    Observação

    Alguns termos de consulta podem ser suprimidos para remover informações confidenciais, como emails, números de telefone, SSN etc.Some query terms may be suppressed to remove confidential information such as emails, telephone numbers, SSN, etc.

  • Distribuição geográfica: Os mercados nos quais os resultados da pesquisa se originam.Geographic Distribution: The markets where search results originate. Por exemplo, en-us (Inglês, Estados Unidos).For example, en-us (English, United States). O Bing usa o parâmetro de consulta mkt para determinar o mercado, se especificado.Bing uses the mkt query parameter to determine the market, if specified. Caso contrário, o Bing usa sinais como o endereço IP do chamador para determinar o mercado.Otherwise, Bing uses signals such as the caller's IP address to determine the market.

  • Distribuição do código de resposta: os códigos de status HTTP de todas as chamadas durante o período do relatório.Response Code Distribution: The HTTP status codes of all calls during the reporting period.

  • Distribuição de origem das chamadas: os tipos de navegadores usados pelos usuários.Call Origin Distribution: The types of browsers used by the users. Por exemplo, Microsoft Edge, Chrome, Safari e FireFox.For example, Microsoft Edge, Chrome, Safari, and FireFox. As chamadas feitas de fora de um navegador (como bots, postmaster ou uso de ondulação de um aplicativo de console) são agrupadas em bibliotecas.Calls made from outside a browser (such as bots, Postman, or using curl from a console app) are grouped under Libraries. A origem é determinada usando o valor do cabeçalho do Agente do Usuário da solicitação.The origin is determined using the request's User-Agent header value. Se a solicitação não incluir o cabeçalho do Agente do Usuário, o Bing tentará derivar a origem de outros sinais.If the request doesn't include the User-Agent header, Bing tries to derive the origin from other signals.

  • Distribuição de pesquisa segura: a distribuição de valores de pesquisa segura.Safe Search Distribution: The distribution of safe search values. Por exemplo, desativado, moderado ou estrito.For example, off, moderate, or strict. O parâmetro de consulta safeSearch contém o valor, se especificado.The safeSearch query parameter contains the value, if specified. Caso contrário, o Bing padroniza o valor para moderado.Otherwise, Bing defaults the value to moderate.

  • Distribuição de respostas solicitadas: O pesquisa na Web API responde que você solicitou no responseFilter parâmetro de consulta.Answers Requested Distribution: The Web Search API answers that you requested in the responseFilter query parameter.

  • Distribuição de respostas retornadas: as respostas que a API de Pesquisa na Web retornou na resposta.Answers Returned Distribution: The answers that Web Search API returned in the response.

  • Distribuição do servidor de resposta: o servidor de aplicativos que atendeu as solicitações de API.Response Server Distribution: The application server that served your API requests. Os valores possíveis são Bing.com (para tráfego veiculado em dispositivos de desktop e laptop) e Bing.com-mobile (para tráfego veiculado em dispositivos móveis).The possible values are Bing.com (for traffic served from desktop and laptop devices) and Bing.com-mobile (for traffic served from mobile devices). O servidor é determinado usando o valor do cabeçalho do Agente do Usuário da solicitação.The server is determined using the request's User-Agent header value. Se a solicitação não incluir o cabeçalho do Agente do Usuário, o Bing tentará derivar o servidor de outros sinais.If the request doesn't include the User-Agent header, Bing tries to derive the server from other signals.

Próximas etapasNext steps