Delen via

Zelfstudie: Een webpagina voor aangepaste zoekopdrachten maken

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 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. Navigeer 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 Een Microsoft-account maken. 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. Nadat u zich hebt aangemeld, klikt u op Nieuw aangepast zoeken. Voer in het venster Een nieuwe instantie voor aangepaste zoekopdracht maken een naam in die duidelijk en beschrijvend is voor het type inhoud dat de zoekopdracht retourneert. U kunt de naam overigens altijd wijzigen.

    Schermopname van het vak Maak een nieuwe aangepaste zoekinstantie

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

    Schermopname van de pagina URL-definitie

Actieve vermeldingen toevoegen

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

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

    Schermopname van het actieve tabblad 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 specifieke websites of URL's wilt uitsluiten, voegt u deze toe aan het tabblad Geblokkeerd .

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

    Schermopname van het tabblad Geblokkeerde 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 Configuratie op het tabblad Vastgemaakt en voer de webpagina en queryterm in van de webpagina die u wilt retourneren als het bovenste resultaat.

  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. Als u de overeenkomstvoorwaarde wilt wijzigen, bewerkt u de pin (klik op het potloodpictogram), klikt u op Exact in de kolom Voorwaarde voor queryovereenkomst, en selecteert u de overeenkomstvoorwaarde die geschikt is voor uw toepassing.

    Schermopname van het vastgemaakte tabblad Definitie-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 Gehoste gebruikersinterface .

  2. Een indeling selecteren.

    Schermopname van de stap voor het selecteren van de indeling van de gehoste gebruikersinterface

  3. Selecteer een kleurenthema.

    Schermopname van het geselecteerde kleurenthema van de Hosted UI

    Als u het kleurenthema wilt aanpassen om beter te integreren met uw web-app, klikt u op Thema aanpassen. 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.

    Schermopname van het kleurenthema voor het aanpassen van de gehoste gebruikersinterface

  4. Geef aanvullende configuratieopties op.

    Schermopname van de stap Aanvullende configuraties van de gehoste gebruikersinterface

    Klik op Geavanceerde configuraties weergeven om geavanceerde configuraties op te halen. Hiermee worden configuraties zoals koppelingsdoel toegevoegd aan webzoekopties, filters inschakelen voor opties voor afbeeldingen en video's en zoekvak tekst placeholder aan diverse opties.

    Schermopname van de stap geavanceerde configuraties van de gehoste gebruikersinterface

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

    Schermopname van de hosted UI-abonnementssleutel

Publiceren of terugdraaien

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

Voordat u publiceert, klikt u op Terugkeren als u besluit dat u de wijzigingen die u hebt aangebracht niet wilt behouden. Wanneer u de wijzigingen terugdraait, is de configuratie van de livestatus ongewijzigd en wordt het tabblad Configuratie teruggezet zodat deze overeenkomt met de livestatus.

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 Nieuw in het menu Bestand en kies Vervolgens Project.

  3. Selecteer in het venster Nieuw projectVisual C# / Web / ASP.NET Core Web Application, geef uw project een naam en klik op OK.

    Schermopname van het venster Nieuw project

  4. Selecteer in het venster Nieuwe ASP.NET Core Web Applicationde optie Webtoepassing en klik op OK.

    Schermopname van het venster Nieuwe web-app

index.cshtml bewerken

  1. Vouw in Solution ExplorerPagina's 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-element en een div toe om als container te fungeren.

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

  4. Schuif op de pagina Gehoste gebruikersinterface omlaag naar de sectie getiteld De gebruikersinterface gebruiken. Klik op de eindpunten om toegang te krijgen tot het JavaScript-fragment. U kunt ook naar het fragment gaan door te klikken op Productie en vervolgens op het tabblad Gehoste gebruikersinterface .

  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 Solution Explorer met de rechtermuisknop op wwwroot en klik op Weergeven in browser.

    Schermopname van Solution Explorer waarin Weergave in browser wordt geselecteerd in het contextmenu wwwroot

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

Schermopname van aangepaste zoekwebpagina

Het uitvoeren van een zoekopdracht levert resultaten op als deze:

Schermopname van aangepaste zoekresultaten

Volgende stappen

Bing Custom Search-eindpunt aanroepen (C#)