Konfigurera värdbaserad UI-upplevelse

Artikel
02/12/2019

Varning

Den 30 oktober 2020 flyttades Bing-sökning-API:erna från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.

Anpassad sökning i Bing innehåller ett värdbaserat användargränssnitt som du enkelt kan integrera i dina webbsidor och webbprogram som ett JavaScript-kodfragment. Med hjälp av portalen för anpassad Bing-sökning kan du konfigurera layout-, färg- och sökalternativen för användargränssnittet.

Konfigurera det anpassade värdbaserade användargränssnittet

Följ dessa steg om du vill konfigurera ett värdbaserat användargränssnitt för dina webbprogram. När du gör ändringar får du en förhandsgranskning av användargränssnittet i fönstret till höger. Sökresultaten som visas är inte faktiska resultat för din instans.

Logga in på portalen för anpassad Bing-sökning.
Välj din instans av anpassad Bing-sökning.
Klicka på fliken för värdbaserat användargränssnitt.
Välj en layout.
- Sökfält och resultat (standard): Visar en sökruta med sökresultat under sig.
- Endast resultat: Visar endast sökresultat utan en sökruta. När du använder den här layouten måste du ange sökfrågan (&q=<query string>). Lägg till frågeparametern i begärande-URL:en i JavaScript-kodfragmentet eller HTML-slutpunktslänken.
- Pop-over: Tillhandahåller en sökruta och visar sökresultaten i ett glidande överlägg.
Välj ett färgtema. Du kan anpassa färgerna så att de passar ditt program genom att klicka på Anpassa tema. Om du vill ändra en färg anger du antingen färgens RGB HEX-värde (till exempel #366eb8), eller klickar på färgförhandsgranskningen.

Du kan förhandsgranska ändringarna till höger i portalen. Om du klickar på Återställ till standard återställs ändringarna till standardfärgerna för det valda temat.

Anteckning

Överväg tillgänglighet när du väljer färger.
Under Ytterligare konfigurationer anger du värden som är lämpliga för din app. De här inställningarna är valfria. Om du vill se effekten av att tillämpa eller ta bort dem kan du se förhandsgranskningsfönstret till höger. Tillgängliga konfigurationsalternativ är:
Ange nyckeln för sökprenumerationen eller välj en från listrutan. Listrutan fylls med nycklar från ditt Azure-kontos prenumerationer. Se AZURE AI Services API-konto.
Om du har aktiverat automatiska förslag anger du prenumerationsnyckeln för automatiska förslag eller väljer en i listrutan. Listrutan fylls med nycklar från ditt Azure-kontos prenumerationer. Anpassade automatiska förslag kräver en specifik prenumerationsnivå, se prissättningen.

Publicera eller återställa

Ändringar som du gör i en instans av anpassad sökning görs på fliken Konfiguration så att du kan verifiera dina ändringar. När du är klar med ändringarna och är redo att publicera klickar du på Publicera. Ändringarna återspeglas inte mot dina produktionsslutpunkter förrän du publicerar.

Om du inte vill behålla de ändringar du har gjort innan du publicerar klickar du på Återställ. När du återställer ändringarna ändras konfigurationen av livetillståndet och fliken Konfiguration återställs så att den matchar livetillståndet.

Använda anpassat användargränssnitt

Så här använder du det värdbaserade användargränssnittet:

Inkludera skriptet på webbsidan

<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>

Du kan också använda följande URL i en webbläsare.

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

Lägg till följande frågeparametrar i URL:en efter behov. Information om dessa parametrar finns i REFERENS för API för anpassad sökning .
- q
- mkt
- Safesearch
- setlang
Viktigt

Sidan kan inte visa din sekretesspolicy eller andra meddelanden och villkor. Lämpligheten för din användning kan variera.

Mer information, inklusive ditt anpassade konfigurations-ID, finns i Slutpunkter under fliken Produktion .

Konfigurationsalternativ

Du kan konfigurera beteendet för ditt värdbaserade användargränssnitt genom att klicka på Ytterligare konfigurationer och ange värden. De här inställningarna är valfria. Om du vill se effekten av att tillämpa eller ta bort dem kan du se förhandsgranskningsfönstret till höger.

Webbsökningskonfigurationer

Webbresultat aktiverat: Avgör om webbsökning är aktiverat (du ser en webbflik överst på sidan)
Aktivera automatiska förslag: Avgör om anpassade automatiska förslag är aktiverat (se priser för ytterligare kostnad).
Webbresultat per sida: Antal webbsökningsresultat som ska visas åt gången (maxvärdet är 50 resultat per sida).
Bild bildtext: Avgör om bilder visas med sökresultat.

Följande konfigurationer visas om du klickar på Visa avancerade konfigurationer:

Markera ord: Avgör om resultaten visas med söktermer i fetstil.
Länkmål: Avgör om webbsidan öppnas i en ny webbläsarflik (tom) eller på samma webbläsarflik (själv) när användaren klickar på ett sökresultat.

Konfigurationer för bildsökning

Bildresultat aktiverat: Avgör om bildsökning är aktiverat (du ser fliken Bilder överst på sidan).
Bildresultat per sida: Antal sökresultat som ska visas åt gången (maxvärdet är 150 resultat per sida).

Följande konfiguration visas om du klickar på Visa avancerade konfigurationer.

Aktivera filter: Lägger till filter som användaren kan använda för att filtrera de bilder som Bing returnerar. Användaren kan till exempel filtrera resultatet för endast animerade GIF-filer.

Videosökningskonfigurationer

Videoresultat aktiverat: Avgör om videosökning är aktiverat (du ser fliken Videor överst på sidan).
Videoresultat per sida: Antal videosökningsresultat som ska visas åt gången (maxvärdet är 150 resultat per sida).

Följande konfiguration visas om du klickar på Visa avancerade konfigurationer.

Aktivera filter: Lägger till filter som användaren kan använda för att filtrera de videor som Bing returnerar. Användaren kan till exempel filtrera resultaten för videor med en specifik upplösning eller videor som har identifierats under de senaste 24 timmarna.

Diverse konfigurationer

Sidrubrik: Text som visas i rubrikområdet på sökresultatsidan (inte för popup-layout).
Tema i verktygsfältet: Avgör bakgrundsfärgen för rubrikområdet på sökresultatsidan.

Följande konfigurationer visas om du klickar på Visa avancerade konfigurationer.

Column1	Column2
Platshållare för text i sökrutan	Text som visas i sökrutan före indata.
Url för rubriklänk	Mål för rubriklänken.
Logotyp-URL	Bild som visas bredvid rubriken.
Favicon	Ikonen visas i webbläsarens namnlist.

Följande konfigurationer gäller endast om du använder det värdbaserade användargränssnittet via HTML-slutpunkten (de gäller inte om du använder JavaScript-kodfragmentet).

Sidrubrik
Tema för verktygsfält
Url för rubriklänk
Logotyp-URL
Faviicon URL

Dela via