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. Zie Een Bing Search-resource maken via Azure Marketplace voor instructies voor het maken van nieuwe Azure-resources voor Bing Search.

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 zelfstudie laat zien hoe u een exemplaar voor aangepaste zoekopdrachten maakt en integreert met een nieuwe webpagina.

De behandelde taken zijn:

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

Vereisten

Een exemplaar voor aangepaste zoekopdrachten maken

Een exemplaar voor aangepaste zoekopdrachten met Bing maken:

  1. Open een browser.

  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 dit de eerste keer is dat u de portal gebruikt, wordt u gevraagd om de service toegang te geven tot uw gegevens. Klik op Ja.

  4. Als u bent aangemeld, klikt u op Create new instance. 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 voor het invoeren van een naam voor het nieuwe exemplaar voor aangepaste zoekopdrachten

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

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

  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 vastgemaakt als de querytekenreeks van de gebruiker overeenkomt met de querytekenreeks van de vastgemaakte webpagina, op basis van de voorwaarde voor overeenkomst van de vastgemaakte pagina. 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 de queryreeks van de vastgemaakte webpagina om door Bing als het beste resultaat te worden geretourneerd. Om de voorwaarde voor overeenkomst te wijzigen, bewerkt u de vastgemaakte webpagina (klik op het potloodpictogram), klikt u op Exact in de kolom Query match condition en selecteert u de voorwaarde voor overeenkomst die geschikt is voor uw toepassing.

    Schermafbeelding van het tabblad Pinned

  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

Custom Search biedt een gehoste gebruikersinterface voor het weergeven van het JSON-antwoord van het exemplaar voor aangepaste zoekopdrachten. 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. U kunt ook op de kleurknop klikken en vervolgens op de gewenste tint. 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. U ziet dan opties zoals Link target onder Web search, Enable filters onder Image search en Video search, en Search box text placeholder onder Miscellaneous.

    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 terugkeren

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 implementeren

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.

Uw Visual Studio-oplossing instellen

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