DocumentazioneCommerce“Guida Live Search”

Configurazione per il successo con Live Search

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
  • Sviluppatore

Adobe Commerce Live Search e Catalog Service collaborano per fornire una soluzione di ricerca efficiente, pertinente e intuitiva che consenta ai clienti di trovare rapidamente ciò di cui hanno bisogno. In particolare, Catalog Service fa emergere i dati del catalogo per i servizi SaaS, ad esempio Live Search da utilizzare.

Questo articolo fornisce istruzioni dettagliate per l'implementazione di Live Search con Catalog Service.

IMPORTANT
Adobe Commerce offre diverse opzioni per la ricerca del sito. Assicurati di leggere Limiti e limiti prima di implementare, per assicurarti che Live Search sia adatto alle tue esigenze aziendali.

Pubblico

Questo articolo è destinato agli sviluppatori o agli integratori di sistemi del team, responsabili dell’installazione e della configurazione dell’istanza di Adobe Commerce.

Requisiti

Piattaforme supportate

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

Panoramica del flusso di lavoro

A un livello avanzato, l'onboarding di Live Search richiede:

Flusso di lavoro di Live Search

Live Search è installato come estensione da Adobe Marketplace a Composer. Dopo aver installato e configurato Live Search, l'Adobe Commerce inizia a condividere i dati di ricerca e catalogo con i servizi SaaS. A questo punto, Amministratore utenti possono impostare, personalizzare e gestire facet di ricerca, sinonimi e regole di merchandising.

NOTE
A partire dalla versione 3.0.2 di Live Search, l'estensione Catalog Service è inclusa nell'installazione di Live Search.

  1. Verificare che processi cron e indicizzatori siano in esecuzione.

    note important
    IMPORTANT
    A causa dell’annuncio di fine del supporto di Elasticsearch 7 relativo ad agosto 2023, si consiglia a tutti i clienti di Adobe Commerce di migrare al motore di ricerca OpenSearch 2.x. Per informazioni sulla migrazione del motore di ricerca durante un aggiornamento del prodotto, vedere Migrazione a OpenSearch nella Guida all'aggiornamento.

  2. Scarica il pacchetto live-search da Adobe Marketplace.

  3. Esegui quanto segue dalla riga di comando:

    code language-bash 
    composer require magento/live-search

    Se si aggiunge l'estensione Live Search a un'installazione di Adobe Commerce new, eseguire le operazioni seguenti per disabilitare OpenSearch e i moduli correlati e installare Live Search. Procedere quindi al punto 4.

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

    Se stai aggiungendo l'estensione Live Search a un'installazione di Adobe Commerce esistente, esegui la procedura seguente per disabilitare temporaneamente i moduli Live Search che forniscono i risultati della ricerca della vetrina. Quindi procedere al punto 4:

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

    Elasticsearch continua a gestire le richieste di ricerca dalla vetrina mentre il servizio Live Search sincronizza i dati del catalogo e indicizza i prodotti in background.

  4. Esegui quanto segue:

    code language-bash 
    bin/magento setup:upgrade

  5. Verificare che i seguenti indicizzatori siano impostati su "Aggiorna in base alla pianificazione":

    • Feed prodotto
    • Feed variante prodotto
    • Feed attributi catalogo
    • Feed prezzi prodotto
    • Feed dati del sito Web ambiti
    • Feed di dati dei gruppi di clienti per ambiti
    • Feed categorie
    • Feed di autorizzazioni categoria

  6. Se stai installando Live Search in una nuova istanza di Commerce, l'operazione è terminata e puoi passare a 2. Configurare la sezione delle chiavi API. Se stai installando Live Search in un’istanza Commerce esistente, procedi al passaggio successivo.

  7. Eseguire i seguenti comandi per abilitare l'estensione Live Search, disabilitare OpenSearch ed eseguire 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. Configurare le chiavi API

Per connettere Live Search a un'installazione di Adobe Commerce sono necessari la chiave API di Adobe Commerce e la chiave privata associata. La chiave API viene generata e mantenuta nell'account del titolare della licenza Commerce, che può condividerla con lo sviluppatore o l'integratore di sistemi. Lo sviluppatore può quindi creare e gestire gli spazi dati SaaS per conto del titolare della licenza. Se disponi già di un set di chiavi API, non è necessario rigenerarle.

Scopri come configurare le chiavi API nell’articolo Commerce Services Connector.

3. Sincronizzare i dati del catalogo synchronize-catalog-data

Live Search sposta i dati del catalogo nell'infrastruttura SaaS di Adobe. I dati vengono indicizzati e i risultati della ricerca vengono consegnati da questo indice direttamente alla vetrina. A seconda delle dimensioni e della complessità, l’indicizzazione può richiedere da 30 minuti a un paio d’ore.

Per avviare la sincronizzazione iniziale dei dati del catalogo con i servizi SaaS, eseguire i comandi seguenti nell'ordine indicato:

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

Quando si eseguono questi comandi, inizia la sincronizzazione iniziale dei dati del catalogo con i servizi SaaS.

WARNING
Mentre i dati sono indicizzati e sincronizzati, le operazioni di ricerca e di ricerca per categoria non sono disponibili nella vetrina. A seconda delle dimensioni del catalogo, il processo può richiedere almeno un'ora dal momento in cui cron viene eseguito per sincronizzare i dati con i servizi SaaS.

Monitorare l’avanzamento della sincronizzazione

Puoi visualizzare i dati sincronizzati e condivisi utilizzando Data Management Dashboard. Questa dashboard fornisce informazioni utili sulla disponibilità di dati di prodotto per la vetrina, garantendo che possano essere visualizzati immediatamente agli acquirenti.

Dashboard di gestione dati

Aggiornamenti futuri del prodotto

Dopo la sincronizzazione iniziale, possono essere necessari fino a 15 minuti perché gli aggiornamenti incrementali dei prodotti siano disponibili per la ricerca nella vetrina. Per ulteriori informazioni, consulta Indicizzazione - Aggiornamenti del prodotto in streaming.

4. Verificare che i dati siano stati esportati verify-export

Per verificare che i dati del catalogo siano stati esportati dall'istanza Adobe Commerce e sincronizzati per Live Search, sono disponibili due opzioni:

  • Cercare le voci nelle tabelle seguenti:

    • catalog_data_exporter_products
    • catalog_data_exporter_product_attributes

  • Utilizza il parco giochi GraphQL con la query predefinita per verificare quanto segue:

    • Il conteggio dei prodotti restituito si avvicina a quello previsto per la visualizzazione Store.
    • Vengono restituiti i facet.

Per ulteriori informazioni, vedere Live Search catalogo non sincronizzato nella Knowledge Base del supporto tecnico.

5. Configurare i dati

La corretta configurazione dei dati di prodotto garantisce buoni risultati di ricerca per i clienti. In questa sezione, abiliti i widget per l’elenco dei prodotti e assegna le categorie.

Abilita widget elenco prodotti

Quando si installa Live Search 4.0.0+, i widget dell'elenco prodotti sono abilitati per impostazione predefinita. Quando i widget sono attivati, viene utilizzato un componente diverso dell’interfaccia utente per la pagina dei risultati della ricerca e per la pagina dell’elenco dei prodotti per la navigazione delle categorie. Questo componente dell'interfaccia utente effettua chiamate dirette all'API Catalog Service, il che si traduce in tempi di risposta più rapidi.

Se hai una versione di Live Search precedente alla 4.0.0+, devi abilitare manualmente il widget dell'elenco di prodotti.

  1. Da Amministratore, passa a Stores > Settings>Configuration.

  2. In Live Search, selezionare Storefront Features.

  3. Imposta Enable Product Listing Widgets su Yes.

    Abilita widget elenco prodotti

Quando si modifica questa configurazione, viene visualizzato il messaggio Page cache is invalidated. Per salvare le modifiche, è necessario svuotare la cache del Magento.

  1. Accedere alla pagina Gestione cache effettuando una delle operazioni seguenti:

    • Fare clic sul collegamento Cache Management nel messaggio sopra l'area di lavoro.
    • Nella barra laterale Admin, passa a System > Tools>Cache Management.

  2. Selezionare la configurazione Cache Type e fare clic su Flush Magento Cache.

    Le modifiche alla vetrina vengono apportate subito dopo il flushing della cache.

Assegna categorie

I prodotti restituiti in Live Search devono essere assegnati a una categoria. In Luma, ad esempio, i prodotti sono inseriti in categorie come "Uomini", "Donne" e "Attrezzi". Sono impostate anche delle sottocategorie per "Tops", "Bottoms" e "Watches". Questo consente una maggiore granularità durante il filtraggio.

6. Verificare la connessione test-connection

Con i dati del catalogo ora in SaaS, verifica che i dati del prodotto vengano restituiti nei seguenti scenari:

  • La casella Search restituisce correttamente i risultati
  • La ricerca delle categorie restituisce correttamente i risultati
  • I facet sono disponibili come filtri nelle pagine dei risultati di ricerca

Se tutto funziona correttamente, Live Search è installato, connesso e pronto all'uso.

Se si verificano problemi nella vetrina, controllare il file var/log/system.log per individuare eventuali errori o errori di comunicazione API sul lato servizi.

Per consentire a Live Search di attraversare un firewall, aggiungere commerce.adobe.io al inserisco nell'elenco Consentiti di.

7. Personalizza per la vetrina

Hai installato l'estensione Live Search, hai sincronizzato, convalidato e configurato i tuoi dati. A questo punto è necessario assicurarsi che i widget Live Search siano conformi all'aspetto del tuo Negozio.

Puoi assegnare uno stile ai widget popover e PLP definendo regole CSS personalizzate in base alle esigenze. Consulta Elementi Popover di stile e Widget pagina elenco prodotti.

Se desideri estendere la funzionalità dei widget, il codice sorgente per ciascuno di essi è disponibile in un repository pubblico.
In questo scenario, puoi personalizzare il JavaScript in base alle tue esigenze e quindi ospitare il codice personalizzato sulla CDN. Questo script personalizzato comunica con il servizio Live Search e restituisce i risultati come normale, consentendo di controllare la funzionalità del widget.

Aggiornamento di Live Search update

Prima di aggiornare Live Search, esegui quanto segue dalla riga di comando per verificare la versione di Live Search installata:

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

Per aggiornare Live Search, eseguire quanto segue dalla riga di comando:

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

Per eseguire l'aggiornamento a una versione principale, ad esempio da 3.1.1 a 4.0.0, modificare il file .json principale del progetto come segue:Composer

  1. Se la versione di magento/live-search attualmente installata è 3.1.1 o inferiore e si sta eseguendo l'aggiornamento alla versione 4.0.0 o successiva, eseguire il comando seguente prima dell'aggiornamento:

    code language-bash 
    bin/magento module:enable Magento_AdvancedSearch

    Per informazioni sulla versione di magento/live-search attualmente installata, eseguire il comando seguente:

    code language-bash 
    composer show magento/live-search

  2. Aprire il file radice composer.json e cercare magento/live-search.

  3. Nella sezione require, aggiornare il numero di versione come segue:

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

  4. Salva composer.json. Quindi, esegui quanto segue dalla riga di comando:

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

Disinstallazione di Live Search uninstall

Per disinstallare Live Search, fare riferimento a Moduli di disinstallazione.

Live Search pacchetti packages

L'estensione Live Search è costituita dai pacchetti seguenti:

Pacchetto
Descrizione
module-live-search
Consente ai commercianti di configurare le impostazioni di ricerca per faceting, sinonimi, regole di query e così via e fornisce l'accesso a un'area di riproduzione GraphQL di sola lettura per testare le query di Admin.
module-live-search-adapter
Indirizza le richieste di ricerca dalla vetrina al servizio Live Search ed esegue il rendering dei risultati nella vetrina.
- Sfoglia categorie - Indirizza le richieste dalla navigazione superiore della vetrina al servizio di ricerca.
- Ricerca globale - Indirizza le richieste dalla casella Ricerca rapida in alto a destra della vetrina al servizio Live Search.
module-live-search-storefront-popover
Un popover "search as you type" (cerca durante la digitazione) sostituisce la ricerca rapida standard e restituisce dati e miniature dei risultati di ricerca principali.

Live Search dipendenze dependencies

Le Live Search dipendenze seguenti vengono acquisite da 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

Concetti avanzati

Nelle sezioni seguenti vengono forniti argomenti più avanzati quando si utilizzano Live Search e Catalog Service.

Endpoint

Live Search comunica attraverso l'endpoint in https://catalog-service.adobe.io/graphql.

Poiché Live Search non ha accesso al database completo dei prodotti, Live Search GraphQL e Commerce Core GraphQL non avranno parità completa.

Si consiglia di chiamare direttamente le API SaaS, in particolare l’endpoint Catalog Service.

  • Migliorare le prestazioni e ridurre il carico del processore ignorando il database Commerce/processo Graphql
  • Sfruttare la federazione Catalog Service per chiamare Live Search, Catalog Service e Product Recommendations da un singolo endpoint.

Per alcuni casi d'uso, potrebbe essere meglio chiamare Catalog Service per i dettagli del prodotto e casi simili. Per ulteriori informazioni, vedere refineProduct.

Se hai un'implementazione headless personalizzata, vedi le Live Search implementazioni di riferimento:

Se non utilizzi i componenti predefiniti, come Search Adapter o widget su Luma, o i widget CIF dell’AEM, gli eventi (dati di click-stream che alimentano Adobe Sensei per merchandising intelligente e metriche delle prestazioni) non funzioneranno immediatamente e richiederanno uno sviluppo personalizzato per implementare eventi headless.

La versione più recente di Live Search utilizza già Catalog Service.

Supporto linguistico

Live Search widget supportano le seguenti lingue:

Lingua
Regione
Codice lingua
Impostazioni locali Magento
Bulgaro
Bulgaria
bg_BG
bg_BG
Catalano
Spagna
ca_ES
ca_ES
Ceco
Repubblica Ceca
cs_CZ
cs_CZ
Danese
Danimarca
da_DK
da_DK
Tedesco
Germania
de_DE
de_DE
Greco
Grecia
el_GR
el_GR
Inglese
Regno Unito
en_GB
en_GB
Inglese
Stati Uniti
en_US
en_US
Spagnolo
Spagna
es_ES
es_ES
Estone
Estonia
et_EE
et_EE
Basco
Spagna
eu_ES
eu_ES
Persiano
Iran
fa_IR
fa_IR
Finlandese
Finlandia
fi_FI
fi_FI
Francese
Francia
fr_FR
fr_FR
Galiziano
Spagna
gl_ES
gl_ES
Hindi
India
hi_IN
hi_IN
Ungherese
Ungheria
hu_HU
hu_HU
Indonesiano
Indonesia
id_ID
id_ID
Italiano
Italia
it_IT
it_IT
Coreano
Corea del Sud
ko_KR
ko_KR
Lituano
Lituania
lt_LT
lt_LT
Lettone
Lettonia
lv_LV
lv_LV
Norvegese
Norvegia Bokmal
nb_NO
nb_NO
Olandese
Paesi Bassi
nl_NL
nl_NL
Polacco
Polonia
pl_PL
pl_PL
Portoghese
Brasile
pt_BR
pt_BR
Portoghese
Portogallo
pt_PT
pt_PT
Rumeno
Romania
ro_RO
ro_RO
Russo
Russia
ru_RU
ru_RU
Svedese
Svezia
sv_SE
sv_SE
Thailandese
Thailandia
th_TH
th_TH
Turco
Turchia
tr_TR
tr_TR
Cinese
Cina
zh_CN
zh_Hans_CN
Cinese
Taiwan
zh_TW
zh_Hant_TW

Se il widget rileva che l'impostazione della lingua di amministrazione di Commerce (Stores > Settings > Configuration > General > Country Options) corrisponde a una lingua supportata, per impostazione predefinita viene utilizzata tale lingua. In caso contrario, per impostazione predefinita i widget sono inglesi.

Gli amministratori possono inoltre impostare la lingua dell'indice di ricerca per garantire risultati di ricerca migliori.

Archivio del codice widget

I widget Pagina di elenco prodotti e Campo Live Search sono entrambi disponibili per il download dall’archivio GitHub.

Questo consente agli sviluppatori di personalizzare completamente la funzionalità e lo stile. Questi utenti ospitano il codice personalmente, sfruttando comunque il servizio Live Search.

Inventory management

Live Search supporta le funzionalità Inventory management in Commerce (precedentemente noto come Multi-Source Inventory o MSI). Per abilitare il supporto completo, è necessario aggiornare il modulo di dipendenza commerce-data-export alla versione 102.2.0+.

Live Search restituisce un valore booleano che indica se un prodotto è disponibile all'interno di Inventory management, ma non contiene informazioni sull'origine che contiene il titolo.

Indicizzatore prezzi

I clienti di Live Search possono utilizzare il nuovo Indicizzatore prezzo SaaS, che fornisce aggiornamenti più rapidi per la modifica del prezzo e tempi di sincronizzazione.

Supporto del prezzo

I widget Live Search supportano la maggior parte dei tipi di prezzo supportati da Adobe Commerce, ma non tutti.

Attualmente sono sostenuti i prezzi di base. I prezzi avanzati non supportati sono:

  • Costo
  • Prezzo minimo annunciato

Esaminare Mesh API per calcolare i prezzi più complessi.

Il formato del prezzo supporta l'impostazione di configurazione delle impostazioni locali nell'istanza di Commerce: Archivi > Impostazioni > Configurazione > Generale > Generale > Opzioni locali > Impostazioni internazionali.

Supporto per vetrina headless

Facoltativamente, potrebbe essere necessario installare il modulo module-data-services-graphql che espande la copertura GraphQL esistente dell'applicazione per includere i campi necessari per la raccolta dei dati comportamentali della vetrina.

composer require magento/module-data-services-graphql

Questo modulo aggiunge contesti aggiuntivi alle query GraphQL:

  • dataServicesStorefrontInstanceContext
  • dataServicesMagentoExtensionContext
  • dataServicesStoreConfigurationContext

Supporto B2B

Live Search supporta la funzionalità B2B con ulteriori limitazioni.

Supporto PWA

Live Search funziona con PWA Studio, ma gli utenti potrebbero vedere lievi differenze rispetto ad altre implementazioni di Commerce. Le funzionalità di base, come la ricerca e la pagina di elenco dei prodotti, funzionano in Venia, ma alcune permutazioni di Graphql potrebbero non funzionare correttamente. Potrebbero esserci anche differenze di prestazioni.

  • L'attuale implementazione di PWA di Live Search richiede più tempo di elaborazione per restituire i risultati della ricerca rispetto a Live Search con la vetrina nativa di Commerce.
  • Live Search in PWA non supporta gestione eventi. Di conseguenza, funzioneranno sia la generazione di rapporti di ricerca che il merchandising intelligente.
  • Il filtro diretto su description, name, short_description non è supportato da GraphQL se utilizzato con PWA, ma viene restituito con un filtro più generale.

Per utilizzare Live Search con PWA Studio, gli integratori devono anche:

  1. Installa livesearch-storefront-utils.

  2. Impostare environmentId nell'oggetto 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: "$",
        },
    };

Live Search raccoglie i dati di interazione dell'utente come parte della funzionalità di base e i cookie vengono utilizzati per memorizzare tali dati. Quando raccoglie informazioni sull’utente, quest’ultimo deve accettare di memorizzare i cookie. Live Search e Product Recommendations condividono il flusso di dati e quindi lo stesso meccanismo di cookie. Ulteriori informazioni sono disponibili in Gestione delle restrizioni dei cookie.

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