Adicionar análises às APIs Pesquisa do Bing

  • Artigo

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

As Estatísticas do Bing fornecem análises para as APIs Pesquisa do Bing. Estas análises incluem o volume de chamadas, as principais cadeias de consulta, a distribuição geográfica e muito mais. Pode ativar as Estatísticas do Bing no portal do Azure ao navegar para o recurso do Azure e clicar em Ativar Estatísticas do Bing.

Importante

  • As Estatísticas do Bing não estão disponíveis com recursos no escalão de preço gratuito F0 .
  • Não pode utilizar quaisquer dados disponíveis através do dashboard estatísticas do Bing para criar aplicações para distribuição a terceiros.
  • Ativar as Estatísticas do Bing aumenta ligeiramente a taxa de subscrição. Veja os preços para obter detalhes.

A imagem seguinte mostra a análise disponível para cada ponto final da API Pesquisa do Bing.

Distribuição por matriz de suporte de ponto final

Aceder à sua análise

O Bing atualiza os dados de análise a cada 24 horas e mantém até 13 meses de histórico a que pode aceder a partir do dashboard de análise. Certifique-se de que iniciou sessão com a mesma conta Microsoft (MSA) que utilizou para se inscrever nas Estatísticas do Bing.

Nota

  • As métricas podem demorar até 24 horas a aparecer no dashboard. O dashboard mostra a data e hora em que os dados foram atualizados pela última vez.
  • As métricas estão disponíveis a partir do momento em que ativa o Suplemento de Estatísticas do Bing.

Filtrar os dados

Por predefinição, os gráficos e gráficos apresentam todas as métricas e dados a que tem acesso. Pode filtrar os dados apresentados nos gráficos e gráficos ao selecionar os recursos, mercados, pontos finais e período de relatórios em que está interessado. Pode alterar os seguintes filtros:

  • ID do Recurso: o ID de recurso exclusivo que identifica a sua subscrição do Azure. A lista contém vários IDs se subscrever mais do que um escalão de API Pesquisa do Bing. Por predefinição, todos os recursos estão selecionados.

  • Mercados: Os mercados de onde vêm os resultados. Por exemplo, en-us (inglês, Estados Unidos). Por predefinição, todos os mercados estão selecionados. O en-WW mercado é o mercado que o Bing utiliza se a chamada não especificar um mercado e o Bing não conseguir determinar o mercado do utilizador.

  • Pontos finais: os pontos finais da API Pesquisa do Bing. A lista contém todos os pontos finais para os quais tem uma subscrição paga. Por predefinição, todos os pontos finais estão selecionados.

  • Período de Tempo: o período de relatórios. Pode especificar:

    • Tudo: inclui até 13 meses de dados
    • Últimas 24 horas: Inclui análises das últimas 24 horas
    • Semana passada: Inclui análises dos 7 dias anteriores
    • Mês passado: Inclui análises dos 30 dias anteriores
    • Um intervalo de datas personalizado: inclui análises do intervalo de datas especificado, se disponível

Gráficos e gráficos

O dashboard mostra gráficos e gráficos das métricas disponíveis para o ponto final selecionado. Nem todas as métricas estão disponíveis para todos os pontos finais. Os gráficos para cada ponto final são estáticos (pode não selecionar os gráficos a apresentar). O dashboard mostra apenas gráficos para os quais existem dados.

Seguem-se possíveis restrições de métricas e pontos finais.

  • Volume de Chamadas: mostra o número de chamadas efetuadas durante o período de relatório. Se o período de relatório for de um dia, o gráfico mostra o número de chamadas efetuadas por hora. Caso contrário, o gráfico mostra o número de chamadas efetuadas por dia do período de relatório.

    Nota

    O volume de chamadas pode ser diferente dos relatórios de faturação, o que geralmente inclui apenas chamadas bem-sucedidas.

  • Principais Consultas: mostra as principais consultas e o número de ocorrências de cada consulta durante o período de relatórios. Pode configurar o número de consultas apresentadas. Por exemplo, pode mostrar as 25, 50 ou 75 consultas principais. As Principais Consultas não estão disponíveis para os seguintes pontos finais:

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

    Nota

    Alguns termos de consulta podem ser suprimidos para remover informações confidenciais, como e-mails, números de telefone, SSN, etc.

  • Distribuição Geográfica: os mercados onde os resultados da pesquisa têm origem. Por exemplo, en-us (inglês, Estados Unidos). O Bing utiliza o mkt parâmetro de consulta para determinar o mercado, se especificado. Caso contrário, o Bing utiliza sinais como o endereço IP do autor da chamada para determinar o mercado.

  • Distribuição do Código de Resposta: os códigos de estado HTTP de todas as chamadas durante o período de relatórios.

  • Chamar Distribuição de Origem: os tipos de browsers utilizados pelos utilizadores. Por exemplo, Microsoft Edge, Chrome, Safari e FireFox. As chamadas efetuadas fora de um browser (como bots, Postman ou utilizar curl a partir de uma aplicação de consola) são agrupadas em Bibliotecas. A origem é determinada com o valor do cabeçalho User-Agent do pedido. Se o pedido não incluir o cabeçalho User-Agent, o Bing tenta derivar a origem de outros sinais.

  • Distribuição de Pesquisa Segura: a distribuição de valores de pesquisa seguros. Por exemplo, desativado, moderado ou restrito. O safeSearch parâmetro de consulta contém o valor, se especificado. Caso contrário, o Bing predefine o valor para moderado.

  • Respostas Distribuição Pedida: as respostas da API de Pesquisa na Web que pediu no responseFilter parâmetro de consulta.

  • Respostas Distribuição Devolvida: as respostas que a API de Pesquisa na Web devolveu na resposta.

  • Distribuição do Servidor de Resposta: o servidor de aplicações que serviu os seus pedidos de API. Os valores possíveis são Bing.com (para tráfego servido a partir de dispositivos de computador e portátil) e Bing.com-mobile (para tráfego servido a partir de dispositivos móveis). O servidor é determinado com o valor de cabeçalho User-Agent do pedido. Se o pedido não incluir o cabeçalho User-Agent, o Bing tenta derivar o servidor de outros sinais.

Passos seguintes