Konfigurera för framgång med Live Search

Adobe Commerce Live Search och Catalog Service samarbeta för att tillhandahålla en presterande, relevant och intuitiv söklösning så att era kunder snabbt kan hitta exakt det de behöver. I synnerhet Catalog Service hämtar katalogdata för SaaS-tjänster, som Live Search att använda.

I den här artikeln finns stegvisa instruktioner för hur du implementerar Live Search med Catalog Service.

IMPORTANT
När det gäller webbplatssökningar har Adobe Commerce fler alternativ. Var noga med att läsa Gränser och begränsningar innan de implementeras, säkerställa Live Search passar ditt företags behov.

Målgrupp

Den här artikeln är avsedd för utvecklare eller systemintegratörer i ditt team som ansvarar för att installera och konfigurera din Adobe Commerce-instans.

Krav

Plattformar som stöds

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

Översikt över arbetsflödet

På en hög nivå, introduktion Live Search kräver att du

Arbetsflöde för Live Search

1. Installera Live Search extension

Live Search installeras som ett tillägg från Adobe Marketplace via Disposition. När du har installerat och konfigurerat Live Search, ADOBE Commerce börjar dela söknings- och katalogdata med SaaS-tjänster. I det här skedet Administratör -användare kan skapa, anpassa och hantera regler för sökning, synonymer och varuexponering.

NOTE
Från Live Search 3.0.2, Catalog Service tillägget paketeras i med Live Search installation.
  1. Bekräfta att cron och indexerare är igång.

    note important
    IMPORTANT
    På grund av att supporten för Elasticsearch 7 upphör i augusti 2023 rekommenderas att alla Adobe Commerce-kunder migrerar till sökmotorn OpenSearch 2.x. Mer information om hur du migrerar sökmotorn under en produktuppgradering finns i Migrerar till OpenSearch i Uppgraderingshandbok.
  2. Ladda ned live-search paketet från Adobe Marketplace.

  3. Kör följande från kommandoraden:

    code language-bash
    composer require magento/live-search
    

    Om du lägger till Live Search tillägg till en new Adobe Commerce-installation, kör följande för att inaktivera OpenSearch och tillhörande moduler, samt installera Live Search. Fortsätt sedan till steg 4.

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

    Om du lägger till Live Search tillägg till en befintlig Installera Adobe Commerce genom att köra följande för att tillfälligt inaktivera Live Search moduler som används för sökresultat i butiker. Fortsätt sedan till steg 4:

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

    Elasticsearch fortsätter att hantera sökbegäranden från butiken medan Live Search synkroniserar katalogdata och indexerar produkter i bakgrunden.

  4. Kör följande:

    code language-bash
    bin/magento setup:upgrade
    
  5. Verifiera att följande indexerare är inställda på"Uppdatera enligt schema":

    • Produktfeed
    • Produktvariantfeed
    • Matning för katalogattribut
    • Produktprisfeed
    • Omfattningar för webbplatsdatafeed
    • Omfång Datamatning för kundgrupper
    • Kategoriflöde
    • Kategoribehörighetsfeed
  6. Om du installerar Live Search på en ny Commerce-instans är du klar och kan hoppa till 2. Konfigurera API-nycklar -avsnitt. Om du installerar Live Search i en befintlig Commerce-instans fortsätter du till nästa steg.

  7. Kör följande kommandon för att aktivera Live Search tillägg, inaktivera OpenSearchoch köra 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. Konfigurera API-nycklar

Adobe Commerce API-nyckeln och den tillhörande privata nyckeln krävs för att ansluta Live Search till en installation av Adobe Commerce. API-nyckeln genereras och underhålls i kontot för Commerce licensinnehavare som kan dela det med utvecklaren eller systemintegratören. Utvecklaren kan sedan skapa och hantera SaaS Data Spaces för licenshavarens räkning. Om du redan har en uppsättning API-nycklar behöver du inte generera om dem.

Lär dig hur du konfigurerar API-nycklar i Commerce Services Connector artikel.

3. Synkronisera katalogdata synchronize-catalog-data

Live Search flyttar katalogdata till infrastrukturen i Adobe SaaS. Data indexeras och sökresultat levereras från detta index direkt till butiken. Beroende på storlek och komplexitet kan indexeringen ta mellan 30 minuter och några timmar.

Kör följande kommandon i den ordning som du vill börja synkronisera katalogdata till SaaS-tjänster:

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

När du kör dessa kommandon börjar den inledande synkroniseringen av katalogdata till SaaS-tjänster.

WARNING
När data indexeras och synkroniseras är söknings- och kategoribläddringsåtgärderna inte tillgängliga i butiken. Beroende på storleken på katalogen kan processen ta minst en timme från tidpunkten cron kör för att synkronisera data till SaaS-tjänster.

Övervaka synkroniseringsförlopp

Du kan visa data som är synkroniserade och delade med Instrumentpanel för datahantering. Den här instrumentpanelen ger värdefulla insikter om tillgängligheten av produktdata för butiken, så att den snabbt kan visas för kunderna.

Instrumentpanel för datahantering

Framtida produktuppdateringar

Efter den första synkroniseringen kan det ta upp till 15 minuter innan ytterligare produktuppdateringar blir tillgängliga för butikssökning. Mer information finns på Indexering - direktuppspelande produktuppdateringar.

4. Verifiera att data exporterades verify-export

Så här verifierar du att katalogdata har exporterats från din Adobe Commerce-instans och synkroniserats för Live Searchhar du några alternativ:

  • Leta efter poster i följande tabeller:

    • catalog_data_exporter_products
    • catalog_data_exporter_product_attributes
  • Använd GraphQL playground med standardfrågan för att verifiera följande:

    • Det returnerade antalet produkter är nästan vad du förväntar dig för butiksvyn.
    • Ansikten returneras.

Mer hjälp finns i Live Search katalogen inte synkroniserad i supportkunskapsbasen.

5. Konfigurera data

Om du konfigurerar dina produktdata på rätt sätt får du bra sökresultat för dina kunder. I det här avsnittet aktiverar du widgetar för produktlistor och tilldelar kategorier och attribut.

Aktivera widgetar för produktlistor

När du installerar Live Search 4.0.0+, produktlistwidgetar är aktiverade som standard. När widgetar är aktiverade används en annan UI-komponent för sökresultatsidan och kategoribläddra på produktlistsidan. Den här gränssnittskomponenten gör direktanrop till Katalogtjänstens API, vilket ger snabbare svarstider.

Om du har en Live Search äldre än 4.0.0+ måste du aktivera produktlistwidgeten manuellt.

  1. Från Administratör, gå till Stores > Settings>Configuration.

  2. Under Live Search, markera Storefront Features.

  3. Ange Enable Product Listing Widgets till Yes.

    Aktivera widgetar för produktlistor

När du ändrar den här konfigurationen visas ett meddelande Page cache is invalidated visas. Du måste tömma cacheminnet i Magento för att spara ändringen.

  1. Öppna Cachehantering gör något av följande:

    • Klicka på Cache Management i meddelandet ovanför arbetsytan.
    • Administratör sidebar, gå till System > Tools>Cache Management.
  2. Välj Konfiguration Cache Type och klicka Flush Magento Cache.

    Ändringar i butiken görs omedelbart efter att du tömt cachen.

Tilldela kategorier

Produkter som returneras i Live Search måste tilldelas en kategori. I Luma kan till exempel produkter delas in i kategorier som "Män", "Kvinnor" och "Kugghjul". Underkategorierna är också inställda för "Tops", "Bottom" och "Watches". Detta ger bättre granularitet vid filtrering.

Sökbara och filterbara fält

Produkter tilldelas attributes som kan användas för sökning och filtrering. Attribut är t.ex. "Color", "Size" och "Material Type". Med de här attributen kan användarna leta efter"gröna toppar". Varje produkt kan ha många attribut som definieras i Commerce Admin.

Var och en av dessa attribut kan definieras som "sökbar" i Admin. Om attributen anges som "sökbara" är de tillgängliga för sökning av Live Search.

Fasetter är produktattribut som definieras i Live Search som ska kunna filtreras. Alla filterbara attribut kan anges som en faktor i Live Search men det finns gränser för hur många aspekter som kan sökas igenom samtidigt.

Synonymer är termer som du kan definiera för att hjälpa användarna att hitta rätt produkt. Användare som söker efter byxor kan skriva in "byxor" eller "slacks". Du kan ställa in synonymer så att de här söktermerna får användarna att se resultatet.

6. Testa anslutningen test-connection

Testa att se till att produktdata returneras i följande scenarier med dina katalogdata nu i SaaS:

  • The Search returnerar resultaten korrekt
  • Kategoribläddring returnerar resultat korrekt
  • Ansikten finns som filter på sökresultatsidor

Om allt fungerar korrekt Live Search är installerat, anslutet och klart att användas.

Om du stöter på problem i butiken ska du kontrollera var/log/system.log fil för API-kommunikationsfel eller fel på tjänstsidan.

Tillåt Live Search via en brandvägg lägger du till commerce.adobe.io till tillåtelselista.

7. Anpassa för butiken

Du har installerat Live Search tillägg, synkroniserade, validerade och konfigurerade dina data. Nu ska du se till att Live Search widgetarna anpassas efter butikens utseende och känsla.

Du kan formatera widgetarna pover och PLP genom att definiera anpassade CSS-regler efter behov. Se Formatera popoposerelement och Sidwidget för produktlista.

Om du vill utöka widgetarnas funktioner är källkoden för varje tillgängligt i en offentlig rapport.
I det här scenariot kan du anpassa JavaScript efter dina egna behov och sedan lägga din egen kod på ditt CDN. Det här anpassade skriptet kommunicerar med Live Search och returnerar resultatet som vanligt, så att du kan styra widgetens funktioner.

Uppdaterar Live Search update

Innan du uppdaterar Live Search kör du följande kommandorad för att kontrollera vilken version av Live Search som är installerad:

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

Uppdatera Live Searchkör du följande från kommandoraden:

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

Om du vill uppdatera till en större version, som 3.1.1 till 4.0.0, redigerar du projektets rot Composer .json på följande sätt:

  1. Om din nuvarande installation magento/live-search versionen är 3.1.1 eller tidigare, och du uppgraderar till version 4.0.0 eller senare kör du följande kommando före uppgraderingen:

    code language-bash
    bin/magento module:enable Magento_AdvancedSearch
    

    Mer information om den installerade magento/live-search version, kör följande kommando:

    code language-bash
    composer show magento/live-search
    
  2. Öppna roten composer.json fil och sök efter magento/live-search.

  3. I require uppdaterar du versionsnumret enligt följande:

    code language-json
    "require": {
       ...
       "magento/live-search": "^4.0",
       ...
     }
    
  4. Spara composer.json. Kör sedan följande från kommandoraden:

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

Avinstallerar Live Search uninstall

Avinstallera Live Search, se Avinstallera moduler.

Live Search paket packages

The Live Search tillägget består av följande paket:

Paket
Beskrivning
module-live-search
Gör det möjligt för handlare att konfigurera sina sökinställningar för ansikten, synonymer, frågeregler och så vidare, och ger åtkomst till en skrivskyddad GraphQL-spelningsmiljö för att testa frågor från Administratör.
module-live-search-adapter
Slussar sökförfrågningar från butiken till Live Search och återger resultaten i butiken.
- Kategoribläddring - dirigera begäranden från butiken navigering överst till söktjänsten.
- Global sökning - dirigera begäranden från snabbsökning i det övre högra hörnet av butiken längst upp till vänster Live Search service.
module-live-search-storefront-popover
En sökfunktion som ersätter standardsnabbsökningen och returnerar data och miniatyrbilder av de översta sökresultaten.

Live Search beroenden dependencies

Följande Live Search beroenden hämtas av 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

Avancerade begrepp

Följande avsnitt innehåller mer avancerade ämnen när du använder Live Search och Catalog Service.

Slutpunkt

Live Search kommunicerar via slutpunkten vid https://catalog-service.adobe.io/graphql.

Som Live Search inte har tillgång till hela produktdatabasen, Live Search GraphQL och Commerce Core GraphQL kommer inte att ha fullständig paritet.

Vi rekommenderar att du anropar SaaS API:er direkt - särskilt katalogtjänstslutpunkten.

  • Öka prestanda och minska belastningen på processorn genom att kringgå Commerce databas-/grafikprocess
  • Utnyttja Catalog Service federation att ringa Live Search, Catalog Serviceoch Product Recommendations från en enda slutpunkt.

I vissa fall är det kanske bättre att ringa Catalog Service för produktinformation och liknande. Se refineProduct för mer information.

Om du har en anpassad headless-implementering kan du ta en titt på Live Search referensimplementeringar:

Om du inte använder standardkomponenterna, som Sökadapter eller widgetar på Luma, eller AEM CIF widgetar, kommer inte händelser (klickströmsdata som matar Adobe Sensei för intelligent marknadsföring och prestandamått) att fungera som de ska och kräver anpassad utveckling för att implementera headless-händelser.

Den senaste versionen av Live Search används redan Catalog Service.

Språkstöd

Live Search widgetar stöder följande språk:

Språk
Län
Språkkod
Magento
Bulgariska
Bulgarien
bg_BG
bg_BG
Katalanska
Spanien
ca_ES
ca_ES
Tjeckiska
Tjeckien
cs_CZ
cs_CZ
Danska
Danmark
da_DK
da_DK
Tyska
Tyskland
de_DE
de_DE
Grekiska
Grekland
el_GR
el_GR
Engelska
Förenade kungariket
en_GB
en_GB
Engelska
Amerikas förenta stater
sv_SE
sv_SE
Spanska
Spanien
es_ES
es_ES
Estniska
Estland
et_EE
et_EE
Baskiska
Spanien
eu_ES
eu_ES
Persiska
Iran
fa_IR
fa_IR
Finska
Finland
fi_FI
fi_FI
Franska
Frankrike
fr_FR
fr_FR
Galiciska
Spanien
gl_ES
gl_ES
Hindi
Indien
hi_IN
hi_IN
Ungerska
Ungern
hu_HU
hu_HU
Indonesiska
Indonesien
id_ID
id_ID
Italienska
Italien
it_IT
it_IT
Koreanska
Sydkorea
ko_KR
ko_KR
Litauiska
Litauen
lt_LT
lt_LT
Lettiska
Lettland
lv_LV
lv_LV
Norska
Norge bokmål
nb_NO
nb_NO
Nederländska
Nederländerna
nl_NL
nl_NL
Polska
Polen
pl_PL
pl_PL
Portugisiska
Brasilien
pt_BR
pt_BR
Portugisiska
Portugal
pt_PT
pt_PT
Rumänska
Rumänien
ro_RO
ro_RO
Ryska
Ryssland
ru_RU
ru_RU
Svenska
Sverige
sv_SE
sv_SE
Thailändska
Thailand
th_TH
th_TH
Turkiska
Turkiet
tr_TR
tr_TR
Kinesiska
Kina
zh_CN
zh_Hans_CN
Kinesiska
Taiwan
zh_TW
zh_Hant_TW

Om widgeten upptäcker att språkinställningen för Commerce Admin (Lager > Inställningar > Konfiguration > Allmänt > landsalternativ) matchar ett språk som stöds, det språket som standard. I annat fall är widgetarna standard engelska.

Administratörer kan också ange språket för sökindexför att få bättre sökresultat.

Databas för Widget-kod

Widgeten Produktlistsida och widgeten för Live-sökfält är båda tillgängliga för hämtning från deras github-databas.

Detta gör att utvecklare kan anpassa funktionaliteten och stilen helt och hållet. Dessa användare lagrar själva koden samtidigt som de drar nytta av Live Search service.

Inventory management

Live Search supports Inventory management i Commerce (tidigare Multi-Source Inventory eller MSI). Om du vill aktivera fullständig support måste du uppdatera beroende modul commerce-data-export till version 10.2.0+.

Live Search returnerar ett booleskt meddelande som anger om en produkt är tillgänglig i Inventory management, men inte innehåller information om vilken källa som har aktien.

Prisindexerare

Live Search-kunder kan använda nya SaaS prisindexerare, vilket ger snabbare prisförändringsuppdateringar och synkroniseringstid.

Prisstöd

Live Search-widgetar har stöd för de flesta, men inte alla, pristyper som stöds av Adobe Commerce.

För närvarande stöds baspriser. Avancerade priser som inte stöds är:

  • Kostnad
  • Lägsta kampanjpris

Titta på API-nät för mer komplexa prisberäkningar.

Prisformatet har stöd för de nationella konfigurationsinställningarna i Commerce-instansen: Lager > Inställningar > Konfiguration > Allmänt > Allmänt > Lokala alternativ > Språk.

Headless storefront support

Du kan också behöva installera module-data-services-graphql som utökar programmets befintliga GraphQL-täckning till att omfatta fält som krävs för storefront-beteendedatainsamling.

composer require magento/module-data-services-graphql

Den här modulen lägger till ytterligare kontexter i GraphQL-frågor:

  • dataServicesStorefrontInstanceContext
  • dataServicesMagentoExtensionContext
  • dataServicesStoreConfigurationContext

Stöd för PWA

Live Search fungerar med PWA Studio, men användare kan se små skillnader jämfört med andra Commerce-implementeringar. Grundläggande funktioner som sök- och produktlistsidor fungerar i Venia, men vissa permutationer av Graphql kanske inte fungerar som de ska. Det kan också finnas prestandaskillnader.

  • Den nuvarande PWA-implementeringen av Live Search kräver mer bearbetningstid för att returnera sökresultat än Live Search med den inbyggda Commerce Store.
  • Live Search i PWA stöder inte händelsehantering. Därför kommer sökrapporter och intelligent varuexponering att fungera.
  • Filtrera direkt på description, name, short_description stöds inte av GraphQL när det används med PWA, men de returneras med ett mer allmänt filter.

Används Live Search Med PWA Studio måste integratörerna också

  1. Installera livesearch-storefront-utils.

  2. Ange environmentId i storeDetails -objekt.

    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 samlar in användarinteraktionsdata som en del av basfunktionen och cookies används för att lagra dessa data. När användaren samlar in användarinformation måste han eller hon godkänna att lagra cookies. Live Search och Product Recommendations delar dataströmmen och därmed samma cookie-mekanism. Läs mer om det i Hantera cookie-begränsningar.

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