Opzetten voor succes met Live Search
Adobe Commerce Live Search en Catalog Service samen te werken om een krachtige, relevante en intuïtieve zoekoplossing te bieden waarmee uw klanten snel precies kunnen vinden wat ze nodig hebben. Specifiek: Catalog Service oppervlakken van uw catalogusgegevens voor SaaS-services, zoals Live Search te gebruiken.
Dit artikel bevat stapsgewijze instructies voor de implementatie Live Search with Catalog Service.
Publiek
Dit artikel is bedoeld voor de ontwikkelaar of systeemintegrator in uw team die verantwoordelijk is voor de installatie en configuratie van uw Adobe Commerce-exemplaar.
Vereisten
- Adobe Commerce 2.4.4+
- PHP 8.1 / 8.2 / 8.3
- Composer
Ondersteunde platforms
- Adobe Commerce on Cloud (ECE) : 2.4.4+
- Adobe Commerce on-prem (EE) : 2.4.4+
Workflowoverzicht
Op een hoog niveau Live Search vereist dat u:
1. Installeer de Live Search extension
Live Search is geïnstalleerd als een extensie van Adobe Marketplace doorheen Composer. Nadat u hebt geïnstalleerd en geconfigureerd Live Search, ADOBE Commerce begint onderzoek en catalogusgegevens met de diensten te delen SaaS. Op dit punt Beheerder gebruikers kunnen zoekfacetten, synoniemen en regels voor het wijzigen van handelsversies instellen, aanpassen en beheren.
-
Bevestig dat kroonbanen en indexeerders worden uitgevoerd.
note important IMPORTANT Gezien de Elasticsearch 7 eindeaankondiging voor augustus 2023, wordt aanbevolen dat alle Adobe Commerce-klanten naar de OpenSearch 2.x zoekmachine migreren. Voor informatie over het migreren van uw zoekmachine tijdens een productupgrade raadpleegt u Migreren naar OpenSearch in de Upgradehandleiding. -
Download de
live-search
pakket van de Adobe Marketplace. -
Voer de volgende handelingen uit vanaf de opdrachtregel:
code language-bash composer require magento/live-search
Als u de Live Search uitbreiding van een new Adobe Commerce-installatie, voer het volgende uit om uit te schakelen OpenSearch en bijbehorende modules, en installeren Live Search. Ga vervolgens verder met stap 4.
code language-bash bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch7 Magento_OpenSearch Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch Magento_ElasticsearchCatalogPermissionsGraphQl
Als u de Live Search uitbreiding van een bestaand Adobe Commerce-installatie, voer het volgende uit om het Live Search modules die zoekresultaten leveren. Ga vervolgens verder met stap 4:
code language-bash bin/magento module:disable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover Magento_LiveSearchProductListing
Elasticsearch blijft zoekverzoeken van de winkel beheren terwijl de Live Search De dienst synchroniseert catalogusgegevens en indexeert producten op de achtergrond.
-
Voer de volgende handelingen uit:
code language-bash bin/magento setup:upgrade
-
Controleer of het volgende indexeerders zijn ingesteld op "Bijwerken via schema":
- Productfeed
- Diervoeders voor productvarianten
- Feed voor cataloguskenmerken
- Diervoeders productprijzen
- Websitegegevensfeed
- Scopes Klantengroepen Gegevensfeed
- Diervoeders voor categorieën
- Diervoeders voor categorierechten
-
Als u installeert Live Search op een nieuw Commerce-exemplaar, bent u klaar en kunt u de 2. API-sleutels configureren sectie. Ga door met de volgende stap als u Live Search installeert op een bestaand Commerce-exemplaar.
-
Voer de volgende opdrachten uit om de Live Search extensie, uitschakelen OpenSearchen uitvoeren
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. API-sleutels configureren
De Adobe Commerce API-sleutel en de bijbehorende persoonlijke sleutel zijn vereist om verbinding te maken Live Search naar een installatie van Adobe Commerce. De API-sleutel wordt gegenereerd en onderhouden in de account van de Commerce licentiehouder, die deze kan delen met de ontwikkelaar of de systeemintegrator. De ontwikkelaar kan vervolgens de SaaS-gegevensruimten maken en beheren namens de licentiehouder. Als u al een set API-sleutels hebt, hoeft u deze niet opnieuw te genereren.
Leer hoe u uw API-sleutels configureert in het dialoogvenster Commerce Services Connector artikel.
3. Synchroniseer uw catalogusgegevens synchronize-catalog-data
Live Search Hiermee verplaatst u catalogusgegevens naar de SaaS-infrastructuur van de Adobe. De gegevens worden geïndexeerd en de zoekresultaten worden vanuit deze index rechtstreeks aan de winkel geleverd. Afhankelijk van de grootte en complexiteit kan het indexeren 30 minuten tot een paar uur duren.
Voer de volgende opdrachten in deze volgorde uit om te beginnen met de eerste synchronisatie van uw catalogusgegevens naar SaaS-services:
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
Wanneer u deze opdrachten uitvoert, begint de eerste synchronisatie van de catalogusgegevens met de SaaS-services.
cron
loopt om uw gegevens aan de diensten te synchroniseren SaaS.Synchronisatievoortgang controleren
U kunt de gesynchroniseerde en gedeelde gegevens weergeven met de Gegevensbeheerdashboard. Dit dashboard biedt waardevolle inzichten in de beschikbaarheid van productgegevens voor uw winkel, zodat deze direct aan uw klanten kunnen worden weergegeven.
Updates voor toekomstige producten
Na de eerste synchronisatie kan het tot 15 minuten duren voordat de incrementele productupdates beschikbaar komen voor het zoeken naar een winkel. Zie voor meer informatie Indexeren - productupdates streaming.
4. Controleer of de gegevens zijn geëxporteerd verify-export
Om te controleren of de catalogusgegevens uit uw Adobe Commerce-exemplaar zijn geëxporteerd en zijn gesynchroniseerd voor Live Search, hebt u een aantal opties:
-
Zoek naar ingangen in de volgende lijsten:
catalog_data_exporter_products
catalog_data_exporter_product_attributes
-
Gebruik de GraphQL-speelplaats met de standaardvraag om het volgende te verifiëren:
- Het aantal geretourneerde producten ligt dicht bij wat u voor de winkelweergave verwacht.
- Facetten worden geretourneerd.
Zie voor meer informatie Live Search catalogus niet gesynchroniseerd in de Support Knowledge Base.
5. Vorm de gegevens
Als u uw productgegevens correct configureert, bent u verzekerd van goede zoekresultaten voor uw klanten. In deze sectie schakelt u de widgets voor productlijsten in en wijst u categorieën toe.
Widgets productlijst inschakelen
Wanneer u installeert Live Search 4.0.0+, zijn de Widgets van de Lijst van het Product standaard toegelaten. Wanneer widgets zijn ingeschakeld, wordt een andere UI-component gebruikt voor de pagina met zoekresultaten en voor de pagina met productaanbiedingen in de categorie. Deze component UI doet directe vraag aan Catalogusservice-API, wat resulteert in snellere reactietijden.
Als u een Live Search Als u een hogere versie dan 4.0.0+ hebt, moet u de widget voor productaanbiedingen handmatig inschakelen.
-
Van de Beheerder, ga naar Stores > Settings>Configuration.
-
Onder Live Search, selecteert u Storefront Features.
-
Set Enable Product Listing Widgets tot
Yes
.
Wanneer u deze configuratie wijzigt, verschijnt het bericht Page cache is invalidated
wordt weergegeven. U moet het Geheime voorgeheugen van het Magento leegmaken om uw verandering te bewaren.
-
Toegang krijgen tot de Cachebeheer pagina door een van de volgende handelingen uit te voeren:
- Klik op de knop Cache Management in het bericht boven de werkruimte.
- Op de Beheerder zijbalk, ga naar System > Tools>Cache Management.
-
Selecteer de Configuratie Cache Type en klik op Flush Magento Cache.
Wijzigingen in de winkel worden direct na het leegmaken van de cache aangebracht.
Categorieën toewijzen
Producten geretourneerd in Live Search moet worden toegewezen aan een categorie. In Luma worden producten bijvoorbeeld ingedeeld in categorieën zoals "Mannen", "Vrouwen" en "Luma". Subcategorieën worden ook ingesteld voor Tops, Bottoms en Watches. Hierdoor wordt de korreligheid bij het filteren verbeterd.
6. Test de verbinding test-connection
Met uw catalogusgegevens nu in SaaS, test om ervoor te zorgen de productgegevens in de volgende scenario's zijn teruggekeerd:
- De Search geeft de resultaten correct weer
- Met bladeren door categorie worden de resultaten correct geretourneerd
- Factoren zijn als filters beschikbaar op pagina's met zoekresultaten
Als alles correct werkt, Live Search is geïnstalleerd, verbonden en gebruiksklaar.
Als er problemen optreden in de winkel, controleert u de var/log/system.log
bestand voor API-communicatiefouten of -fouten aan de kant van de services.
Toestaan Live Search via een firewall toevoegen commerce.adobe.io
op de lijst van gewenste personen.
7. Aanpassen voor je winkel
U hebt de Live Search extensie, gesynchroniseerd, gevalideerd en geconfigureerd. Nu wilt u ervoor zorgen dat de Live Search widgets zijn in overeenstemming met het uiterlijk van uw winkel.
U kunt de popover- en PLP-widgets opmaken door desgewenst aangepaste CSS-regels te definiëren. Zie Popup-elementen opmaken en Widget pagina met productaanbiedingen.
Als u de functionaliteit van de widgets wilt uitbreiden, is de broncode voor elke widget beschikbaar in een openbare reactie.
In dit scenario, kunt u JavaScript voor uw eigen behoeften aanpassen en dan uw douanecode op uw CDN ontvangen. Dit aangepaste script communiceert met het Live Search De dienst en keert de resultaten als normaal terug, toestaand u om de functionaliteit van widget te controleren.
Bijwerken Live Search update
Voer voordat u Live zoeken bijwerkt de volgende handelingen uit vanaf de opdrachtregel om de geïnstalleerde versie van Live Search te controleren:
composer show magento/module-live-search | grep version
Bijwerken Live Search, voert u de volgende handelingen uit vanaf de opdrachtregel:
composer update magento/live-search --with-dependencies
Als u wilt bijwerken naar een belangrijke versie zoals 3.1.1 en 4.0.0, bewerkt u de hoofdmap van het project Composer .json
bestand als volgt:
-
Als uw huidige systeem is geïnstalleerd
magento/live-search
versie is3.1.1
of lager en u werkt aan een upgrade naar de versie4.0.0
of hoger, stel het volgende bevel vóór de verbetering in werking:code language-bash bin/magento module:enable Magento_AdvancedSearch
Voor informatie over de momenteel geïnstalleerde
magento/live-search
versie, voer het volgende bevel in:code language-bash composer show magento/live-search
-
De hoofdmap openen
composer.json
bestand en zoek naarmagento/live-search
. -
In de
require
het versienummer als volgt bijwerken:code language-json "require": { ... "magento/live-search": "^4.0", ... }
-
Opslaan
composer.json
. Voer vervolgens de volgende handelingen uit vanaf de opdrachtregel:code language-bash composer update magento/live-search --with-dependencies
Verwijderen Live Search uninstall
Om te verwijderen Live Search, zie Modules verwijderen.
Live Search pakketten packages
De Live Search de extensie bestaat uit de volgende pakketten:
module-live-search
module-live-search-adapter
- Rubriekbrowse - Routaanvragen van de winkel topnavigatie aan de zoekdienst.
- Globale zoekactie - Routverzoeken van de snel zoeken in de rechterbovenhoek van de winkel Live Search service.
module-live-search-storefront-popover
Live Search afhankelijkheden dependencies
Het volgende Live Search afhankelijkheden worden vastgelegd door 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
Geavanceerde concepten
De volgende secties verstrekken geavanceerdere onderwerpen wanneer het gebruiken Live Search en Catalog Service.
Endpoint
Live Search communiceert door het eindpunt bij https://catalog-service.adobe.io/graphql
.
Als Live Search geen toegang heeft tot de volledige productdatabase; Live Search GraphQL en Commerce core GraphQL zullen geen volledige pariteit hebben.
Het wordt geadviseerd om SaaS APIs direct te roepen - specifiek het eindpunt van de Dienst van de Catalogus.
- Verhoog de prestaties en verlaag de processorbelasting door het Commerce-database/Graphql-proces te omzeilen
- Profiteer van de Catalog Service federatie Live Search, Catalog Service, en Product Recommendations vanaf één eindpunt.
In sommige gevallen is het misschien beter om te bellen Catalog Service voor productdetails en soortgelijke gevallen. Zie refineProduct voor meer informatie .
Als u een aangepaste implementatie zonder kop hebt, checkt u de Live Search referentie-implementaties:
Als u niet de standaardcomponenten, zoals de Adapter of widgets van het Onderzoek op Luma, of AEM widgets gebruikt, zal de gebeurtenis (klikstroomgegevens die Adobe Sensei voor Intelligente Merchandising en prestatiesmetriek van de voer voorzien) niet uit de doos werken en zal de douaneontwikkeling vereisen om hoofdloze gebeurtenis uit te voeren.
De meest recente versie van Live Search reeds gebruikt Catalog Service.
Taalondersteuning
Live Search widgets ondersteunen de volgende talen:
Als de widget detecteert dat de taalinstelling Commerce Admin (Winkels > Instellingen > Configuratie > Algemeen > Landopties) komt overeen met een ondersteunde taal, de standaardtaal is die taal. Anders worden de widgets standaard ingesteld op Engels.
Beheerders kunnen ook de taal instellen van de zoekindex, zodat betere zoekresultaten worden verkregen.
Widget-codeopslagplaats
De widget pagina met productlijsten en de widget veld Live zoeken kunnen beide worden gedownload van hun kleine opslagplaats.
Op deze manier kunnen ontwikkelaars de functionaliteit en opmaak volledig aanpassen. Deze gebruikers ontvangen de code zelf terwijl nog steeds de voordelen van Live Search service.
Inventory management
Live Search supports Inventory management Mogelijkheden in Commerce (voorheen bekend als Multi-Source Inventory of MSI). Om volledige steun toe te laten, moet u update de afhankelijkheidsmodule commerce-data-export
naar versie 102.2.0+.
Live Search Geeft een Booleaanse waarde die aangeeft of een product beschikbaar is in Inventory management, maar geen informatie bevat over de bron van de voorraad.
Prijsindexering
Klanten met Live zoeken kunnen de nieuwe SaaS-prijsindexer, die snellere updates van prijswijzigingen en synchronisatietijd biedt.
Prijsondersteuning
Live zoekwidgets bieden ondersteuning voor de meeste, maar niet voor alle typen prijzen die door Adobe Commerce worden ondersteund.
Momenteel worden de basisprijzen ondersteund. Geavanceerde prijzen die niet worden ondersteund zijn:
- Kosten
- Minimale geadverteerde prijs
Kijk naar API-net voor complexere prijsberekeningen.
De prijsindeling ondersteunt de landinstellingsinstelling in de Commerce-instantie: Winkels > Instellingen > Configuratie > Algemeen > Algemeen > Lokale opties > Landinstelling.
Ondersteuning voor headless Storefront
Mogelijk moet u het dialoogvenster module-data-services-graphql
die de bestaande GraphQL-dekking van de toepassing uitbreidt en velden opneemt die vereist zijn voor het verzamelen van gedragsgegevens van de winkel.
composer require magento/module-data-services-graphql
Deze module voegt extra contexten aan de vragen van GraphQL toe:
dataServicesStorefrontInstanceContext
dataServicesMagentoExtensionContext
dataServicesStoreConfigurationContext
B2B-ondersteuning
Live Search supports B2B-functionaliteit met extra beperkingen.
PWA-ondersteuning
Live Search werkt met PWA Studio, maar gebruikers zien mogelijk kleine verschillen ten opzichte van andere Commerce-implementaties. De basisfunctionaliteit zoals zoeken en pagina met productlijsten werkt in Venia, maar sommige permutaties van Graphql werken mogelijk niet correct. Er kunnen ook prestatieverschillen zijn.
- De huidige PWA-uitvoering van Live Search vereist meer verwerkingstijd om zoekresultaten te retourneren dan Live Search met de native Commerce storefront.
- Live Search in PWA ondersteunt niet gebeurtenisafhandeling. Zodoende zullen zoekverslagen en intelligente koophandel werken.
- Rechtstreeks filteren op
description
,name
,short_description
wordt niet ondersteund door GraphQL bij gebruik met PWA, maar ze krijgen een meer algemeen filter.
Te gebruiken Live Search met PWA Studio moeten de integrators ook :
-
Installeren livessearch-storefront-utils.
-
Stel de
environmentId
in destoreDetails
object.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 verzamelt gegevens over gebruikersinteractie als onderdeel van de basisfunctionaliteit en cookies worden gebruikt om deze gegevens op te slaan. Wanneer de gebruiker om het even welke gebruikersinformatie verzamelt, moet de gebruiker ermee instemmen om koekjes op te slaan. Live Search en Product Recommendations delen de gegevensstroom en daarom het zelfde koekjesmechanisme. Meer informatie hierover vindt u in Cookie-beperkingen verwerken.