Configurez pour la réussite avec Live Search

Adobe Commerce Live Search et Catalog Service collaborez pour offrir une solution de recherche performante, pertinente et intuitive afin de permettre à vos clients de trouver rapidement ce dont ils ont exactement besoin. Plus précisément : Catalog Service affiche vos données de catalogue pour les services SaaS, comme Live Search à utiliser.

Cet article fournit des instructions détaillées pour la mise en oeuvre de Live Search avec Catalog Service.

IMPORTANT
En ce qui concerne la recherche de site, Adobe Commerce vous offre des options. Veillez à lire Limites et limites avant l’implémentation, pour vérifier Live Search est adapté aux besoins de votre entreprise.

Audience

Cet article est destiné au développeur ou à l’intégrateur de systèmes de votre équipe responsable de l’installation et de la configuration de votre instance Adobe Commerce.

Conditions

Plateformes prises en charge

  • Adobe Commerce on Cloud (CEE) : 2.4.4+
  • Adobe Commerce on-premise (EE) : 2.4.4+

Workflow - Aperçu

à un niveau élevé ; Live Search requiert que vous :

Processus de recherche en direct

1. Installez le Live Search extension

Live Search est installé en tant qu’extension de Adobe Marketplace through Compositeur. Après avoir installé et configuré Live Search, ADOBE Commerce Commence à partager les données de recherche et de catalogue avec les services SaaS. À ce stade, Administration les utilisateurs peuvent configurer, personnaliser et gérer des facettes de recherche, des synonymes et des règles de marchandisage.

NOTE
À partir de Live Search 3.0.2, la variable Catalog Service l’extension est regroupée avec la fonction Live Search installation.
  1. Confirmez que tâches cron et indexeurs sont en cours d’exécution.

    note important
    IMPORTANT
    En raison de l’annonce de fin de prise en charge de 7 Elasticsearch pour 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 lors d’une mise à niveau de produit, voir Migration vers OpenSearch dans le Guide de mise à niveau.
  2. Téléchargez la live-search du module Adobe Marketplace.

  3. Exécutez la commande suivante à partir de la ligne de commande :

    code language-bash
    composer require magento/live-search
    

    Si vous ajoutez l’événement Live Search d’une extension new Installation d’Adobe Commerce, exécutez les opérations suivantes pour désactiver OpenSearch et les modules connexes, puis installez Live Search. Passez ensuite à l’étape 4.

    code language-bash
       bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch7 Magento_OpenSearch Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch Magento_ElasticsearchCatalogPermissionsGraphQl
    

    Si vous ajoutez l’événement Live Search d’une extension existant Pour désactiver temporairement l’installation d’Adobe Commerce, procédez comme suit : Live Search modules qui diffusent les résultats de recherche storefront. Passez ensuite à l’étape 4 :

    code language-bash
       bin/magento module:disable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover Magento_LiveSearchProductListing
    

    Elasticsearch continue à gérer les requêtes de recherche à partir du storefront pendant que la fonction Live Search Le service synchronise les données du catalogue et indexe les produits en arrière-plan.

  4. Exécutez les opérations suivantes :

    code language-bash
    bin/magento setup:upgrade
    
  5. Vérifiez que les indexeurs sont définis sur "Mise à jour par planification" :

    • Flux de produit
    • Flux de variante de produit
    • Flux d’attributs du catalogue
    • Flux de prix du produit
    • Portée du flux de données du site web
    • Portée Flux de données de groupes de clients
    • Flux de catégories
    • Flux d’autorisations de catégorie
  6. Si vous installez Live Search sur une nouvelle instance Commerce, vous avez terminé et vous pouvez accéder à la fonction 2. Configuration des clés d’API . Si vous installez Live Search sur une instance Commerce existante, passez à l’étape suivante.

  7. Exécutez les commandes suivantes pour activer la fonction Live Search extension, désactiver OpenSearch, puis exécutez setup.

    code language-bash
    bin/magento module:enable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover  Magento_LiveSearchProductListing
    
    code language-bash
    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch
    Magento_ElasticsearchCatalogPermissionsGraphQl
    
    code language-bash
    bin/magento setup:upgrade
    

2. Configuration des clés d’API

La clé d’API Adobe Commerce et sa clé privée associée sont nécessaires pour se connecter. Live Search à une installation d’Adobe Commerce. La clé API est générée et conservée dans le compte de la variable Commerce titulaire de la licence, qui peut la partager avec le développeur ou l’intégrateur de systèmes. Le développeur peut ensuite créer et gérer les espaces de données SaaS pour le compte du détenteur de licence. Si vous disposez déjà d’un ensemble de clés d’API, vous n’avez pas besoin de les régénérer.

Découvrez comment configurer vos clés d’API dans le Connecteur Commerce Services article.

3. Synchroniser les données de votre catalogue synchronize-catalog-data

Live Search déplace les données du catalogue vers l’infrastructure SaaS d’Adobe. Les données sont indexées et les résultats de la recherche sont diffusés de cet index directement sur le storefront. Selon la taille et la complexité, l’indexation peut prendre de 30 minutes à quelques heures.

Pour commencer la synchronisation initiale de vos données de catalogue avec les services SaaS, exécutez les commandes suivantes dans cet ordre :

bin/magento saas:resync --feed productattributes
bin/magento saas:resync --feed products
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed productoverrides
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed categoryPermissions

Lorsque vous exécutez ces commandes, la synchronisation initiale des données de votre catalogue avec les services SaaS démarre.

WARNING
Bien que les données soient indexées et synchronisées, les opérations de recherche et de navigation de catégorie ne sont pas disponibles dans le storefront. Selon la taille de votre catalogue, le processus peut prendre au moins une heure à partir du cron s’exécute pour synchroniser vos données avec les services SaaS.

Surveillance de la progression de la synchronisation

Vous pouvez afficher les données synchronisées et partagées à l’aide de la variable Tableau de bord de la gestion des données. Ce tableau de bord fournit des informations précieuses sur la disponibilité des données de produit pour votre storefront, afin qu’elles puissent être rapidement affichées pour vos clients.

Tableau de bord de la gestion des données

Futures mises à jour des produits

Après la synchronisation initiale, il peut s’écouler jusqu’à 15 minutes avant que les mises à jour incrémentielles des produits ne soient disponibles pour la recherche storefront. Pour en savoir plus, voir Indexation - Mises à jour des produits en flux continu.

4. Vérifier que les données ont été exportées verify-export

Pour vérifier que les données du catalogue ont été exportées à partir de votre instance Adobe Commerce et sont synchronisées pour Live Search, vous disposez de plusieurs options :

  • Recherchez des entrées dans les tableaux suivants :

    • catalog_data_exporter_products
    • catalog_data_exporter_product_attributes
  • Utilisez la variable Jeu GraphQL avec la requête par défaut pour vérifier les éléments suivants :

    • Le nombre de produits renvoyé est proche de ce que vous attendez pour la vue de magasin.
    • Les facettes sont renvoyées.

Pour obtenir une aide supplémentaire, voir Live Search catalogue non synchronisé dans la base de connaissances d’assistance.

5. Configurer les données

La configuration correcte des données de vos produits garantit de bons résultats de recherche pour vos clients. Dans cette section, vous activez les widgets de liste de produits et affectez des catégories et des attributs.

Activation des widgets de liste de produits

Lors de l’installation Live Search 4.0.0+, les widgets de liste de produits sont activés par défaut. Lorsque les widgets sont activés, un composant d’interface utilisateur différent est utilisé pour la page des résultats de recherche et la page de liste des produits du navigateur de catégorie. Ce composant d’IU effectue des appels directs vers API Catalog Service, ce qui se traduit par des temps de réponse plus rapides.

Si vous avez une Live Search version antérieure à 4.0.0+, vous devez activer manuellement le widget de liste de produits.

  1. Dans la Administration, accédez à Stores > Settings>Configuration.

  2. Sous Live Search, sélectionnez Storefront Features.

  3. Définir Enable Product Listing Widgets to Yes.

    Activation des widgets de liste de produits

Lorsque vous modifiez cette configuration, le message Page cache is invalidated apparaît. Vous devez vider le cache du Magento pour enregistrer votre modification.

  1. Accédez au Gestion du cache en effectuant l’une des opérations suivantes :

    • Cliquez sur le bouton Cache Management dans le message situé au-dessus de l’espace de travail.
    • Sur le Administration barre latérale, accédez à System > Tools>Cache Management.
  2. Sélectionnez la variable Configuration Cache Type et cliquez sur Flush Magento Cache.

    Les modifications apportées au storefront sont immédiates une fois le cache vidé.

Attribution de catégories

Produits renvoyés dans Live Search doit être affecté à une category. Dans Luma, par exemple, les produits sont classés dans des catégories telles que "Hommes", "Femmes" et "Porcs". Les sous-catégories sont également configurées pour "Tops", "Bottoms" et "Montres". Cela permet une meilleure granularité lors du filtrage.

Champs indexables et filtrables

Les produits sont attribués Attributs qui peuvent être utilisés pour la recherche et le filtrage. Les attributs sont des éléments tels que "Couleur", "Taille", "Type de matière". Avec ces attributs, les utilisateurs peuvent rechercher des "ordinateurs verts". De nombreux attributs peuvent être définis dans chaque produit. Commerce Administrateur.

Chacun de ces attributs peut être défini comme "searchable" dans Admin. Lorsqu’ils sont définis sur "pouvant faire l’objet d’une recherche", ces attributs peuvent être recherchés par Live Search.

Facettes sont des attributs de produit définis dans Live Search pour être filtrable. Tout attribut filtrable peut être défini comme une facette dans Live Search mais il existe des limites au nombre de facettes pouvant être recherchées simultanément.

Synonymes sont des termes que vous pouvez définir pour guider les utilisateurs vers le produit approprié. Les utilisateurs qui recherchent un pantalon peuvent taper "pantalon" ou "pantalons". Vous pouvez définir des synonymes de sorte que ces termes de recherche amènent les utilisateurs aux résultats "pantalon".

6. Tester la connexion test-connection

Maintenant que vos données de catalogue sont dans SaaS, vérifiez que les données de produit sont renvoyées dans les scénarios suivants :

  • La variable Search la zone renvoie les résultats correctement
  • La navigation dans les catégories renvoie correctement les résultats.
  • Les facettes sont disponibles sous forme de filtres sur les pages de résultats de recherche.

Si tout fonctionne correctement, Live Search est installé, connecté et prêt à l’emploi.

Si vous rencontrez des problèmes dans le storefront, vérifiez la variable var/log/system.log pour les erreurs ou échecs de communication de l’API côté services.

Pour autoriser Live Search via un pare-feu, ajoutez commerce.adobe.io à la liste autorisée.

7. Personnaliser pour votre vitrine

Vous avez installé le Live Search extension, synchronisé, validé et configuré vos données. Vous allez maintenant vous assurer que la variable Live Search Les widgets sont conformes à l’aspect de votre boutique.

Vous pouvez mettre en forme la fenêtre contextuelle et les widgets PLP en définissant des règles CSS personnalisées si nécessaire. Voir Style des éléments contextuels et Widget de page de liste de produits.

Si vous souhaitez étendre les fonctionnalités des widgets, le code source de chacun d’eux est disponible dans un référentiel public.
Dans ce scénario, vous pouvez personnaliser le code JavaScript en fonction de vos besoins, puis héberger votre code personnalisé sur votre réseau de diffusion de contenu. Ce script personnalisé communique avec la variable Live Search et renvoie les résultats comme s’ils étaient normaux, ce qui vous permet de contrôler les fonctionnalités du widget.

Mise à jour Live Search update

Avant de mettre à jour la recherche en direct, exécutez le code suivant depuis la ligne de commande pour vérifier la version de la recherche en direct installée :

composer show magento/module-live-search | grep version

Pour mettre à jour Live Search, exécutez les opérations suivantes à partir de la ligne de commande :

composer update magento/live-search --with-dependencies

Pour effectuer une mise à jour vers une version majeure, telle que de 3.1.1 à 4.0.0, modifiez la racine du projet. Composer .json comme suit :

  1. Si votre magento/live-search version est 3.1.1 ou version inférieure et que vous effectuez une mise à niveau vers la version 4.0.0 ou supérieur, exécutez la commande suivante avant la mise à niveau :

    code language-bash
    bin/magento module:enable Magento_AdvancedSearch
    

    Pour plus d’informations sur la version actuellement installée magento/live-search version, exécutez la commande suivante :

    code language-bash
    composer show magento/live-search
    
  2. Ouvrez la racine composer.json fichier et recherchez magento/live-search.

  3. Dans le require , mettez à jour le numéro de version comme suit :

    code language-json
    "require": {
       ...
       "magento/live-search": "^4.0",
       ...
     }
    
  4. Enregistrer composer.json. Exécutez ensuite la commande suivante à partir de la ligne de commande :

    code language-bash
    composer update magento/live-search --with-dependencies
    

Désinstallation Live Search uninstall

Pour désinstaller Live Search, voir Désinstallation des modules.

Live Search packages packages

La variable Live Search L’extension se compose des packages suivants :

Package
Description
module-live-search
Permet aux commerçants de configurer leurs paramètres de recherche pour la facette, les synonymes, les règles de requête, etc., et permet d’accéder à un terrain de jeu GraphQL en lecture seule pour tester les requêtes à partir de la variable Administration.
module-live-search-adapter
Permet d’acheminer les requêtes de recherche du storefront vers le Live Search et effectue le rendu des résultats dans le storefront.
- Navigation dans les catégories - achemine les demandes depuis le storefront navigation supérieure au service de recherche.
- Recherche globale - achemine les requêtes de la recherche rapide dans le coin supérieur droit du storefront vers la propriété Live Search service.
module-live-search-storefront-popover
Une fenêtre contextuelle "Rechercher lorsque vous tapez" remplace la recherche rapide standard et renvoie les données et les miniatures des principaux résultats de la recherche.

Live Search dependencies dependencies

Les éléments suivants Live Search les dépendances sont capturées par Composer.

  • magento/module-saas-catalog
  • magento/module-saas-category
  • magento/module-saas-category-permissions
  • magento/module-saas-product-override
  • magento/module-saas-product-variant
  • magento/module-saas-price
  • magento/module-saas-scopes
  • magento/module-bundle-product-data-exporter
  • magento/module-catalog-inventory-data-exporter
  • magento/module-catalog-url-rewrite-data-exporter
  • magento/module-configurable-product-data-exporter
  • magento/module-parent-product-data-exporter
  • magento/module-gift-card-product-data-exporter
  • magento/module-bundle-product-override-data-exporter
  • data-services
  • services-id

Concepts avancés

Les sections suivantes contiennent des rubriques plus avancées lorsque vous utilisez Live Search et Catalog Service.

Point d’entrée

Live Search communique par le biais du point de terminaison à l’adresse https://catalog-service.adobe.io/graphql.

As Live Search n'a pas accès à la base de données complète des produits, Live Search GraphQL et Commerce core GraphQL n’auront pas une parité complète.

Il est recommandé d’appeler directement les API SaaS, en particulier le point d’entrée du service de catalogue.

  • Obtenir des performances et réduire la charge du processeur en contournant le processus base de données Commerce/Graphql
  • Profitez de la fonction Catalog Service fédération à appeler Live Search, Catalog Service, et Product Recommendations à partir d’un seul point de terminaison.

Pour certains cas d’utilisation, il peut être préférable d’appeler Catalog Service pour plus d’informations sur les produits et les cas similaires. Voir refineProduct pour plus d’informations.

Si vous disposez d’une implémentation personnalisée sans interface utilisateur graphique, extrayez le Live Search implémentations de référence :

Si vous n’utilisez pas les composants par défaut, tels que l’adaptateur de recherche ou les widgets sur Luma ou les widgets d’AEM CIF, les événements (données de parcours de navigation qui alimentent Adobe Sensei pour les mesures de marchandisage et de performances intelligentes) ne fonctionneront pas immédiatement et nécessitent un développement personnalisé pour implémenter des événements sans interface.

La dernière version de Live Search utilise déjà Catalog Service.

Prise en charge linguistique

Live Search Les widgets prennent en charge les langues suivantes :

Langue
Région
Code de langue
Paramètres régionaux du Magento
Bulgare
Bulgarie
bg_BG
bg_BG
Catalan
Espagne
ca_ES
ca_ES
Tchèque
République tchèque
cs_CZ
cs_CZ
Danois
Danemark
da_DK
da_DK
Allemand
Allemagne
de_DE
de_DE
Grec
Grèce
el_GR
el_GR
Anglais
Royaume-Uni
en_GB
en_GB
Anglais
États-Unis
en_US
en_US
Espagnol
Espagne
es_ES
es_ES
Estonien
Estonie
et_EE
et_EE
Basque
Espagne
eu_ES
eu_ES
Perse
Iran
fa_IR
fa_IR
Finnois
Finlande
fi_FI
fi_FI
Français
France
fr_FR
fr_FR
Galicien
Espagne
gl_ES
gl_ES
Hindi
Inde
hi_IN
hi_IN
Hongrois
Hongrie
hu_HU
hu_HU
Indonésien
Indonésie
id_ID
id_ID
Italien
Italie
it_IT
it_IT
Coréen
Corée du Sud
ko_KR
ko_KR
Lituanien
Lituanie
lt_LT
lt_LT
Letton
Lettonie
lv_LV
lv_LV
Norvégien
Norvège, bokmal
nb_NO
nb_NO
Néerlandais
Pays
nl_NL
nl_NL
Polonais
Pologne
pl_PL
pl_PL
Portuge
Brésil
pt_BR
pt_BR
Portuge
Portugal
pt_PT
pt_PT
Roumain
Roumanie
ro_RO
ro_RO
Russe
Russie
ru_RU
ru_RU
Suédois
Suède
sv_SE
sv_SE
Thaï
Thaïlande
th_TH
th_TH
Turc
Turquie
tr_TR
tr_TR
Chinois
Chine
zh_CN
zh_Hans_CN
Chinois
Taiwan
zh_TW
zh_Hant_TW

Si le widget détecte que le paramètre de langue d’administration de Commerce (Magasins > Paramètres > Configuration > Général > Options de pays) correspond à une langue prise en charge. Par défaut, cette langue est utilisée. Sinon, les widgets sont définis par défaut sur Anglais.

Les administrateurs peuvent également définir la langue de la variable index de recherche, pour améliorer les résultats de la recherche.

Référentiel de code de widget

Le widget Page de liste de produits et le widget Champ de recherche en direct peuvent tous deux être téléchargés à partir de leur référentiel github.

Cela permet aux développeurs de personnaliser entièrement les fonctionnalités et le style. Ces utilisateurs hébergent le code eux-mêmes tout en tirant parti de la fonction Live Search service.

Inventory management

Live Search prend Inventory management Fonctionnalités de Commerce (anciennement appelées inventaire multi-source ou MSI). Pour activer la prise en charge complète, vous devez update le module de dépendance ; commerce-data-export vers la version 102.2.0+.

Live Search renvoie une valeur booléenne indiquant si un produit est disponible dans Inventory management, mais ne contient pas d’informations sur la source qui possède le stock.

Indexateur de prix

Les clients Live Search peuvent utiliser la nouvelle Indexeur de prix SaaS, qui accélère les mises à jour des changements de prix et le temps de synchronisation.

Prise en charge des prix

Les widgets de recherche en direct prennent en charge la plupart, mais pas tous les types de prix pris en charge par Adobe Commerce.

Actuellement, les prix de base sont pris en charge. Les prix avancés non pris en charge sont les suivants :

  • Coût
  • Prix publicitaire minimal

Regarder Mesh de l’API pour des calculs de prix plus complexes.

Le format de prix prend en charge le paramètre de configuration des paramètres régionaux dans l’instance Commerce : Magasins > Paramètres > Configuration > Général > Général > Options locales > Paramètres régionaux.

Prise en charge de storefront sans interface

Si vous le souhaitez, vous devrez peut-être installer le module-data-services-graphql qui étend la couverture GraphQL existante de l’application afin d’inclure les champs requis pour la collecte de données comportementales storefront.

composer require magento/module-data-services-graphql

Ce module ajoute des contextes supplémentaires aux requêtes GraphQL :

  • dataServicesStorefrontInstanceContext
  • dataServicesMagentoExtensionContext
  • dataServicesStoreConfigurationContext

Prise en charge des PWA

Live Search fonctionne avec PWA Studio, mais les utilisateurs peuvent voir de légères différences par rapport aux autres mises en oeuvre de Commerce. Les fonctionnalités de base telles que la recherche et la liste de produits fonctionnent dans Venia, mais certaines permutations de Graphql peuvent ne pas fonctionner correctement. Il peut également y avoir des différences de performances.

  • L’implémentation actuelle du PWA de Live Search nécessite plus de temps de traitement pour renvoyer les résultats de recherche que Live Search avec la vitrine Commerce native.
  • Live Search dans PWA ne prend pas en charge gestion des événements. Par conséquent, les rapports de recherche et le marchandisage intelligent fonctionneront.
  • Filtrage directement sur description, name, short_description n’est pas pris en charge par GraphQL lorsqu’il est utilisé avec PWA, mais ils sont renvoyés avec un filtre plus général.

Pour utiliser Live Search avec PWA Studio, les intégrateurs doivent également :

  1. Installer livesearch-storefront-utils.

  2. Définissez la variable environmentId dans le storeDetails .

    code language-javascript
    const storeDetails: StoreDetailsProps = {
        environmentId: <Storefront_ID>,
        websiteCode: "base",
        storeCode: "main_website_store",
        storeViewCode: "default",
        searchUnitId: searchUnitId,
        config: {
            minQueryLength: 5,
            pageSize: 8,
            currencySymbol: "$",
            },
        };
    

Cookies

Live Search collecte des données d’interaction utilisateur dans le cadre de ses fonctionnalités de base et utilise des cookies pour stocker ces données. Lors de la collecte de toute information utilisateur, l’utilisateur doit accepter de stocker les cookies. Live Search et Product Recommendations partagez le flux de données et, par conséquent, le même mécanisme de cookie. En savoir plus à ce sujet dans Gérer les restrictions de cookie.

recommendation-more-help
1d60634e-b73a-404a-be7a-4a2a36676055