Configurer votre expérience d’interface utilisateur hébergée

Article
02/12/2019

Avertissement

Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.

Le service Recherche personnalisée Bing fournit une interface utilisateur hébergée que vous pouvez facilement intégrer à vos applications et pages web en tant qu’extrait de code JavaScript. À l’aide du portail Recherche personnalisée Bing, vous pouvez configurer la mise en page, la couleur et les options de recherche de l’interface utilisateur.

Configuration de l’interface utilisateur hébergé personnalisée

Pour configurer une interface utilisateur hébergée pour vos applications web, procédez comme suit. Lorsque vous apportez des modifications, le volet de droite vous fournira un aperçu de votre interface utilisateur. Les résultats de recherche qui sont affichés ne sont pas les résultats réels de votre instance.

Connectez-vous au portail de la Recherche personnalisée Bing.
Sélectionnez votre instance de Recherche personnalisée Bing.
Cliquez sur l’onglet Hosted UI (IU hébergée).
Sélectionnez une disposition.
- Barre de recherche et résultats (par défaut) : Affiche une zone de recherche avec les résultats de la recherche en dessous.
- Résultats uniquement : Affiche uniquement les résultats de la recherche, sans zone de recherche. Lorsque vous utilisez cette mise en page, vous devez fournir la requête de recherche (&q=<query string>). Ajoutez le paramètre de requête à l’URL de requête dans l’extrait de code JavaScript, ou le lien vers le point de terminaison HTML.
- Fenêtre superposée glissante : Fournit une zone de recherche et affiche les résultats de recherche dans une fenêtre glissante qui vient se superposer à la fenêtre actuelle.
Sélectionnez un thème de couleur. Vous pouvez personnaliser les couleurs en fonction de votre application en cliquant sur Customize theme (Personnaliser le thème). Pour modifier une couleur, entrez la valeur hexadécimale de couleur RVB (par exemple, #366eb8), ou cliquez sur l’aperçu de la couleur.

Vous pouvez consulter un aperçu de vos modifications sur le côté droit du portail. En cliquant sur Reset to default (Rétablir les valeurs par défaut), vous rétablissez les couleurs par défaut du thème sélectionné.

Notes

Lors du choix des couleurs, pensez à l’accessibilité.
Sous Additional Configurations (Configurations supplémentaires), fournissez des valeurs en fonction de votre application. Ces paramètres sont facultatifs. Pour voir l’effet de leur application ou de leur suppression, regardez le volet de visualisation situé à droite. Voici les options de configuration disponibles :
Entrez la clé d’abonnement de la recherche, ou sélectionnez-en une dans la liste déroulante. La liste déroulante est remplie avec les clés des abonnements de votre compte Azure. Consultez Compte d’API Azure AI Services.
Si vous avez activé la suggestion automatique, entrez la clé d’abonnement de la suggestion automatique, ou sélectionnez-en une dans la liste déroulante. La liste déroulante est remplie avec les clés des abonnements de votre compte Azure. La Suggestion automatique personnalisée nécessite un niveau d’abonnement spécifique. Pour plus d’informations, consultez les Tarifs.

Publier ou annuler

Les modifications que vous apportez à une instance Recherche personnalisée sont effectuées dans l’onglet Configuration pour que vous puissiez valider vos modifications. Lorsque vos modifications sont terminées et que vous êtes prêt à les publier, cliquez sur Publish (Publier). Les modifications n’apparaissent sur vos points de terminaison de production qu’après leur publication.

Avant la publication, si vous décidez de ne pas conserver les modifications que vous avez effectuées, cliquez sur Revert (Rétablir). Lorsque vous annulez vos modifications, la configuration de l’état en direct demeure inchangée et l’onglet Configuration est rétabli pour correspondre à cet état.

Consommer l’interface utilisateur personnalisée

Pour consommer l’IU hébergée, soit vous :

Incluez le script dans votre page 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>

Vous pouvez également utiliser l’URL suivante dans un navigateur web.

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

Ajoutez les paramètres de requête suivants à l’URL selon vos besoins. Pour plus d’informations sur ces paramètres, consultez la référence API Recherche personnalisée.
- q
- mkt
- safesearch
- setlang
Important

La page ne peut pas afficher votre déclaration de confidentialité, ou d’autres mentions et conditions. L’adéquation à votre utilisation peut varier.

Pour obtenir plus d’informations, y compris votre ID de configuration personnalisée, accédez à Endpoints (Points de terminaison) sous l’onglet Production (Production).

Options de configuration

Vous pouvez configurer le comportement de votre interface utilisateur hébergée en cliquant sur Configurations supplémentaireset en fournissant les valeurs de votre choix. Ces paramètres sont facultatifs. Pour voir l’effet de leur application ou de leur suppression, regardez le volet de visualisation situé à droite.

Configurations de la recherche web :

Résultats web activés : Détermine si la recherche sur le Web est activée (si c’est le cas, vous voyez l’onglet Web en haut de la page).
Activer la suggestion automatique : Détermine si la suggestion automatique personnalisée est activée (voir les Tarifs pour connaître les frais supplémentaires).
Résultats web par page : Nombre de résultats à afficher pour une recherche sur le Web (le maximum est de 50 résultats par page).
Légende d’image : Détermine si des images sont affichées avec les résultats de la recherche

Les configurations suivantes sont affichées si vous cliquez sur Show advanced configurations (Afficher les configurations avancées).

Mettre les mots en surbrillance : Détermine si les résultats sont affichés avec les termes de la recherche en gras.
Cible du lien : Détermine si la page web s’ouvre dans un nouvel onglet de navigateur (vide) ou dans le même onglet de navigateur lorsque l’utilisateur clique sur un résultat de recherche.

Configurations de la recherche d’images

Résultats d’images activés : Détermine si la recherche d’images est activée (si c’est le cas, vous voyez l’onglet Images en haut de la page).
Résultats d’images par page : Nombre de résultats à afficher pour une recherche d’images (le maximum est de 150 résultats par page).

La configuration suivante est affichée si vous cliquez sur Show advanced configurations (Afficher les configurations avancées).

Activer les filtres : Ajoute des filtres dont l’utilisateur peut se servir pour filtrer les images retournées par Bing. Par exemple, l’utilisateur peut filtrer les résultats pour n’afficher que des fichiers GIF animés.

Configurations pour la recherche de vidéos

Résultats de vidéos activés : Détermine si la recherche de vidéos est activée (si c’est le cas, vous voyez l’onglet Vidéos en haut de la page).
Résultats de vidéos par page : Nombre de résultats à afficher pour une recherche de vidéo (le maximum est de 150 résultats par page).

La configuration suivante est affichée si vous cliquez sur Show advanced configurations (Afficher les configurations avancées).

Activer les filtres : Ajoute des filtres dont l’utilisateur peut se servir pour filtrer les vidéos retournées par Bing. Par exemple, l’utilisateur peut filtrer les résultats pour n’afficher que les vidéos ayant une résolution spécifique ou les vidéos découvertes au cours des dernières 24 heures.

Configurations diverses

Titre de la page : Texte affiché dans la zone de titre de la page des résultats de recherche (ne s’applique pas à la disposition de fenêtre superposée glissante).
Thème de la barre d’outils : Détermine la couleur d’arrière-plan de la zone de titre de la page des résultats de recherche.