DocumentationCommerceGestion des catalogues

Configuration de la recherche catalogue

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Débutant
  • Intermédiaire
  • Administration
  • Leader
  • Utilisateur ou utilisatrice

Il existe deux variantes de la configuration de la recherche catalogue . La première méthode décrit les paramètres disponibles lors de l’installation de Live Search. La deuxième méthode décrit les paramètres de configuration d’Adobe Commerce natif avec OpenSearch.

NOTE
Pour les projets d’infrastructure cloud, consultez les instructions supplémentaires dans le guide Commerce sur les infrastructures cloud.

Méthode 1 : Adobe Commerce avec Live Search

  1. Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.

  2. Dans le panneau de gauche, développez Catalog et choisissez Catalog en dessous.

  3. Développez Sélecteur d’extension la section Catalog Search .

    Recherche catalogue pour Live Search {width="600" modal="regular"}

    Pour obtenir une liste détaillée de ces options, consultez Adobe Commerce avec recherche en direct dans la Référence de configuration.

  4. Pour limiter la longueur et le nombre de mots du texte de la requête de recherche, définissez une valeur pour Minimal Query Length et Maximum Query Length.

  5. Pour limiter la quantité de résultats de recherche populaires à mettre en cache pour des réponses plus rapides, définissez une quantité de Number of top search results to cache.

    La valeur par défaut est 100. La saisie d’une valeur 0 met en cache tous les termes et résultats de recherche lorsqu’elle est effectuée une seconde fois.

  6. Pour modifier le nombre maximal de lignes disponibles pour les résultats renvoyés dans la fenêtre contextuelle storefront, saisissez une autre valeur de Autocomplete Limit.

    Limiter le nombre de lignes améliore les performances des recherches et réduit la taille de la liste renvoyée. La valeur par défaut est 8 lignes.

Méthode 2 : Commerce avec OpenSearch

IMPORTANT
  • En raison de l’annonce de fin de prise en charge Elasticsearch 7 d’août 2023, il est recommandé à tous les clients Adobe Commerce de migrer vers le moteur de recherche OpenSearch 2.x. Pour plus d’informations sur la migration de votre moteur de recherche pendant la mise à niveau du produit, voir Migration vers OpenSearch dans le Guide de mise à niveau.
  • Dans les versions 2.4.4 et 2.4.3-p2, tous les champs libellés Elasticsearch s’appliquent également à OpenSearch. Lorsque la prise en charge d’Elasticsearch 8.x a été introduite dans la version 2.4.6, de nouveaux libellés ont été créés pour faire la distinction entre les configurations Elasticsearch et OpenSearch. Toutefois, les options de configuration pour les deux sont identiques.

Étape 1 : Configurer les options de recherche générales

NOTE
Avec OpenSearch et Elasticsearch, il n’existe aucune prise en charge prête à l’emploi de la recherche par suffixe . Par exemple, la recherche par SKU peut ne pas renvoyer le résultat attendu si le mot-clé contient uniquement la partie de fin du SKU.

  1. Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.

  2. Dans le panneau de gauche, développez Catalog et choisissez Catalog en dessous.

  3. Développez Sélecteur d’extension la section Catalog Search .

    Paramètres du moteur de recherche {modal="regular"}

    Pour plus d’informations sur ces options, consultez Adobe Commerce avec recherche native dans la Référence de configuration.

  4. Pour limiter la longueur et le nombre de mots du texte de la requête de recherche, définissez une valeur pour Minimal Query Length et Maximum Query Length.

    note important
    IMPORTANT
    La valeur définie pour cette plage minimale et maximale doit être compatible avec la plage correspondante définie dans votre configuration de moteur de recherche. Par exemple, si vous définissez ces valeurs sur 2 et 300 dans Commerce, mettez à jour les valeurs correspondantes dans votre moteur de recherche.

  5. Pour limiter la quantité de résultats de recherche populaires à mettre en cache pour des réponses plus rapides, définissez une quantité de Number of top search results to cache.

    La valeur par défaut est 100. La saisie d’une valeur 0 met en cache tous les termes et résultats de recherche lorsqu’elle est effectuée une seconde fois.

  6. Si vous souhaitez activer ou désactiver l’indexeur AEP du produit, définissez la Enable EAV Indexer .

    Cette fonctionnalité améliore la vitesse d’indexation et limite l’utilisation de l’indexeur par les extensions tierces.

  7. Pour limiter le nombre maximal de résultats de recherche à afficher pour la saisie semi-automatique de la recherche, définissez un montant pour Autocomplete Limit.

    Limiter ce nombre améliore les performances des recherches et réduit la taille de la liste affichée. La valeur par défaut est 8.

Étape 2 : Configurer la connexion OpenSearch

IMPORTANT
Les champs Search Engine, OpenSearch Server Hostname, OpenSearch Server Port, OpenSearch Index Prefix, Enable OpenSearch HTTP Auth et OpenSearch Server Timeout ont été configurés lors de l’installation ou de la mise à niveau de Commerce. Ces valeurs ne doivent être modifiées que lors de la mise à niveau ou de la modification d’OpenSearch.

  1. Par Search Engine, sélectionnez OpenSearch.

  2. Par OpenSearch Server Hostname, acceptez la valeur par défaut configurée lors de l’installation de Commerce.

  3. Par OpenSearch Server Port, acceptez la valeur par défaut configurée lors de l’installation de Commerce.

    Dans cet exemple, la valeur par défaut est 9200.

  4. Par OpenSearch Index Prefix, saisissez un préfixe pour identifier l’index Elasticsearch.

    La valeur par défaut est magento2.

  5. Pour utiliser l’authentification HTTP afin d’inviter un nom d’utilisateur et un mot de passe à accéder au serveur OpenSearch, définissez Enable OpenSearch HTTP Auth sur Yes.

  6. Par OpenSearch Server Timeout, saisissez le nombre de secondes avant l’expiration du système.

    La valeur par défaut est 15.

  7. Pour vérifier la configuration, cliquez sur Test Connection.

Étape 3 : configuration des suggestions et des recommandations

NOTE
Les suggestions et recommandations de recherche peuvent avoir une incidence sur les performances du serveur.

  1. Pour proposer des recommandations, définissez Enable Search Recommendations sur Yes et procédez comme suit :

    • Par Search Recommendation Count, saisissez le nombre de recommandations à offrir.

    • Pour afficher le nombre de résultats trouvés pour chaque recommandation, définissez Show Results Count for Each Recommendation sur Yes.

  2. Définissez Enable Search Suggestions sur Yes et procédez comme suit :

    • Par Search Suggestions Count, saisissez le nombre de suggestions de recherche à proposer.

    • Pour afficher le nombre de résultats trouvés pour chaque suggestion, définissez Show Results for Each Suggestion sur Yes.

Étape 4 : Configurer les conditions minimales à faire correspondre

Pour contrôler le nombre minimum de termes de votre requête que les résultats de la recherche doivent correspondre pour le retour, spécifiez une valeur pour Minimum Terms to Match. La spécification de cette valeur garantit une pertinence optimale des résultats pour les acheteurs. Pour obtenir la liste des valeurs acceptées, voir le paramètre minimum_should_match dans la documentation d’OpenSearch.

Cliquez ensuite sur Save Config.

recommendation-more-help
af062d56-f22c-4537-813d-bedf8b92a071