DocumentationGuide Live Search

Configuration pour la réussite avec Live Search

Last update: Mon Feb 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Administration
  • Développeur

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

Cet article fournit des instructions détaillées sur l’implémentation de Live Search avec Catalog Service.

IMPORTANT
En ce qui concerne la recherche de site, Adobe Commerce vous propose des options. Assurez-vous de lire Limites et limites avant d’effectuer l’implémentation pour vous assurer que Live Search correspond aux besoins de votre entreprise.

Audience

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

Conditions requises

Plateformes prises en charge

  • Adobe Commerce on Cloud (ECE) : 2.4.4+
  • Adobe Commerce on-prem (EE) : 2.4.4+

Présentation des workflows

À un niveau élevé, la Live Search d’intégration nécessite que vous :

  1. Installer l’extension Live Search
  2. Configurer les clés API
  3. Synchroniser les données de votre catalogue
  4. Vérifier que les données du catalogue ont été exportées
  5. Configurer les données
  6. Tester la connexion
  7. Vérifier que les événements capturent des données
  8. Personnaliser votre storefront

Live Search est installé en tant qu’extension depuis Adobe Marketplace via Composer. Une fois que vous avez installé et configuré Live Search, Adobe Commerce commence à partager des données de recherche et de catalogue avec les services SaaS. À ce stade, les utilisateurs administrateurs peuvent configurer, personnaliser et gérer les facettes de recherche, les synonymes et les règles de marchandisage.

NOTE
Depuis Live Search 3.0.2, l’extension Catalog Service est intégrée à l’installation Live Search.
IMPORTANT
Depuis Live Search version 4.0.0, la carte Search Adapter est obsolète. À l’avenir, l’adaptateur de recherche sera mis à jour uniquement pour résoudre les problèmes de sécurité.

  1. Vérifiez que les 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 d’Elasticsearch 7 en 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 une mise à niveau du produit, voir Migration vers OpenSearch dans le Guide de mise à niveau.

  2. Téléchargez le package live-search à partir de la place de marché Adobe.

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

    code language-bash 
    composer require magento/live-search

    Si vous ajoutez l’extension Live Search à une installation new Adobe Commerce, exécutez la commande suivante pour désactiver OpenSearch et les modules associés temporairement, 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’extension Live Search à une installation existante Adobe Commerce, exécutez la commande suivante pour désactiver les modules Live Search qui fournissent les résultats de la recherche dans Storefront. Passez ensuite à l’étape 4 :

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

    Elasticsearch continue de gérer les requêtes de recherche du storefront pendant que le service Live Search synchronise les données de 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 suivants sont définis sur « Mettre à jour selon le calendrier » :

    • Flux de produit
    • Flux de variante de produit
    • Flux d’attributs de catalogue
    • Flux des prix des produits
    • Étendue Du Flux De Données Du Site Web
    • Étendue du flux de données des groupes de clients
    • Flux de catégories
    • Flux d’autorisations des catégories

  6. Si vous installez Live Search sur une nouvelle instance de Commerce, vous avez terminé et pouvez passer à la 2. Configuration des clés API section . Si vous installez Live Search sur une instance Commerce existante, passez à l’étape suivante.

  7. Exécutez les commandes suivantes pour activer l’extension Live Search, désactiver OpenSearch et exécuter 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
IMPORTANT
La fonctionnalité suivante est en version bêta. Pour participer à la version bêta, envoyez une demande par e-mail à commerce-storefront-services.

Cette version Beta prend en charge trois nouvelles fonctionnalités dans la requête productSearch:

  • Recherche superposée - Effectuez une recherche dans un autre contexte de recherche - Grâce à cette fonctionnalité, vous pouvez effectuer jusqu’à deux couches de recherche pour vos requêtes de recherche. Par exemple :

    • Recherche de la couche 1 - Recherchez « Motor » sur « product_attribute_1 ».
    • Recherche de la couche 2 - Recherchez « référence 123 » sur « product_attribute_2 ». Dans cet exemple, le « moteur » est recherché dans les résultats par « numéro de pièce 123 ».

    La recherche en couches est disponible pour l’indexation de recherche startsWith et l’indexation de recherche contains, comme décrit ci-dessous :

  • startsWith search indexation - Effectuez une recherche à l’aide de l’indexation startsWith. Cette nouvelle fonctionnalité permet :

    • Recherche de produits dont la valeur d’attribut commence par une chaîne particulière.
    • La configuration d’une recherche « se termine par » afin que les acheteurs puissent rechercher des produits pour lesquels la valeur d’attribut se termine par une chaîne particulière. Pour activer une recherche « se termine par », l’attribut de produit doit être ingéré en inverse et l’appel API doit également être une chaîne inversée.

  • contient l’indexation de la recherche : recherchez un attribut à l’aide de l’indexation contient. Cette nouvelle fonctionnalité permet :

    • Recherche d’une requête dans une chaîne plus grande. Par exemple, si un acheteur recherche le numéro de produit « PE-123 » dans la chaîne « HAPE-123 ».

      • Remarque : ce type de recherche est différent de la recherche existante expression, qui effectue une recherche de saisie automatique. Par exemple, si la valeur de l’attribut de votre produit est « pantalon extérieur », une expression de recherche renvoie une réponse pour « out pan », mais ne renvoie pas de réponse pour « oor ants ». Une recherche Contient , cependant, renvoie une réponse pour « fourmis ».

Ces nouvelles conditions améliorent le mécanisme de filtrage des requêtes de recherche pour affiner les résultats de recherche. Ces nouvelles conditions n’affectent pas la requête de recherche principale.

Vous pouvez implémenter ces nouvelles conditions sur votre page de résultats de recherche. Par exemple, vous pouvez ajouter une nouvelle section sur la page où l’acheteur peut affiner davantage ses résultats de recherche. Vous pouvez permettre aux acheteurs de sélectionner des attributs de produit spécifiques, tels que « Fabricant », « Numéro de pièce » et « Description ». À partir de là, ils effectuent une recherche dans ces attributs à l’aide des conditions contains ou startsWith. Consultez le guide de l’administrateur pour obtenir une liste des attributs pouvant faire l’objet de recherches.

  1. Pour installer la version bêta, ajoutez la dépendance suivante à votre projet :

    code language-bash 
    composer require magento/module-live-search-search-types:"^1.0.0-beta1"

  2. Validez et envoyez les modifications à vos fichiers composer.json et composer.lock à votre projet cloud. En savoir plus.

    Cette version Beta ajoute Search types cases à cocher pour Autocomplete, Contains et Starts with dans l’interface d’administration. Elle met également à jour l’API productSearch GraphQL pour inclure ces nouvelles fonctionnalités de recherche.

  3. Dans Admin, définissez un attribut de produit pour pouvoir effectuer des recherches, puis spécifiez la fonctionnalité de recherche de cet attribut, par exemple Contient (par défaut) ou Commence par. Vous pouvez spécifier un maximum de six attributs à activer pour Contient et de six attributs à activer pour Commence par. Pour la version bêta, sachez que l’administrateur n’applique pas cette restriction, mais elle est appliquée dans les recherches d’API.

    Spécifier la fonctionnalité de recherche

  4. Consultez la documentation pour les développeurs pour savoir comment mettre à jour vos appels API Live Search à l’aide des nouvelles fonctionnalités de recherche contains et startsWith.

Descriptions des champs

Champ
Description
Autocomplete
Activé par défaut et non modifiable. Avec Autocomplete, vous pouvez utiliser contains dans le filtre de recherche. Ici, la requête de recherche dans contains renvoie une réponse de recherche de type saisie automatique. Adobe vous recommande d’utiliser ce type de recherche pour les champs de description, qui comportent généralement plus de 50 caractères.
Contains
Active une recherche « texte contenu dans une chaîne » au lieu d’une recherche de saisie semi-automatique. Utilisez contains dans le filtre de recherche. Pour plus d’informations, voir la section Limitations.
Starts with
Permet d’interroger des chaînes commençant par une valeur particulière. Utilisez startsWith dans le filtre de recherche.

2. Configuration des clés API

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

Découvrez comment configurer vos clés API dans l’article Connecteur de services Commerce.

3. Synchroniser les données de votre catalogue

Live Search déplace les données de catalogue vers l’infrastructure SaaS d’Adobe. Les données sont indexées et les résultats de la recherche sont directement transmis au storefront à partir de cet index. En fonction de la taille et de la complexité, l’indexation peut prendre de 30 minutes à quelques heures.

Pour commencer la synchronisation initiale des données de catalogue avec les services SaaS, exécutez les commandes suivantes dans l’ordre suivant :

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 commence.

WARNING
Bien que les données soient indexées et synchronisées, les opérations de recherche et de navigation par catégorie ne sont pas disponibles dans le storefront. En fonction de la taille de votre catalogue, le processus peut prendre au moins une heure à partir du moment où 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 du tableau de bord de 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 acheteurs.

Tableau de bord de gestion des données

Vous pouvez également exécuter des commandes de synchronisation et résoudre les problèmes de synchronisation à l’aide de l’interface de ligne de commande Commerce et des journaux d’extension d’exportation de 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, consultez Diffusion de mises à jour de produit dans la documentation sur l’indexation.

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

Pour vérifier si vos données de catalogue ont été exportées à partir d’Adobe Commerce et synchronisées avec Live Search, vous disposez de quelques options :

  • Recherchez des entrées dans les tableaux suivants :

    • cde_products_feed
    • cde_product_attributes_feed
    note note
    NOTE
    Si vous obtenez une erreur table does not exist, recherchez les entrées dans les tableaux catalog_data_exporter_products et catalog_data_exporter_product_attributes. Ces noms de table sont utilisés dans les versions Live Search antérieures à la version 4.2.1.

  • Utilisez le terrain de jeu GraphQL avec la requête par défaut (voir Référence de GraphQL pour plus de détails) pour vérifier les éléments suivants :

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

Pour obtenir de l’aide supplémentaire, consultez Live Search catalogue non synchronisé dans la base de connaissances du support.

5. Configuration des données

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

Activer les widgets de liste de produits

Lorsque vous installez Live Search version 4.0.0 ou ultérieure, les widgets de liste de produits sont activés par défaut. Lorsque les widgets sont activés, un autre composant d’interface utilisateur est utilisé pour la page des résultats de recherche et la page de liste des produits de navigation par catégorie. Ce composant de l’interface utilisateur effectue des appels directs à l’API Catalog Service, ce qui accélère les temps de réponse.

Si vous disposez d’une version de Live Search antérieure à 4.0.0 ou ultérieure, vous devez activer manuellement le widget Liste des produits.

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

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

  3. Définissez Enable Product Listing Widgets sur Yes.

    Activer les widgets de liste de produits

Lorsque vous modifiez cette configuration, le message Page cache is invalidated s’affiche. Vous devez vider le cache du Magento pour enregistrer votre modification.

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

    • Cliquez sur le lien Cache Management dans le message au-dessus de l’espace de travail.
    • Dans la barre latérale Admin, accédez à System > Tools>Cache Management.

  2. Sélectionnez le Cache Type Configuration et cliquez sur Flush Magento Cache.

    Les modifications apportées au storefront sont immédiates après avoir vidé le cache.

Attribuer des catégories

Les produits renvoyés dans Live Search doivent être affectés à une catégorie. Dans Luma, par exemple, les produits sont classés dans des catégories telles que « Hommes », « Femmes » et « Équipement ». Des sous-catégories sont également définies pour les « Tops », les « Bottoms » et les « Watches ». Ces affectations de catégorie améliorent la granularité lors du filtrage.

6. Tester la connexion

Maintenant que vos données de catalogue sont en SaaS, testez-les pour vous assurer que les données de produit sont renvoyées dans les scénarios suivants :

  • La zone de Search renvoie correctement les résultats
  • L’exploration des catégories renvoie correctement les résultats
  • Les facettes sont disponibles en tant que filtres dans 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 au niveau du storefront, vérifiez dans le fichier var/log/system.log les échecs ou les erreurs de communication de l’API côté services.

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

7. Vérifiez que les événements capturent des données

Assurez-vous que les événements storefront déployés sur votre site fonctionnent. Cela est particulièrement important pour les implémentations découplées.

8. Personnaliser pour votre storefront

Vous avez installé l’extension Live Search, synchronisé, validé et configuré vos données. L’étape suivante consiste à s’assurer que les widgets Live Search sont conformes à l’aspect de votre boutique.

Vous pouvez mettre en forme les widgets de fenêtre contextuelle et de liste déroulante en définissant des règles CSS personnalisées selon vos besoins. Voir Mise en forme des éléments de fenêtre contextuelle 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 JavaScript selon vos propres besoins, puis héberger votre code personnalisé sur votre réseau CDN. Ce script personnalisé communique avec le service Live Search et renvoie les résultats comme d’habitude, ce qui vous permet de contrôler la fonctionnalité du widget.

Avant de mettre à jour Live Search, exécutez la commande suivante à partir de la ligne de commande pour vérifier la version de Live Search installée :

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

Pour mettre à jour Live Search, exécutez la commande suivante à 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 le fichier .json de Composer racine du projet comme suit :

  1. Si la version magento/live-search actuellement installée est 3.1.1 ou inférieure et que vous effectuez une mise à niveau vers la version 4.0.0 ou supérieure, 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 magento/live-search actuellement installée, exécutez la commande suivante :

    code language-bash 
    composer show magento/live-search

  2. Ouvrez le fichier de composer.json racine et recherchez des magento/live-search.

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

    code language-json 
    "require": {
   ...
   "magento/live-search": "^4.0",
   ...
 }

  4. Enregistrez composer.json. Exécutez ensuite la commande suivante à partir de la ligne de commande :

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

Pour désinstaller Live Search, voir Désinstaller les modules.

L’extension Live Search se compose des packages suivants :

Package
Description
module-live-search
Permet aux commerçants de configurer leurs paramètres de recherche pour les facettes, les synonymes, les règles de requête, etc., et donne accès à un terrain de jeu GraphQL en lecture seule pour tester les requêtes provenant de l’Administrateur.
module-live-search-adapter
Achemine les requêtes de recherche du storefront vers le service Live Search et effectue le rendu des résultats dans le storefront.
- Navigation par catégorie - Achemine les requêtes du storefront navigation supérieure vers le service de recherche.
- Recherche globale - Achemine les requêtes provenant de la zone recherche rapide dans le coin supérieur droit du storefront vers le service Live Search.
module-live-search-storefront-popover
Une fenêtre contextuelle « rechercher en cours de frappe » remplace la recherche rapide standard et renvoie les données et les miniatures des meilleurs résultats de recherche.

Live Search dépendances

Le métapaquet Composer pour installer l’extension Live Search comprend les dépendances de module suivantes.

  • 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 détaillées lorsque vous utilisez Live Search et Catalog Service.

Point d’entrée

Live Search communique via le point d’entrée à l’adresse https://catalog-service.adobe.io/graphql.

Comme Live Search n’a pas accès à la base de données complète des produits, les API Live Search GraphQL et Commerce core GraphQL n’ont pas une parité totale.

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

  • Amélioration des performances et réduction de la charge du processeur en contournant le processus Commerce database/Graphql.
  • Tirez parti de la fédération Catalog Service pour appeler Live Search, Catalog Service et Product Recommendations à partir d’un seul point d’entrée.

Pour certains cas d’utilisation, il peut être préférable d’appeler Catalog Service pour obtenir des détails sur le produit et des cas similaires. Voir refineProduct pour plus d’informations.

Si vous disposez d’une implémentation découplée personnalisée, consultez les implémentations de référence Live Search :

La collecte automatique des données d’interaction utilisateur ne fonctionne pas par défaut lorsque vous n’utilisez pas les composants standard tels que la Search Adapter, les widgets Luma ou les widgets AEM CIF. Adobe Sensei utilise ces données collectées pour le marchandisage intelligent et le suivi des performances. Pour résoudre ce problème, vous devez développer une solution personnalisée pour implémenter cette collecte de données en mode découplé.

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

Prise en charge linguistique

Les widgets Live Search prennent en charge les langues suivantes :

Langue
Région
Code de langue
Magento Locale
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
Finlandais
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-Bas
nl_NL
nl_NL
Polonais
Pologne
pl_PL
pl_PL
Portugais
Brésil
pt_BR
pt_BR
Portugais
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ïlandais
Thaïlande
th_TH
th_TH
Turc
Turquie
tr_TR
tr_TR
Chinois
Chine
zh_CN
zh_Hans_CN
Chinois
Taïwan
zh_TW
zh_Hant_TW

Si le widget détecte que le paramètre Langue d’administration de Commerce correspond à une langue prise en charge, il utilise cette langue par défaut. Dans le cas contraire, le widget est défini par défaut sur Anglais. Dans Admin, le paramètre de langue est configuré en accédant à Stores> Settings >Configuration > General> Country Options.

Les administrateurs peuvent également définir la langue de l’index de recherche pour garantir de meilleurs résultats de recherche.

Référentiel de code de widget

Le code du widget de page de liste de produits et du widget de champ Recherche en direct peut être téléchargé à partir de GitHub.

Les développeurs qui ont accès au code peuvent entièrement personnaliser son fonctionnement et son aspect. Ils hébergent le code sur leurs propres serveurs, mais utilisent toujours le service Live Search.

Extension Data Export

Une fois que la recherche en direct est activée, l’extension d’exportation de données synchronise les données Commerce entre l’application Commerce et la recherche en direct. Ce processus garantit que les données Commerce les plus récentes sont disponibles sur le storefront. Dans l’Administration, vous pouvez vérifier l’état de synchronisation à l’aide du tableau de bord Data Management. Vous pouvez gérer et résoudre les problèmes du processus d’exportation des données à l’aide de l’interface de ligne de commande et des journaux Commerce. Pour plus d’informations, consultez le Guide d’exportation de données.

Inventory management

Live Search prend en charge les fonctionnalités Inventory management dans Commerce (anciennement appelé Multi-Source Inventory, ou MSI). Pour activer la prise en charge complète, vous devez mettre à jour le module de dépendance commerce-data-export à la version 102.2.0+.

Live Search renvoie une valeur de type boolean qui indique si un produit est disponible dans Inventory management, mais ne contient aucune information sur la source qui possède le stock.

Indexeur de prix

Les clients Live Search peuvent utiliser l’indexeur de prix SaaS, qui accélère la mise à jour des modifications de prix et la synchronisation.

Prise en charge des prix

Les widgets Live Search prennent en charge la plupart des types de prix pris en charge par Adobe Commerce, mais pas tous.

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

  • Coût
  • Prix minimum annoncé

Examinez le maillage API pour des calculs de prix plus complexes.

Le format des 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 du storefront découplé

Vous devrez peut-être installer le module module-data-services-graphql qui étend la couverture GraphQL existante de l’application pour inclure les champs requis pour la collecte de données comportementales en 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 B2B

Live Search prend en charge la fonctionnalité B2B avec des limitations supplémentaires.

Prise en charge de PWA

Live Search fonctionne avec PWA Studio, mais les utilisateurs peuvent voir de légères différences par rapport aux autres implémentations de Commerce. Les fonctionnalités de base telles que la recherche et la page de 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 PWA actuelle de Live Search nécessite davantage de temps de traitement pour renvoyer les résultats de la recherche qu’une Live Search avec le storefront Commerce natif.
  • Live Search dans PWA ne prend pas en charge la gestion des événements. Par conséquent, les rapports de recherche et le marchandisage intelligent ne fonctionnent pas sur les vitrines PWA.
  • Lors de l'utilisation de PWA Studio, GraphQL ne prend pas en charge le filtrage directement sur description, name, short_description, mais ces champs peuvent être renvoyés avec un filtre plus général.

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

  1. Installez livesearch-storefront-utils.

  2. Définissez la environmentId dans l’objet 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 sur les interactions utilisateur dans le cadre de sa fonctionnalité de base et des cookies sont utilisés pour stocker ces données. Lors de la collecte d'informations utilisateur, l'utilisateur doit accepter de stocker des cookies. Live Search et Product Recommendations partagent le flux de données et, par conséquent, le même mécanisme de cookie. En savoir plus à ce sujet dans Gestion des restrictions relatives aux cookies.

recommendation-more-help
8eedb3c4-09d2-4e4f-917b-524833fc6b4f