Configurare l'esperienza dell'interfaccia utente ospitata

Articolo
02/12/2019

Avviso

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

Ricerca personalizzata Bing offre un'interfaccia utente ospitata che è possibile integrare facilmente in applicazioni Web e pagine Web come frammento di codice JavaScript. Tramite il portale di Ricerca personalizzata Bing è possibile configurare layout, colore e opzioni di ricerca dell'interfaccia utente.

Configurare l'interfaccia utente ospitata personalizzata

Per configurare un'interfaccia utente ospitata per le applicazioni Web, completare questi passaggi. Quando si apportano modifiche, nel riquadro a destra viene visualizzata un'anteprima dell'interfaccia utente. I risultati della ricerca visualizzati non sono effettivi risultati per l'istanza.

Accedere al portale di Ricerca personalizzata Bing.
Selezionare l'istanza di Ricerca personalizzata Bing.
Fare clic sulla scheda Hosted UI (Interfaccia utente ospitata).
Selezionare un layout.
- Barra di ricerca e risultati (impostazione predefinita): visualizza una casella di ricerca con i risultati della ricerca sotto di essa.
- Solo risultati: visualizza solo i risultati della ricerca, senza una casella di ricerca. Quando si usa questo layout è necessario fornire la query di ricerca (&q=<query string>). Aggiungere il parametro di query all'URL della richiesta nel frammento di codice JavaScript oppure il collegamento all'endpoint HTML.
- Pop-over: fornisce una casella di ricerca e visualizza i risultati della ricerca in una sovrapposizione scorrevole.
Selezionare un tema colori. È possibile personalizzare i colori per adattare l'applicazione facendo clic su Customize theme (Personalizza tema). Per modificare un colore, immettere il valore RGB esadecimale del colore, ad esempio #366eb8, o fare clic sull'anteprima colore.

È possibile visualizzare in anteprima le modifiche sul lato destro del portale. Facendo clic su Ripristina impostazioni predefinite si ripristinano i colori predefiniti per il tema selezionato.

Nota

Nella scelta dei colori è necessario considerare l'accessibilità.
In Additional Configurations (Configurazioni aggiuntive) fornire i valori appropriati per l'app. Questa impostazioni sono facoltative. Per visualizzare l'effetto prodotto dalla selezione o deselezione di queste impostazioni, vedere il riquadro di anteprima a destra. Le opzioni di configurazione disponibili sono:
Immettere la chiave di sottoscrizione della ricerca o sceglierne una nell'elenco a discesa. L'elenco a discesa viene popolato con le chiavi presenti nelle sottoscrizioni degli account Azure. Vedere l'account API dei servizi di intelligenza artificiale di Azure.
Se sono stati abilitati i suggerimenti automatici, immettere la chiave di sottoscrizione dei suggerimenti automatici oppure sceglierne una nell'elenco a discesa. L'elenco a discesa viene popolato con le chiavi presenti nelle sottoscrizioni degli account Azure. I suggerimenti automatici personalizzati richiedono un livello di sottoscrizione specifico. Vedere la pagina dei prezzi.

Pubblicare o ripristinare

Le modifiche apportate a un'istanza di Ricerca vengono effettuate nella scheda Configurazione in modo che sia possibile convalidarle. Quando si è terminato di apportare le modifiche e si è pronti per la pubblicazione, fare clic su Pubblica. Le modifiche non vengono riflesse negli endpoint di produzione finché non si esegue la pubblicazione.

Prima della pubblicazione, se si decide che non si vuole mantenere le modifiche apportate, fare clic su Ripristina. Quando si ripristinano le modifiche, la configurazione dello stato attivo è invariata e la scheda Configurazione viene ripristinata per corrispondere allo stato attivo.

Utilizzare l'interfaccia utente personalizzata

Per utilizzare l'interfaccia utente ospitata, eseguire una delle due operazioni seguenti:

Includere lo script nella pagina Web

<html>
    <body>
        <script type="text/javascript" 
            id="bcs_js_snippet"
            src="https://ui.customsearch.ai /api/ux/rendering-js?customConfig=<YOUR-CUSTOM-CONFIG-ID>&market=en-US&safeSearch=Moderate&version=latest&q=">
        </script>
    </body>    
</html>

In alternativa, usare l'URL seguente in un Web browser.

https://ui.customsearch.ai/hosted?customConfig=YOUR-CUSTOM-CONFIG-ID
Nota

Aggiungere i parametri di query seguenti all'URL nel modo necessario. Per altre informazioni su questi parametri, vedere API Ricerca personalizzata Bing.
- q
- mkt
- safesearch
- setlang
Importante

La pagina non può visualizzare l'informativa sulla privacy o altri avvisi e condizioni. L'idoneità all'uso può variare.

Per altre informazioni, tra cui l'ID di configurazione personalizzato, vedere Endpoint (Endpoint) nella scheda Production (Produzione).

Opzioni di configurazione

È possibile configurare il comportamento dell'interfaccia utente ospitata facendo clic su Configurazioni aggiuntive e fornendo i valori. Questa impostazioni sono facoltative. Per visualizzare l'effetto prodotto dalla selezione o deselezione di queste impostazioni, vedere il riquadro di anteprima a destra.

Web search configurations (Configurazioni di ricerca Web)

Risultati Web abilitati: determina se la ricerca Web è abilitata (verrà visualizzata una scheda Web nella parte superiore della pagina)
Abilita autosuggest: determina se l'inserimento automatico personalizzato è abilitato (vedere prezzi per costi aggiuntivi ).
Risultati Web per pagina: numero di risultati della ricerca Web da visualizzare alla volta (il massimo è 50 risultati per pagina).
Immagine didascalia: determina se le immagini vengono visualizzate con i risultati della ricerca.

Le configurazioni seguenti vengono visualizzate se si fa clic su Mostra configurazioni avanzate:

Parole di evidenziazione: determina se i risultati vengono visualizzati con i termini di ricerca in grassetto.
Destinazione collegamento: determina se la pagina Web viene aperta in una nuova scheda del browser (vuota) o nella stessa scheda del browser (self) quando l'utente fa clic su un risultato di ricerca.

Image search configurations (Configurazioni di ricerca immagini)

Risultati immagine abilitati: determina se la ricerca di immagini è abilitata (verrà visualizzata una scheda Immagini nella parte superiore della pagina).
Risultati immagine per pagina: numero di risultati della ricerca di immagini da visualizzare alla volta (il massimo è 150 risultati per pagina).

Se si fa clic su Show advanced configurations (Mostra configurazioni avanzate), viene visualizzata la configurazione seguente.

Abilita filtri: aggiunge filtri che l'utente può usare per filtrare le immagini restituite da Bing. Ad esempio, l'utente può filtrare i risultati per ottenere solo immagini GIF animate.

Configurazioni per la ricerca di video

Risultati video abilitati: determina se la ricerca video è abilitata (verrà visualizzata una scheda Video nella parte superiore della pagina).
Risultati video per pagina: numero di risultati della ricerca video da visualizzare alla volta (il massimo è 150 risultati per pagina).

Se si fa clic su Show advanced configurations (Mostra configurazioni avanzate), viene visualizzata la configurazione seguente.

Abilita filtri: aggiunge filtri che l'utente può usare per filtrare i video restituiti da Bing. Ad esempio, l'utente può filtrare i risultati per i video con una risoluzione specifica o i video individuati nelle ultime 24 ore.

Miscellaneous configurations (Configurazioni varie)

Titolo pagina: testo visualizzato nell'area titolo della pagina dei risultati della ricerca (non per il layout popup).
Tema della barra degli strumenti: determina il colore di sfondo dell'area del titolo della pagina dei risultati della ricerca.

Se si fa clic su Show advanced configurations (Mostra configurazioni avanzate), vengono visualizzate le configurazioni seguenti.

Colonna 1	Colonna 2
Search box text placeholder (Segnaposto del testo della casella di ricerca)	Testo visualizzato nella casella di ricerca prima dell'input.
Title link URL (URL collegamento titolo)	Destinazione per il collegamento del titolo.
Logo URL (URL del logo)	Immagine visualizzata accanto al titolo.
Favicon	Icona visualizzata nella barra del titolo del browser.

Le configurazioni seguenti si applicano solo se si usa l'interfaccia utente ospitata tramite l'endpoint HTML (non sono applicabili se si usa il frammento JavaScript).

Page title (Titolo della pagina)
Toolbar theme (Tema della barra degli strumenti)
Title link URL (URL collegamento titolo)
Logo URL (URL del logo)
URL Favicon (URL icona preferita)