Aggiungere analisi alle API di Ricerca Bing

Avviso

Il 30 ottobre 2020 le API Ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di Ricerca Bing. Questa documentazione viene fornita solo per riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite il Azure Marketplace.

Statistiche Bing fornisce analisi per le API di Ricerca Bing. Queste analisi includono volume di chiamate, stringhe di query principali, distribuzione geografica e altro ancora. È possibile abilitare Le statistiche Bing nel portale di Azure passando alla risorsa di Azure e facendo clic su Abilita statistiche Bing.

Importante

  • Le statistiche Bing non sono disponibili con le risorse nel piano tariffario gratuito F0 .
  • Non è possibile usare i dati disponibili tramite il dashboard di Bing Statistics per creare applicazioni per la distribuzione a terze parti.
  • L'abilitazione delle statistiche Bing aumenta leggermente la frequenza di sottoscrizione. Per informazioni dettagliate, vedere prezzi .

L'immagine seguente mostra l'analisi disponibile per ogni endpoint API Ricerca Bing.

Matrice di supporto della distribuzione in base all'endpoint

Accedere all'analisi

Bing aggiorna i dati di analisi ogni 24 ore e mantiene fino a 13 mesi di cronologia a cui è possibile accedere dal dashboard di analisi. Assicurarsi di aver eseguito l'accesso usando lo stesso account Microsoft (MSA) usato per iscriversi a Bing Statistics.

Nota

  • La visualizzazione delle metriche nel dashboard potrebbe richiedere fino a 24 ore. Il dashboard mostra la data e l'ora dell'ultimo aggiornamento dei dati.
  • Le metriche sono disponibili dal momento in cui viene abilitato il componente aggiuntivo Bing Statistics.

Filtrare i dati

Per impostazione predefinita, i grafici e i grafici visualizzano tutte le metriche e i dati a cui si ha accesso. È possibile filtrare i dati visualizzati nei grafici selezionando le risorse, i mercati, gli endpoint e il periodo di reporting a cui si è interessati. È possibile modificare i filtri seguenti:

  • ID risorsa: l'ID risorsa univoco che identifica la sottoscrizione di Azure. Se si effettua la sottoscrizione a più di un livello dell'API di ricerca Bing, l'elenco contiene più ID. Per impostazione predefinita, sono selezionate tutte le risorse.

  • Mercati: i mercati da cui provengono i risultati. Ad esempio, en-us (inglese, Stati Uniti). Per impostazione predefinita, sono selezionati tutti i mercati. Il en-WW mercato è il mercato usato da Bing se la chiamata non specifica un mercato e Bing non è in grado di determinare il mercato dell'utente.

  • Endpoint: gli endpoint dell'API di ricerca Bing. L'elenco contiene tutti gli endpoint per cui si dispone di una sottoscrizione a pagamento. Per impostazione predefinita, sono selezionati tutti gli endpoint.

  • Intervallo di tempo: il periodo di reporting. È possibile specificare:

    • Tutto: include fino a 13 mesi di dati
    • Ultime 24 ore: include analisi delle ultime 24 ore
    • Settimana precedente: include l'analisi dei 7 giorni precedenti
    • Mese precedente: include analisi dei 30 giorni precedenti
    • Un intervallo di date personalizzato: include l'analisi dall'intervallo di date specificato, se disponibile

Grafici

Il dashboard mostra i grafici delle metriche disponibili per l'endpoint selezionato. Non tutte le metriche sono disponibili per tutti gli endpoint. I grafici per ogni endpoint sono statici (non è possibile selezionare i grafici da visualizzare). Il dashboard mostra solo i grafici per cui ci sono dati.

Di seguito sono riportate le possibili metriche e le restrizioni degli endpoint.

  • Volume chiamate: mostra il numero di chiamate effettuate durante il periodo di reporting. Se il periodo di reporting è un giorno, il grafico mostra il numero di chiamate effettuate ogni ora. In caso contrario, il grafico mostra il numero di chiamate effettuate al giorno nel periodo di reporting.

    Nota

    Il volume di chiamate può differire dai report di fatturazione, che generalmente includono solo le chiamate con esito positivo.

  • Query principali: mostra le query principali e il numero di occorrenze di ogni query durante il periodo di reporting. È possibile configurare il numero di query visualizzate. Ad esempio, è possibile visualizzare le prime 25 o 50, 75 query. Query principali non è disponibile per gli endpoint seguenti:

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

    Nota

    Alcuni termini di query possono essere eliminati per rimuovere informazioni riservate, ad esempio messaggi di posta elettronica, numeri di telefono, codice fiscale e così via.

  • Distribuzione geografica: i mercati in cui hanno origine i risultati della ricerca. Ad esempio, en-us (inglese, Stati Uniti). Bing usa il parametro di query mkt per determinare il mercato, se specificato. In caso contrario, Bing usa segnali come l'indirizzo IP del chiamante per determinare il mercato.

  • Distribuzione dei codici di risposta: i codici di stato HTTP di tutte le chiamate durante il periodo di reporting.

  • Distribuzione dell'origine delle chiamate: i tipi di browser usati dagli utenti. Ad esempio, Microsoft Edge, Chrome, Safari e FireFox. Le chiamate effettuate dall'esterno di un browser (ad esempio bot, Postman o usando curl da un'app console) vengono raggruppate in Librerie. L'origine viene determinata tramite il valore dell'intestazione agente utente della richiesta. Se la richiesta non include l'intestazione agente utente, Bing tenta di derivare l'origine da altri segnali.

  • Distribuzione della ricerca sicura: la distribuzione dei valori di ricerca sicura. Ad esempio, off, moderate o strict. Il parametro di query safeSearch contiene il valore, se specificato. In caso contrario, Bing definisce per impostazione predefinita il valore da moderare.

  • Risposte distribuzione richiesta: l'API Ricerca Web risponde che è stata richiesta nel responseFilter parametro di query.

  • Distribuzione delle risposte restituite: le risposte che l'API di ricerca Web ha restituito nella risposta.

  • Distribuzione server di risposta: il server applicazioni che ha fornito le risposte dell'API. I valori possibili sono Bing.com (per il traffico fornito da dispositivi desktop e portatili) e Bing.com-mobile (per il traffico fornito da dispositivi mobili). Il server viene determinato tramite il valore dell'intestazione agente utente della richiesta. Se la richiesta non include l'intestazione agente utente, Bing tenta di derivare il server da altri segnali.

Passaggi successivi