Für Erfolg mit Live Search einrichten

Adobe Commerce Live Search und Catalog Service arbeiten zusammen, um eine leistungsfähige, relevante und intuitive Suchlösung bereitzustellen, mit der Ihre Kunden schnell genau das finden können, was sie benötigen. Genauer gesagt überdeckt Catalog Service Ihre Katalogdaten für SaaS-Dienste, z. B. Live Search.

Dieser Artikel enthält schrittweise Anweisungen zur Implementierung von Live Search mit Catalog Service.

IMPORTANT
Wenn es um die Site-Suche geht, bietet Ihnen Adobe Commerce Optionen. Lesen Sie vor der Implementierung unbedingt Grenzen und Beschränkungen , um sicherzustellen, dass Live Search Ihren Geschäftsanforderungen entspricht.

Zielgruppe

Dieser Artikel richtet sich an Entwickler oder Systemintegratoren in Ihrem Team, die für die Installation und Konfiguration Ihrer Adobe Commerce-Instanz zuständig sind.

Voraussetzungen

Unterstützte Plattformen

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

Workflow-Übersicht

Auf hoher Ebene erfordert das Onboarding von Live Search, dass Sie:

  1. Installieren der Live Search-Erweiterung
  2. Konfigurieren der API-Schlüssel
  3. Synchronisieren Ihrer Katalogdaten
  4. Überprüfen , ob die Katalogdaten exportiert wurden
  5. Konfigurieren der Daten
  6. Testen der Verbindung
  7. Überprüfen, ob Ereignisse Daten erfassen
  8. Anpassen der Storefront

1. Installieren Sie die Live Search -Erweiterung

Live Search wird als Erweiterung von Adobe Marketplace bis Composer installiert. Nach der Installation und Konfiguration von Live Search beginnt Adobe Commerce mit der Freigabe von Such- und Katalogdaten für SaaS-Dienste. An dieser Stelle können Benutzer von Admin Suchfacetten, Synonyme und Merchandising-Regeln einrichten, anpassen und verwalten.

NOTE
Ab Live Search 3.0.2 ist die Catalog Service -Erweiterung im Paket mit der Live Search -Installation enthalten.
  1. Vergewissern Sie sich, dass cron-Aufträge und Indexer ausgeführt werden.

    note important
    IMPORTANT
    Aufgrund der Ankündigung zum Ende der Unterstützung für Elasticsearch 7 vom August 2023 wird empfohlen, dass alle Adobe Commerce-Kunden zur OpenSearch 2.x-Suchmaschine migrieren. Weitere Informationen zur Migration Ihrer Suchmaschine während eines Produkt-Upgrades finden Sie unter Migration zu OpenSearch im Upgrade-Handbuch.
  2. Laden Sie das Paket live-search vom Adobe Marketplace herunter.

  3. Führen Sie Folgendes über die Befehlszeile aus:

    code language-bash
    composer require magento/live-search
    

    Wenn Sie die Erweiterung Live Search zu einer Adobe Commerce-Installation vom Typ new hinzufügen, führen Sie den folgenden Befehl aus, um OpenSearch und die zugehörigen Module vorübergehend zu deaktivieren, und installieren Sie Live Search. Fahren Sie dann mit Schritt 4 fort.

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

    Wenn Sie die Erweiterung Live Search zu einer vorhandenen Adobe Commerce-Installation von 2} hinzufügen, führen Sie Folgendes aus, um die Live Search -Module zu deaktivieren, die Storefront-Suchergebnisse bereitstellen. Fahren Sie dann mit Schritt 4 fort:

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

    Elasticsearch verwaltet weiterhin Suchanforderungen aus dem Store, während der Live Search-Dienst Katalogdaten synchronisiert und Produkte im Hintergrund indiziert.

  4. Führen Sie Folgendes aus:

    code language-bash
    bin/magento setup:upgrade
    
  5. Stellen Sie sicher, dass die folgenden Indexer auf "Nach Zeitplan aktualisieren"eingestellt sind:

    • Produkt-Feed
    • Produktvarianten-Feed
    • Katalogattribut-Feed
    • Produktpreis-Feed
    • Umfang des Website-Daten-Feeds
    • Umfang des Daten-Feeds für Kundengruppen
    • Kategorien-Feed
    • Kategorieberechtigungs-Feed
  6. Wenn Sie Live Search auf einer neuen Commerce-Instanz installieren, sind Sie fertig und können zu 2 überspringen. Konfigurieren Sie den Abschnitt "API-Schlüssel". Wenn Sie die Live-Suche in einer vorhandenen Commerce-Instanz installieren, fahren Sie mit dem nächsten Schritt fort.

  7. Führen Sie die folgenden Befehle aus, um die Erweiterung Live Search zu aktivieren, OpenSearch zu deaktivieren und setup auszuführen.

    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
    

Installieren der Live Search Beta-Version

IMPORTANT
Die folgende Funktion befindet sich in der Beta-Phase. Um an der Beta-Version teilzunehmen, senden Sie eine E-Mail-Anfrage an commerce-store-front-services.

Diese Beta-Version unterstützt drei neue Funktionen in der productSearch-Abfrage:

  • Ebenensuche - Suche in einem anderen Suchkontext - Mit dieser Funktion können Sie bis zu zwei Ebenen der Suche für Ihre Suchabfragen durchführen. Beispiel:

    • Suche auf Ebene 1 - Suchen Sie nach "motor"auf "product_attribute_1".
    • Suche auf Ebene 2 - Suchen Sie nach "Teilenummer 123"auf "product_attribute_2". In diesem Beispiel wird in den Ergebnissen nach "motor"nach "part number 123"gesucht.

    Die Ebenensuche ist für die Suchindexierung startsWith und die Suchindexierung contains wie unten beschrieben verfügbar:

  • startsWith search indexation - Suche mithilfe der startsWith -Indexierung. Diese neue Funktion ermöglicht Folgendes:

    • Suchen nach Produkten, bei denen der Attributwert mit einer bestimmten Zeichenfolge beginnt.
    • Konfiguration einer Suche "endet mit", damit Käufer nach Produkten suchen können, bei denen der Attributwert mit einer bestimmten Zeichenfolge endet. Um die Suche "endet mit"zu aktivieren, muss das Produktattribut umgekehrt aufgenommen werden und der API-Aufruf sollte auch eine umgekehrte Zeichenfolge sein.
  • enthält Suchindexierung - Suchen Sie nach einem Attribut, das die Indexierung enthält. Diese neue Funktion ermöglicht Folgendes:

    • Suchen nach einer Abfrage in einer größeren Zeichenfolge. Beispiel: Ein Käufer sucht in der Zeichenfolge "HAPE-123"nach der Produktnummer "PE-123".

      • Hinweis: Dieser Suchtyp unterscheidet sich von der vorhandenen Phrasensuche, die eine automatische Suche durchführt. Wenn Ihr Produktattributwert beispielsweise "Hosen im Freien"lautet, gibt die Wortgruppensuche eine Antwort für "out pan"zurück, gibt jedoch keine Antwort für "oor ants"zurück. Eine enthält Suche gibt jedoch eine Antwort für "oor ants"zurück.

Diese neuen Bedingungen verbessern den Filtermechanismus für Suchabfragen, um die Suchergebnisse zu verfeinern. Diese neuen Bedingungen wirken sich nicht auf die Hauptsuchabfrage aus.

Sie können diese neuen Bedingungen auf Ihrer Suchergebnisseite implementieren. Sie können beispielsweise einen neuen Abschnitt auf der Seite hinzufügen, in dem der Käufer seine Suchergebnisse weiter verfeinern kann. Sie können es Kunden ermöglichen, bestimmte Produktattribute auszuwählen, z. B. "Hersteller", "Artikelnummer"und "Beschreibung". Von dort aus suchen sie in diesen Attributen mit den Bedingungen contains oder startsWith. Eine Liste der durchsuchbaren Attribute finden Sie im Administratorhandbuch.

  1. Um die Beta-Version zu installieren, fügen Sie Ihrem Projekt die folgende Abhängigkeit hinzu:

    code language-bash
    composer require magento/module-live-search-search-types:"^1.0.0-beta1"
    
  2. Übertragen Sie die Änderungen und übertragen Sie sie in Ihre composer.json - und composer.lock -Dateien in Ihr Cloud-Projekt. Weitere Infos.

    Diese Beta-Version fügt Search types Checkboxes für Autocomplete, Contains und Starts with im Admin hinzu. Außerdem wird die GraphQL-API productSearch aktualisiert, um diese neuen Suchfunktionen aufzunehmen.

  3. Legen Sie in Admin ein Produktattribut fest, das durchsuchbar ist, und geben Sie die Suchfunktion für dieses Attribut an, z. B. Enthält (Standard) oder Beginnt mit. Sie können maximal sechs Attribute festlegen, die für Enthält aktiviert werden sollen, sowie sechs Attribute, die für Beginnt mit aktiviert werden sollen. Beachten Sie bei der Beta-Version, dass der Administrator diese Einschränkung nicht durchsetzt, sie jedoch bei API-Suchen erzwungen wird.

    Festlegen der Suchfunktion

  4. In der Entwicklerdokumentation erfahren Sie, wie Sie Ihre Live Search -API-Aufrufe mit den neuen Suchfunktionen contains und startsWith aktualisieren.

Feldbeschreibungen

Feld
Beschreibung
Autocomplete
Standardmäßig aktiviert und kann nicht geändert werden. Mit Autocomplete können Sie contains im Suchfilter verwenden. Hier gibt die Suchabfrage in contains eine Suchanfrage vom Typ autocomplete zurück. Adobe empfiehlt die Verwendung dieser Art der Suche nach Beschreibungsfeldern, die in der Regel mehr als 50 Zeichen enthalten.
Contains
Aktiviert die Suche "Text, der in einer Zeichenfolge enthalten ist"anstelle einer automatischen Suche. Verwenden Sie contains im Suchfilter. Weitere Informationen finden Sie unter Einschränkungen .
Starts with
Ermöglicht Ihnen die Abfrage von Zeichenfolgen, die mit einem bestimmten Wert beginnen. Verwenden Sie startsWith im Suchfilter.

2. API-Schlüssel konfigurieren

Der Adobe Commerce-API-Schlüssel und der zugehörige private Schlüssel sind erforderlich, um Live Search mit einer Installation von Adobe Commerce zu verbinden. Der API-Schlüssel wird im Konto des Commerce -Lizenzinhabers generiert und verwaltet, der ihn für den Entwickler oder den Systemintegrator freigeben kann. Der Entwickler kann dann die SaaS-Datenräume im Auftrag des Lizenzinhabers erstellen und verwalten. Wenn Sie bereits über eine Reihe von API-Schlüsseln verfügen, müssen Sie diese nicht neu generieren.

Erfahren Sie, wie Sie Ihre API-Schlüssel im Artikel Commerce Services Connector konfigurieren.

3. Ihre Katalogdaten synchronisieren synchronize-catalog-data

Live Search verschiebt Katalogdaten in die Adobe SaaS-Infrastruktur. Die Daten werden indiziert und die Suchergebnisse werden von diesem Index direkt an die Storefront übermittelt. Je nach Größe und Komplexität kann die Indizierung zwischen 30 Minuten und einigen Stunden dauern.

Um die erste Synchronisierung Ihrer Katalogdaten mit SaaS-Diensten zu starten, führen Sie die folgenden Befehle in dieser Reihenfolge aus:

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

Wenn Sie diese Befehle ausführen, beginnt die erste Synchronisierung Ihrer Katalogdaten mit SaaS-Diensten.

WARNING
Während die Daten indiziert und synchronisiert sind, sind die Such- und Kategoriedurchsuchvorgänge nicht in der Storefront verfügbar. Je nach Größe Ihres Katalogs kann es mindestens eine Stunde dauern, bis cron ausgeführt wird, bis der Prozess Ihre Daten mit den SaaS-Diensten synchronisiert.

Fortschritt der Synchronisierung überwachen

Sie können die synchronisierten und freigegebenen Daten über das Data Management Dashboard anzeigen. Dieses Dashboard bietet wertvolle Einblicke in die Verfügbarkeit von Produktdaten für Ihre Storefront, sodass sie Ihren Käufern umgehend angezeigt werden können.

Dashboard Datenverwaltung

Sie können auch Synchronisierungsbefehle ausführen und Fehler im Synchronisierungsprozess mithilfe der Protokolle Commerce CLI und der Datenexport-Erweiterung beheben.

Zukünftige Produktaktualisierungen

Nach der ersten Synchronisierung kann es bis zu 15 Minuten dauern, bis inkrementelle Produktaktualisierungen für die Storefront-Suche verfügbar sind. Weitere Informationen finden Sie unter Streaming von Produktaktualisierungen in der Indizierungsdokumentation.

4. Überprüfen, ob die Daten exportiert wurden verify-export

Um zu überprüfen, ob Ihre Katalogdaten aus Adobe Commerce exportiert und mit Live Search synchronisiert wurden, haben Sie einige Optionen:

  • Suchen Sie in den folgenden Tabellen nach Einträgen:

    • cde_products_feed
    • cde_product_attributes_feed
    note note
    NOTE
    Wenn der Fehler table does not exist auftritt, suchen Sie nach Einträgen in den Tabellen catalog_data_exporter_products und catalog_data_exporter_product_attributes. Diese Tabellennamen werden in Live Search -Versionen vor 4.2.1 verwendet.
  • Verwenden Sie den GraphQL-Playground mit der Standardabfrage, um Folgendes zu überprüfen:

    • Die zurückgegebene Produktanzahl entspricht in etwa dem, was Sie für die Store-Ansicht erwarten.
    • Facets werden zurückgegeben.

Weitere Hilfe finden Sie unter Live Search Nicht synchronisierter Katalog in der Support-Wissensdatenbank.

5. Konfigurieren der Daten

Durch die korrekte Konfiguration Ihrer Produktdaten werden gute Suchergebnisse für Ihre Kunden sichergestellt. In diesem Abschnitt aktivieren Sie die Widgets zur Produktliste und weisen Kategorien zu.

Widgets zur Produktliste aktivieren

Wenn Sie Live Search 4.0.0+ installieren, sind die Widgets für die Produktliste standardmäßig aktiviert. Wenn Widgets aktiviert sind, wird eine andere UI-Komponente für die Suchergebnisseite und die Produktlistenseite zum Durchsuchen von Kategorien verwendet. Diese UI-Komponente führt direkte Aufrufe an die Catalog Service-API durch, was zu schnelleren Antwortzeiten führt.

Wenn Sie eine Live Search -Version vor 4.0.0+ haben, müssen Sie das Widget "Produktliste"manuell aktivieren.

  1. Navigieren Sie vom Admin zu Stores > Settings>Configuration.

  2. Wählen Sie unter "Live Search"die Option "Storefront Features".

  3. Setzen Sie Enable Product Listing Widgets auf Yes.

    Aktiviert die Widgets zur Produktliste

Wenn Sie diese Konfiguration ändern, wird die Meldung Page cache is invalidated angezeigt. Sie müssen den Magento-Cache leeren, um Ihre Änderung zu speichern.

  1. Greifen Sie auf die Seite Cache-Verwaltung zu, indem Sie einen der folgenden Schritte ausführen:

    • Klicken Sie auf den Link Cache Management in der Meldung über dem Arbeitsbereich.
    • Wechseln Sie in der Seitenleiste Admin zu System > Tools>Cache Management.
  2. Wählen Sie die Konfiguration Cache Type aus und klicken Sie auf Flush Magento Cache.

    Änderungen an der Storefront werden unmittelbar nach dem Leeren des Caches vorgenommen.

Zuweisen von Kategorien

Produkte, die in Live Search zurückgegeben werden, müssen einer Kategorie zugewiesen werden. In Luma beispielsweise werden Produkte in Kategorien wie "Männer", "Frauen"und "Zahnrad"unterteilt. Unterkategorien sind auch "Tops", "Bottom" und "Watches". Diese Kategoriezuweisungen verbessern die Granularität beim Filtern.

6. Verbindung testen test-connection

Testen Sie mit Ihren Katalogdaten jetzt in SaaS, um sicherzustellen, dass in den folgenden Szenarien Produktdaten zurückgegeben werden:

  • Das Feld Search gibt die Ergebnisse korrekt zurück
  • Kategoriesuche gibt Ergebnisse korrekt zurück
  • Facets sind als Filter auf Suchergebnisseiten verfügbar

Wenn alles ordnungsgemäß funktioniert, ist Live Search installiert, verbunden und einsatzbereit.

Wenn Sie im Storefront auf Probleme stoßen, überprüfen Sie die Datei "var/log/system.log"auf API-Kommunikationsfehler oder -fehler auf der Dienstseite.

Um Live Search über eine Firewall zuzulassen, fügen Sie commerce.adobe.io zur Zulassungsliste hinzu.

7. Stellen Sie sicher, dass Ereignisse Daten erfassen.

Stellen Sie sicher, dass die auf Ihrer Site bereitgestellten Storefront-Ereignisse funktionieren. Dies ist besonders für Headless-Implementierungen wichtig.

  • Überprüfen Sie die für Live Search erforderlichen Ereignisse.
  • Stellen Sie sicher, dass das Dashboard Live-Suche Daten aus Ihrer/Ihren Nicht-Produktionsumgebung(en) anzeigt.
  • Ereignisabruf überprüfen. Während sich diese Seite im Product Recommendations -Handbuch befindet, gelten auch die Überprüfungsschritte für Live Search.

8. Benutzerspezifisch für Ihre Storefront

Sie haben Ihre Daten installiert, synchronisiert, validiert und konfiguriert. Live Search Der nächste Schritt besteht darin sicherzustellen, dass die Live Search -Widgets dem Aussehen und dem Erscheinungsbild Ihres Stores entsprechen.

Sie können die Popover- und PLP-Widgets gestalten, indem Sie nach Bedarf benutzerdefinierte CSS-Regeln definieren. Siehe Formatieren von Popover-Elementenund Produktanlistungs-Seiten-Widget.

Wenn Sie die Funktionalität der Widgets erweitern möchten, ist der Quellcode für jedes in einem öffentlichen Repository verfügbar.
In diesem Szenario können Sie die JavaScript an Ihre eigenen Anforderungen anpassen und dann Ihren benutzerdefinierten Code auf Ihrem CDN hosten. Dieses benutzerdefinierte Skript kommuniziert mit dem Live Search -Dienst und gibt die Ergebnisse wie normal zurück, sodass Sie die Funktionalität des Widgets steuern können.

Aktualisieren von Live Search update

Führen Sie vor der Aktualisierung der Live Search-Suche Folgendes über die Befehlszeile aus, um die installierte Live Search-Version zu überprüfen:

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

Um Live Search zu aktualisieren, führen Sie Folgendes über die Befehlszeile aus:

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

Um auf eine Hauptversion wie 3.1.1 auf 4.0.0 zu aktualisieren, bearbeiten Sie die Stammdatei des Projekts Composer .json wie folgt:

  1. Wenn Ihre derzeit installierte magento/live-search -Version 3.1.1 oder niedriger ist und Sie auf Version 4.0.0 oder höher aktualisieren, führen Sie vor dem Upgrade den folgenden Befehl aus:

    code language-bash
    bin/magento module:enable Magento_AdvancedSearch
    

    Führen Sie den folgenden Befehl aus, um Informationen zur derzeit installierten Version von magento/live-search zu erhalten:

    code language-bash
    composer show magento/live-search
    
  2. Öffnen Sie die Stammdatei composer.json und suchen Sie nach magento/live-search.

  3. Aktualisieren Sie im Abschnitt require die Versionsnummer wie folgt:

    code language-json
    "require": {
       ...
       "magento/live-search": "^4.0",
       ...
     }
    
  4. Speichern Sie composer.json. Führen Sie dann Folgendes über die Befehlszeile aus:

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

Deinstallieren von Live Search uninstall

Informationen zum Deinstallieren von Live Search finden Sie unter Module deinstallieren.

Live Search Pakete packages

Die Erweiterung Live Search besteht aus den folgenden Paketen:

Paket
Beschreibung
module-live-search
Ermöglicht Händlern, ihre Sucheinstellungen für Facetten, Synonyme, Abfrageregeln usw. zu konfigurieren und bietet Zugriff auf einen schreibgeschützten GraphQL-Player, auf dem Abfragen vom Admin getestet werden können.
module-live-search-adapter
Sendet Suchanfragen von der Storefront an den Dienst Live Search und rendert die Ergebnisse in der Storefront.
- Kategoriedurchsuchen - Routen von Anforderungen aus der Storefront oberste Navigation zum Suchdienst.
- Globale Suche - Routet Anfragen aus dem Feld Schnellsuche oben rechts im Storefront zum Dienst Live Search.
module-live-search-storefront-popover
Ein Popup "Suche beim Eingeben"ersetzt die standardmäßige Schnellsuche und gibt Daten und Miniaturansichten der Top-Suchergebnisse zurück.

Live Search dependencies dependencies

Das Composer -Metapaket zur Installation der Live Search -Erweiterung umfasst die folgenden Modulabhängigkeiten.

  • 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

Erweiterte Konzepte

Die folgenden Abschnitte enthalten erweiterte Themen bei Verwendung von Live Search und Catalog Service.

Endpunkt

Live Search kommuniziert über den Endpunkt bei https://catalog-service.adobe.io/graphql.

Da Live Search keinen Zugriff auf die gesamte Produktdatenbank hat, weisen die zentralen GraphQL-APIs für Live Search GraphQL und Commerce keine vollständige Parität auf.

Adobe empfiehlt, die SaaS-APIs direkt aufzurufen - insbesondere den Catalog Service-Endpunkt.

  • Steigern Sie die Leistung und reduzieren Sie die Prozessorlast durch Umgehen der Commerce-Datenbank/des Graphql-Prozesses.
  • Nutzen Sie die Catalog Service -Föderation, um Live Search, Catalog Service und Product Recommendations von einem einzelnen Endpunkt aus aufzurufen.

Für einige Anwendungsfälle ist es möglicherweise besser, Catalog Service für Produktdetails und ähnliche Fälle aufzurufen. Weitere Informationen finden Sie unter refineProduct .

Wenn Sie über eine benutzerdefinierte Headless-Implementierung verfügen, sehen Sie sich die Live Search-Referenzimplementierungen an:

Die automatische Erfassung von Benutzerinteraktionsdaten funktioniert nicht standardmäßig, wenn Sie nicht die Standardkomponenten wie den Suchadapter, Luma-Widgets oder AEM CIF Widgets verwenden. Adobe Sensei verwendet diese erfassten Daten für intelligentes Merchandising und Performance-Tracking. Um dieses Problem zu beheben, müssen Sie eine benutzerdefinierte Lösung entwickeln, um diese Datenerfassung Headless zu implementieren.

Die neueste Version von Live Search verwendet bereits Catalog Service.

Sprachunterstützung

Live Search -Widgets unterstützen die folgenden Sprachen:

Sprache
Region
Sprachcode
Magento Locale
bulgarisch
Bulgarien
bg_BG
bg_BG
Katalan
Spanien
ca_ES
ca_ES
tschechisch
Tschechische Republik
cs_CZ
cs_CZ
dänisch
Dänemark
da_DK
da_DK
deutsch
Deutschland
de_DE
de_DE
griechisch
Griechenland
el_GR
el_GR
englisch
Vereinigtes
en_GB
en_GB
englisch
Vereinigte Staaten
en_US
en_US
spanisch
Spanien
es_ES
es_ES
estnisch
Estland
et_EE
et_EE
Baskisch
Spanien
eu_ES
eu_ES
Persisch
Iran
fa_IR
fa_IR
finnisch
Finnland
fi_FI
fi_FI
französisch
Frankreich
fr_FR
fr_FR
Galizisch
Spanien
gl_ES
gl_ES
Hindi
Indien
hi_IN
hi_IN
ungarisch
Ungarn
hu_HU
hu_HU
Indonesisch
Indonesien
id_ID
id_ID
italienisch
Italien
it_IT
it_IT
Koreanisch
Südkorea
ko_KR
ko_KR
litauisch
Litauen
lt_LT
lt_LT
lettisch
Lettland
lv_LV
lv_LV
norwegisch
Norwegen Bokmal
nb_NO
nb_NO
holländisch
Niederlande
nl_NL
nl_NL
polnisch
Polen
pl_PL
pl_PL
portugiesisch
Brasilien
pt_BR
pt_BR
portugiesisch
Portugal
pt_PT
pt_PT
rumänisch
Rumänien
ro_RO
ro_RO
Russisch
Russland
ru_RU
ru_RU
schwedisch
Schweden
sv_SE
sv_SE
Thailändisch
Thailand
th_TH
th_TH
türkisch
Türkei
tr_TR
tr_TR
Chinesisch
China
zh_CN
zh_Hans_CN
Chinesisch
Taiwan
zh_TW
zh_Hant_TW

Wenn das Widget erkennt, dass die Commerce Admin-Spracheinstellung mit einer unterstützten Sprache übereinstimmt, wird standardmäßig diese Sprache verwendet. Andernfalls wird für das Widget standardmäßig "Englisch"verwendet. Im Admin wird die Spracheinstellung konfiguriert, indem Sie zu Stores> Settings >Configuration > General> Country Options navigieren.

Administratoren können auch die Sprache des Suchindex festlegen, um bessere Suchergebnisse sicherzustellen.

Widget-Code-Repository

Der Code für das Widget zur Produktlistenseite und das Widget zum Live-Suchfeld können von GitHub heruntergeladen werden.

Entwickler, die Zugriff auf den Code haben, können seine Funktionsweise und Darstellung vollständig anpassen. Sie hosten den Code auf ihren eigenen Servern, verwenden jedoch weiterhin den Live Search-Dienst.

Datenexport-Erweiterung

Nachdem die Live Search-Funktion aktiviert wurde, synchronisiert die Datenexport-Erweiterung Commerce-Daten zwischen der Commerce-Anwendung und der Live Search. Dadurch wird sichergestellt, dass die aktuellsten Commerce-Daten auf der Storefront verfügbar sind. Im Admin können Sie den Synchronisierungsstatus über das Data Management-Dashboard überprüfen. Sie können den Datenexportprozess mithilfe der Commerce-CLI und -Protokolle verwalten und beheben. Weitere Informationen finden Sie im Datenexport-Handbuch.

Inventory management

Live Search unterstützt die Funktionen von Inventory management in Commerce (ehemals "Multi-Source-Inventar"oder "MSI"). Um die vollständige Unterstützung zu aktivieren, müssen Sie das Abhängigkeitsmodul commerce-data-export auf Version 102.2.0+ aktualisieren.

Live Search gibt einen booleschen Hinweis zurück, ob ein Produkt in Inventory management verfügbar ist, enthält jedoch keine Informationen darüber, welche Quelle den Bestand hat.

Preisindex

Live Search-Kunden können den SaaS-Preisindex verwenden, der schnellere Preisänderungen und Synchronisierungszeiten ermöglicht.

Preisstützung

Live Search-Widgets unterstützen die meisten, aber nicht alle von Adobe Commerce unterstützten Preistypen.

Derzeit werden Basispreise unterstützt. Folgende erweiterte Preise werden nicht unterstützt:

  • Kosten
  • Mindestpreis für Werbung

Komplexere Preisberechnungen finden Sie unter API-Mesh .

Das Preisformat unterstützt die Gebietsschema-Konfigurationseinstellung in der Commerce-Instanz: Stores > Einstellungen > Konfiguration > Allgemein > Allgemein > Lokale Optionen > Gebietsschema.

Headless-Storefront-Unterstützung

Optional müssen Sie möglicherweise das module-data-services-graphql -Modul installieren, das die bestehende GraphQL-Abdeckung der Anwendung erweitert und Felder enthält, die für die Erfassung von verhaltensbezogenen Storefront-Daten erforderlich sind.

composer require magento/module-data-services-graphql

Dieses Modul fügt GraphQL-Abfragen zusätzliche Kontexte hinzu:

  • dataServicesStorefrontInstanceContext
  • dataServicesMagentoExtensionContext
  • dataServicesStoreConfigurationContext

B2B-Unterstützung

Live Search unterstützt B2B-Funktionalität mit zusätzlichen Einschränkungen.

PWA-Unterstützung

Live Search funktioniert mit PWA Studio, aber die Benutzer sehen möglicherweise geringfügige Unterschiede im Vergleich zu anderen Commerce-Implementierungen. Grundlegende Funktionen wie Such- und Produktlistenseite funktionieren in Venia, aber einige Permutationen von Graphql funktionieren möglicherweise nicht ordnungsgemäß. Es kann auch Leistungsunterschiede geben.

  • Die aktuelle PWA-Implementierung von Live Search erfordert mehr Verarbeitungszeit, um Suchergebnisse zurückzugeben als Live Search mit der nativen Commerce-Storefront.
  • Live Search in PWA unterstützt nicht die Ereignisverarbeitung. Daher funktionieren Suchberichte und intelligente Merchandising nicht auf PWA-Storefronts.
  • Bei Verwendung von PWA Studio unterstützt GraphQL das direkte Filtern nach description, name und short_description nicht. Diese Felder können jedoch mit einem allgemeineren Filter zurückgegeben werden.

Um Live Search mit PWA Studio zu verwenden, müssen Integratoren auch:

  1. Installieren Sie livesearch-storefront-utils.

  2. Legen Sie die environmentId im Objekt storeDetails fest.

    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 erfasst Benutzerinteraktionsdaten im Rahmen seiner grundlegenden Funktionalität und Cookies werden zum Speichern dieser Daten verwendet. Beim Erfassen von Benutzerinformationen muss der Benutzer dem Speichern von Cookies zustimmen. Live Search und Product Recommendations teilen den Datenstrom und daher denselben Cookie-Mechanismus. Weitere Informationen dazu finden Sie unter Umgang mit Cookie-Einschränkungen.

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