Adicionar análise às APIs de Pesquisa do Bing

  • Artigo

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte 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, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.

As Estatísticas do Bing fornecem análise para as APIs de Pesquisa do Bing. A análise inclui o volume de chamadas, as principais cadeias de caracteres de consulta, a distribuição geográfica e muito mais. É possível habilitar as Estatísticas do Bing no portal do Azure navegando até o recurso do Azure e clicando em Habilitar Estatísticas do Bing.

Importante

  • As Estatísticas do Bing não estão disponíveis com recursos no tipo de preço F0 gratuito.
  • 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.
  • Habilitar as Estatísticas do Bing aumenta ligeiramente a taxa de assinatura. Para obter detalhes, confira os preços.

A imagem a seguir mostra a análise disponível para cada ponto de extremidade de API da Pesquisa do Bing.

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

Acessar sua análise

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. Verifique se está conectado com a mesma MSA (conta Microsoft) usada para entrar nas Estatísticas do Bing.

Observação

  • Pode demorar até 24 horas para que as métricas apareçam no painel. O painel mostra a data e hora em que os dados foram atualizados pela última vez.
  • As métricas estarão disponíveis a partir do momento que você habilitar o suplemento de Estatísticas do Bing.

Filtrar os dados

Por padrão, os gráficos e grafos exibem todos os dados e métricas a que você tem acesso. É 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. É possível alterar os seguintes filtros:

  • ID do recurso: a ID exclusiva do recurso que identifica a assinatura do Azure. Se você assinar mais de uma camada de API de Pesquisa do Bing, a lista conterá várias IDs. Por padrão, todos os recursos são selecionados.

  • Mercados: os mercados de onde vêm os resultados. Por exemplo, en-us (inglês, Estados Unidos). Por padrão, todos os mercados são selecionados. O Bing usará o mercado en-WW se a chamada não especificar um mercado e o Bing não puder determinar o mercado do usuário.

  • Pontos de extremidade: os pontos de extremidade de API de Pesquisa do Bing. A lista contém todos os pontos de extremidade para os quais você tem uma assinatura paga. Por padrão, todos os pontos de extremidade são selecionados.

  • Período: o período do relatório. É possível especificar:

    • Todos: inclui até 13 meses de dados
    • Últimas 24 horas: inclui análises das últimas 24 horas
    • Última semana: inclui análises dos últimos 7 dias
    • Último mês: inclui análises dos últimos 30 dias
    • Um intervalo de datas personalizado: inclui análises do intervalo de datas especificado, se disponível

Gráficos e grafos

O painel mostra gráficos e grafos das métricas disponíveis para o ponto de extremidade selecionado. Nem todas as métricas estão disponíveis para todos os pontos de extremidade. 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). O painel mostra apenas gráficos e grafos para os quais há dados.

A seguir estão as possíveis métricas e restrições de ponto de extremidade.

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

    Observação

    O volume de chamadas pode diferir dos relatórios de cobrança, que geralmente incluem apenas chamadas com êxito.

  • Principais consultas: mostra as principais consultas e o número de ocorrências de cada consulta durante o período do relatório. É possível configurar o número de consultas mostradas. Por exemplo, é possível mostrar as 25, 50 ou 75 principais consultas. As principais consultas não estão disponíveis para os pontos de extremidade a seguir:

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

    Observação

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

  • Distribuição geográfica: os mercados nos quais os resultados da pesquisa são originados. Por exemplo, en-us (inglês, Estados Unidos). O Bing usa o parâmetro de consulta mkt para determinar o mercado, se especificado. Caso contrário, o Bing usa sinais como o endereço IP do chamador para determinar o mercado.

  • Distribuição de código de resposta: os códigos de status HTTP de todas as chamadas durante o período do relatório.

  • Distribuição de origem de chamada: os tipos de navegadores usados pelos usuários. Por exemplo, Microsoft Edge, Chrome, Safari e FireFox. Chamadas feitas de fora de um navegador como bots, Postman ou usando ondulação de um aplicativo de console, são agrupadas em Bibliotecas. A origem é determinada usando o valor do cabeçalho do Agente do Usuário da solicitação. Se a solicitação não incluir o cabeçalho do Agente do Usuário, o Bing tentará derivar a origem de outros sinais.

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

  • Distribuição de respostas solicitadas: a API de Pesquisa na Web responde às consultas solicitadas no parâmetro de consulta responseFilter.

  • Distribuição de respostas retornadas: as respostas que a API de Pesquisa da Web retornou na resposta.

  • Distribuição do servidor de resposta: o servidor de aplicativos que atendeu as solicitações de API. 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). O servidor é determinado usando o valor do cabeçalho do Agente do Usuário da solicitação. Se a solicitação não incluir o cabeçalho do Agente do Usuário, o Bing tentará derivar o servidor de outros sinais.

Próximas etapas