Delen via

Zelfstudie: Een webpagina voor aangepaste zoekopdrachten maken

  • Artikel

Waarschuwing

Op 30 oktober 2020 zijn de Bing Search-API's verplaatst van Azure AI-services naar Bing Search Services. Deze documentatie wordt alleen ter referentie verstrekt. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Voor instructies voor het maken van nieuwe Azure-resources voor Bing, zie Een Bing Search-resource maken via de Azure Marketplace.

Met Bing Aangepaste zoekopdrachten kunt u op maat gemaakte zoekervaringen maken voor onderwerpen die u interesseren. Als u bijvoorbeeld een website over martial arts hebt die een zoekervaring biedt, kunt u de domeinen, subsites en webpagina's opgeven waarin Bing moet zoeken. Uw gebruikers zien dan zoekresultaten die zijn afgestemd op de inhoud die ze interessant vinden in plaats van dat ze door pagina's met algemene zoekresultaten moeten bladeren die mogelijk niet-relevante inhoud bevatten.

Deze handleiding laat zien hoe u een aangepast zoekopdrachtenfunctie instelt en hoe u deze integreert in een nieuwe webpagina.

De behandelde taken zijn:

  • Een aangepaste zoekinstantie maken
  • Actieve vermeldingen toevoegen
  • Geblokkeerde vermeldingen toevoegen
  • Vastgemaakte vermeldingen toevoegen
  • Aangepaste zoekopdrachten integreren met een webpagina

Vereisten

Een aangepaste zoekinstantie maken

Voor Bing Custom Search een exemplaar maken:

  1. Open een internetbrowser.

  2. Ga naar de portal voor aangepaste zoekopdrachten.

  3. Meld u aan bij de portal met een Microsoft-account (MSA). Als u geen MSA hebt, klikt u op Create a Microsoft account. Als het de eerste keer is dat u de portal gebruikt, zal deze vragen om toestemming voor toegang tot uw gegevens. Klik op Ja.

  4. Als u bent aangemeld, klikt u op Nieuwe aangepaste zoekopdracht. Voer in het venster Create a new custom search instance een beschrijvende naam in die duidelijk aangeeft wat voor inhoud de zoekopdracht retourneert. U kunt de naam overigens altijd wijzigen.

    Schermafbeelding van het vak 'Maak een nieuwe aangepaste zoekinstantie aan'

  5. Klik op OK, geef een URL op en schakel het selectievakje in als u subpagina's wilt opnemen.

    Schermafbeelding van pagina voor opgeven van URL

Actieve vermeldingen toevoegen

Als u resultaten van bepaalde websites of URL's wilt opnemen, voegt u deze toe aan het tabblad Active.

  1. Klik op de pagina Configuration op het tabblad Active en voer de URL in van een of meer websites die u wilt opnemen in de zoekopdracht.

    Schermafbeelding van het actieve tabblad in de Definitie-editor

  2. Controleer of het exemplaar resultaten retourneert door een query in te voeren in het voorbeeldvenster aan de rechterkant. Bing retourneert alleen resultaten voor openbare websites die zijn geïndexeerd door de service.

Geblokkeerde vermeldingen toevoegen

Als u resultaten van bepaalde websites of URL's wilt uitsluiten, voegt u deze toe aan het tabblad Blocked.

  1. Klik op de pagina Configuration op het tabblad Blocked en voer de URL in van een of meer websites die u wilt uitsluiten van de zoekopdracht.

    Schermafbeelding van het geblokkeerde tabblad in de Definitie-editor

  2. Controleer of het exemplaar geen resultaten retourneert van de geblokkeerde websites door een query in te voeren in het voorbeeldvenster aan de rechterkant.

Vastgemaakte vermeldingen toevoegen

Als u een specifieke webpagina aan het begin van de zoekresultaten wilt vastmaken, voegt u de webpagina en de queryterm toe aan het tabblad Vastgemaakt . Het vastgemaakte tabblad bevat een lijst met webpagina- en querytermparen waarmee de webpagina wordt opgegeven die als het bovenste resultaat voor een specifieke query wordt weergegeven. De webpagina wordt alleen vastgezet als de querytekenreeks van de gebruiker overeenkomt met de querytekenreeks van de vastgezette pagina, op basis van de overeenkomstvoorwaarde van die pin. In zoekopdrachten worden alleen geïndexeerde webpagina's weergegeven. Zie Uw aangepaste weergave definiëren voor meer informatie.

  1. Klik op de pagina Configuration op het tabblad Pinned en voer de webpagina en zoekterm in van de webpagina die u als het bovenste resultaat in de lijst wilt weergeven.

  2. De standaardinstelling is dat de queryreeks van de gebruiker exact moet overeenkomen met die van je pin, zodat Bing de webpagina als het beste resultaat retourneert. Om de overeenkomstvoorwaarde te wijzigen, bewerkt u de pin (klik op het potloodpictogram), klikt u op Exact in de kolom Query match condition en selecteert u de overeenkomstvoorwaarde die geschikt is voor uw toepassing.

    Schermafbeelding van het aangehechte tabblad Definition Editor

  3. Controleer of uw exemplaar de opgegeven webpagina als het beste resultaat retourneert door in het voorbeeldvenster aan de rechterkant de zoekterm in te voeren die u hebt vastgemaakt.

Gehoste gebruikersinterface configureren

Aangepaste Zoekopdracht biedt een gehoste gebruikersinterface voor het weergeven van het JSON-antwoord van uw exemplaar van de Aangepaste Zoekopdracht. Volg deze stappen om de ervaring in de gebruikersinterface te definiëren:

  1. Klik op het tabblad Hosted UI.

  2. Een indeling selecteren.

    Schermafbeelding van het selecteren van een lay-out voor de gehoste gebruikersinterface

  3. Selecteer een kleurenthema.

    Schermafbeelding van het selecteren van een kleurenthema voor de gehoste gebruikersinterface

    Als u het kleurenthema wilt afstemmen voor een betere integratie met uw web-app, klikt u op Customize theme. Niet alle kleurconfiguraties zijn van toepassing op alle lay-outthema's. Als u een kleur wilt wijzigen, voert u de hexadecimale RGB-waarde van de kleur (bijvoorbeeld #366eb8) in het bijbehorende tekstvak in. Klik op de kleurknop en vervolgens op de tint die voor u werkt. Denk altijd aan toegankelijkheid bij het selecteren van kleuren.

    Schermafbeelding van het aanpassen van een kleurenthema voor de gehoste gebruikersinterface

  4. Geef aanvullende configuratieopties op.

    Schermafbeelding van het opgeven van aanvullende configuraties voor de gehoste gebruikersinterface

    Als u geavanceerde configuraties wilt ophalen, klikt u op Show advanced configurations. Uitbreidingen zoals Linkdoel worden toegevoegd aan Webzoekopties, Filters inschakelen aan Beeld- en Video-opties, en Plaatsaanduiding zoekvaktekst aan Diverse opties.

    Schermafbeelding van het opgeven van geavanceerde configuraties voor de gehoste gebruikersinterface

  5. Selecteer uw abonnementssleutels in de vervolgkeuzelijsten. U kunt de abonnementssleutel ook handmatig invoeren.

    Schermafbeelding van de abonnementssleutel voor de gehoste UI

Publiceren of terugdraaien

Wijzigingen die u in een Custom Search-exemplaar aanbrengt, worden gemaakt op het tabblad Configuratie, zodat u uw wijzigingen kunt valideren. Wanneer u klaar bent met het maken van wijzigingen en wilt publiceren, klikt u op Publiceren. Wijzigingen worden pas na publicatie op uw productie-eindpunten weergegeven.

Als u alvorens te publiceren besluit dat u de wijzigingen die u hebt aangebracht niet wilt behouden, klikt u op Terugkeren. Wanneer u de wijzigingen ongedaan maakt, blijft de configuratie van de live status ongewijzigd en wordt het tabblad Configuratie teruggezet zodat dit overeenkomt met de live status.

Gehoste gebruikersinterface gebruiken

Er zijn twee manieren om de gehoste-gebruikersinterface te gebruiken.

  • Optie 1: het opgegeven JavaScript-fragment integreren in uw toepassing.
  • Optie 2: het opgegeven HTML-eindpunt gebruiken.

De rest van deze zelfstudie illustreert optie 1: JavaScript-fragment.

Stel uw Visual Studio-oplossing in

  1. Open Visual Studio op uw computer.

  2. Selecteer in het menu Bestand de optie Nieuw en kies vervolgens Project.

  3. Selecteer Visual C# / Web / ASP.NET Core Web Application in het venster New Project, geef het project een naam en klik vervolgens op OK.

    Schermafbeelding van het dialoogvenster New Project

  4. Selecteer in het venster New ASP.NET Core Web Application de optie Web Application en klik op OK.

    Schermafbeelding van het dialoogvenster New WebApp

index.cshtml bewerken

  1. Vouw in de Solution Explorer het onderdeel Pages uit en dubbelklik op index.cshtml om het bestand te openen.

    Schermafbeelding van Solution Explorer met pages uitgevouwen en index.cshtml geselecteerd

  2. Verwijder in index.cshtml alles vanaf regel 7.

    @page
@model IndexModel
@{
   ViewData["Title"] = "Home page";
}

  3. Voeg een regeleinde (br) toe en een div-element om te fungeren als een container.

    @page
@model IndexModel
@{
   ViewData["Title"] = "Home page";
}
<br />
<div id="customSearch"></div>

  4. Blader op de pagina Hosted UI omlaag naar de sectie Consuming the UI. Klik op Endpoints voor toegang tot het JavaScript-fragment. U kunt ook naar het codefragment gaan door te klikken op Production en vervolgens op het tabblad Hosted UI.

  5. Plak het script-element in de container die u hebt toegevoegd.

    @page
@model IndexModel
@{
   ViewData["Title"] = "Home page";
}
<br />
<div id="customSearch">
   <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>
</div>

  6. Klik in de Solution Explorer met de rechtermuisknop op wwwroot en klik op View in Browser.

    Schermafbeelding van de optie View in Browser in het contextmenu van wwwroot in Solution Explorer

De nieuwe webpagina voor aangepaste zoekopdrachten moet er ongeveer als volgt uitzien:

Schermafbeelding van webpagina voor aangepaste zoekopdrachten

Het uitvoeren van een zoekopdracht levert resultaten op als deze:

Schermafbeelding van resultaten van aangepaste zoekopdrachten

Volgende stappen

Bing Aangepaste zoekopdrachten-eindpunt aanroepen (C#)