End-to-End-Anwendungsfall für Storefront- und Katalogadministrator
Dieser Anwendungsfall basiert auf einem fiktiven Automobilkonzern namens Carvelo Automobile, der über eine komplexe Betriebsstruktur verfügt. Es zeigt, wie Sie Adobe Commerce Optimizer verwenden können, um einen Katalog zu verwalten, der mehrere Marken, Händlergeschäfte und Preislisten unterstützt und gleichzeitig ein benutzerdefiniertes Storefront-Erlebnis bereitstellt.
Voraussetzungen
Dieses Anwendungsbeispiel richtet sich an Administratoren und Entwickler, die mithilfe von Adobe Commerce Optimizer erfahren möchten, wie eine Storefront eingerichtet und ein Katalog verwaltet wird. Es wird davon ausgegangen, dass Sie über ein grundlegendes Verständnis von Adobe Commerce Optimizer und seinen Funktionen verfügen.
Geschätzte Dauer: 45-60 Minuten
Erforderliche Einrichtung
Bevor Sie mit diesem Tutorial beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:
-
Adobe Commerce Optimizer-Instanz
- Zugriff auf eine Testinstanz in Cloud Manager
- Siehe Erste Schritte für Einrichtungsanweisungen
-
Benutzerberechtigungen
- Admin-Zugriff auf Adobe Admin Console
- Siehe Benutzerverwaltung für die Kontoeinrichtung
- Wenn Sie keinen Zugriff haben, wenden Sie sich an den Adobe-Kundenbetreuer.
-
Beispieldaten
- Carvelo Automobilkatalogdaten werden in Ihre Instanz geladen
- Befolgen Sie die Anweisungen im Datenaufnahme-Repository für den Beispielkatalog
- Sie können Beispieldaten nach Abschluss mit dem enthaltenen
reset.js
-Skript löschen
-
Storefront-Umgebung
- Lokale Entwicklungsumgebung mit Node.js
- Textbausteinprojekt für Storefront geklont und konfiguriert
- Siehe Storefront-Setup für detaillierte Anweisungen
Fangen wir an
In diesem Anwendungsbeispiel verwenden Sie Folgendes:
-
Adobe Commerce Optimizer-Benutzeroberfläche : Richten Sie Katalogansichten und Richtlinien ein, um die komplexe betriebliche Katalogeinrichtung für den Carvelo-Anwendungsfall zu verwalten.
-
Commerce-Storefront - Rendern Sie die Storefront mithilfe der Beispielkatalogdaten, die in Ihre Adobe Commerce Optimizer-Instanz geladen wurden, und der Konfigurationsdateien,
fstab.yaml
undconfig.json
der Commerce-Storefront.
Wichtige Erkenntnisse
Am Ende dieses Artikels werden Sie:
- Lernen Sie die Grundlagen der Adobe Commerce Optimizer mit ihrem leistungsfähigen und skalierbaren Katalogdatenmodell kennen.
- Erfahren Sie, wie das Katalogdatenmodell mit von Adobe erstellten plattformunabhängigen Storefront-Komponenten integriert wird.
- Erfahren Sie, wie Sie mit Katalogansichten und Richtlinien von Adobe Commerce Optimizer benutzerdefinierte Katalogansichten und Datenzugriffsfilter erstellen und die Daten an eine Adobe Commerce-Storefront mit Edge Delivery senden.
Geschäftsszenario - Carvelo Automobile
Carvelo Automobile ist ein fiktiver Automobilkonzern mit einem komplexen operativen Setup.
In diesem Diagramm sehen Sie, dass Carvelo Automobilprodukte von drei Marken verkauft. Jede Marke ist ein anderes untergeordnetes Unternehmen:
- Aurora (Elektrofahrzeuge)
- Schraube (SUVs)
- Cruz (Hybrid)
Es verkauft diese Marken über drei Händler:
- Arkbridge
- Kingsbluff
- Celport
Diese Vertragshändler gehören zwei verschiedenen Muttergesellschaften an:
- West Coast Inc. (Arkbridge)
- East Coast Inc. (Kingsbluff, Celport)
Jedes Unternehmen verfügt über zwei Preisbücher, mit denen Produkte zu einem bestimmten Preis für verschiedene Käufer (Basis, VIP) verkauft werden.
west_coast_inc
undvip_west_coast_inc
east_coast_inc
undvip_east_coast_inc
Wie Sie sehen können, ist dies ein sehr komplexer geschäftlicher Anwendungsfall. Mit Adobe Commerce Optimizer kann ein Händler eine komplexe Geschäftsstruktur unterstützen, indem er einen einzigen Basiskatalog verwendet, um Daten ohne Katalogduplizierung zu syndizieren, Preisbücher (30.000 Preisbücher) zu skalieren und all diese Daten an eine Edge Delivery Services-Storefront bereitzustellen.
Jetzt, da Sie einen Überblick über den geschäftlichen Anwendungsfall haben, ist hier Ihr Ziel, während Sie dieses Tutorial durcharbeiten:
Carvelo will Teile über seine drei Marken (Aurora, Bolt und Cruz) über die verschiedenen Händler (Arkbridge, Kingsbluff und Celport) verkaufen. Carvelo möchte sicherstellen, dass die Vertragshändler nur Zugang zu den korrekten Teilen und Preisen gemäß ihren jeweiligen Lizenzvereinbarungen haben.
Letztlich verfolgt Carvelo zwei Hauptziele:
- Pflegen Sie eine „globale“ Website, die alle SKUs aller drei Marken enthält.
- Geben Sie Händlern einen Pfad an, um ihre eigenen Storefronts einzurichten, die auf der eindeutigen SKU-Sichtbarkeit und den Preisen für jede SKU für jeden Händler basieren. Und das alles bei Verwendung eines einzigen Basiskatalogs, wodurch die Duplizierung von Katalogen vermieden wird.
1. Zugriff auf die Adobe Commerce Optimizer
Navigieren Sie zur URL für das Commerce Optimizer-Programm, die mit den Beispieldaten vorkonfiguriert ist. Sie finden die URL im Commerce Cloud Manager in den Instanzdetails für Ihr Commerce Optimizer-Projekt oder wenden sich an Ihren Systemadministrator. (Siehe Zugriff auf eine Instanz.)
Beim Starten von Adobe Commerce Optimizer wird Folgendes angezeigt:
Erweitern Sie in der linken Navigation den Abschnitt Store-Einrichtung und klicken Sie auf Catalog views. Beachten Sie, dass die Arkbridge- und Kingsbluff-Händler bereits Katalogansichten erstellt haben:
Klicken Sie auf das Infosymbol, um die Details der Katalogansicht anzuzeigen.
Arkbridge verfügt über die folgenden Richtlinien:
- Marke
- Modell
- Marken von West Coast Inc
- Arkbridge-Teilekategorien
Kingsbluff hat die folgenden Richtlinien:
- Marke
- Modell
- Marken von East Coast Inc
- Kingsbluff-Teilekategorien
Im nächsten Abschnitt erstellen Sie eine Katalogansicht und Richtlinien für den Celport-Händler.
2. Erstellen einer Richtlinien- und Katalogansicht
Carvelos E-Commerce-Manager muss eine neue Storefront für einen Händler namens Celport einrichten, der zum Unternehmen East Coast Inc gehört. Celport wird Bremsen und Federungen für die Marken Bolt und Cruz verkaufen.
Mit Adobe Commerce Optimizer wird der Commerce Manager:
-
Erstellen Sie eine neue Richtlinie mit dem Namen Celport-Teilekategorien, damit Celport nur Brems- und Federungsteile verkaufen kann.
-
Erstellen Sie eine neue Katalogansicht für die Celport-Storefront.
Diese Katalogansicht verwendet Ihre neu erstellte Richtlinie Celport-Teilekategorien und die vorhandenen East Coast Inc Brands, um sicherzustellen, dass Celport nur die Marken Bolt und Cruz als Teil der Vereinbarung mit East Coast Inc. verkaufen kann. Die Celport-Katalogansicht verwendet das
east_coast_inc
Preisbuch, um Produktpreispläne zu unterstützen, die mit den Lizenzvereinbarungen für Marken übereinstimmen. -
Aktualisieren Sie die Konfiguration der Commerce-Storefront, um Daten aus der von Ihnen erstellten Celport-Katalogansicht zu verwenden.
Am Ende dieses Abschnitts wird Celport für den Verkauf der Carvelo-Produkte bereit sein.
Erstellen einer Richtlinie
Erstellen wir eine neue Richtlinie mit dem Namen Celport-Teilekategorien um die SKUs zu filtern, die der Celport-Händler verkauft und die Brems- und Federungsteile enthalten.
-
Erweitern Sie in der linken Leiste den Abschnitt Store-Einrichtung und klicken Sie auf Policies.
-
Klicken Sie auf Create Policy.
Es wird eine neue Seite angezeigt, auf der Sie die Richtliniendetails hinzufügen können.
-
Fügen Sie die erforderlichen Details hinzu:
name = Celport-Teilekategorien
-
Klicken Sie auf Add Filter.
Es wird ein Dialogfeld angezeigt, in dem Sie Filterdetails hinzufügen können.
-
Fügen Sie die Filterdetails hinzu:
- Attribut = part_category
- Operator = IN
- Wert Source = STATIC
- Wert = Bremsen
- Wert = Aussetzung
note important IMPORTANT Jeder Attributwert muss separat eingegeben werden. Drücken Sie nach der Eingabe eines Werts Eingabetaste, um ihn zur Filterkonfiguration hinzuzufügen. Geben Sie dann den nächsten Wert ein. Alle Werte müssen genau mit dem SKU-Attributnamen im Katalog übereinstimmen. Weitere Informationen über den Unterschied zwischen einer STATIC- und einer TRIGGER-Wertquelle finden Sie unter Quelltypen von Werten.
-
Klicken Sie im Dialogfeld Filter details auf Save.
-
Um den soeben erstellten Filter zu aktivieren, klicken Sie auf die Aktionspunkte (…) und wählen Sie Aktivieren.
-
Klicken Sie auf Save.
note note NOTE Wenn die Schaltfläche Save nicht aktiv (blau) ist, fehlt möglicherweise der Richtlinienname. Klicken Sie auf das Stiftsymbol neben Neue Richtlinie, um sie hinzuzufügen. -
Gehen Sie zurück zur Liste der Richtlinien, indem Sie auf den Rückwärtspfeil klicken.
Die neue Celport-" wird in der Liste angezeigt.
So überprüfen Sie, ob dieser Schritt ordnungsgemäß abgeschlossen wurde:
- Richtlinie wird in der Liste Richtlinien angezeigt
- Richtlinienstatus wird als „Aktiviert“ angezeigt (grüne Anzeige)
- Filterdetails zeigen „Teil_Kategorie IN (Bremsen, Federung)“ an
- Richtlinienname ist „Celport Part Categories“
Erstellen einer Katalogansicht
Erstellen Sie eine neue Katalogansicht für den Celport-Händler und verknüpfen Sie die folgenden Richtlinien: East Coast Inc Marken und Celport Teilekategorien.
-
Erweitern Sie in der linken Leiste den Abschnitt Store-Einrichtung und klicken Sie auf Catalog views.
Beachten Sie die vorhandenen Katalogansichten: Arkbridge, Kingsbluff und Global.
-
Klicken Sie auf Add catalog view.
-
Füllen Sie die Details der Katalogansicht aus:
- name = Celport
- Catalog sources = en-US
- Richtlinien (Dropdown verwenden) = East Coast Inc Brands; Celport-Teilekategorien; Marke; Modell
-
Klicken Sie auf Add , um die Katalogansicht zu erstellen.
Die Seite mit den Katalogansichten wird aktualisiert, um die neue Katalogansicht anzuzeigen.
-
Rufen Sie die Celport-Katalogansichts-ID ab.
Klicken Sie auf das Informationssymbol für die Celport-Katalogansicht auf der Seite Katalogansichten.
Kopieren Sie die Katalogansichts-ID und speichern Sie sie. Sie benötigen diese ID, wenn Sie die Storefront-Konfiguration aktualisieren, um Daten an Ihren neuen Celport-Katalog zu senden.
So überprüfen Sie, ob dieser Schritt ordnungsgemäß abgeschlossen wurde:
- Name der Katalogansicht: „Celport“
- Katalogansicht zeigt 4 verknüpfte Richtlinien an
- Die Katalogansichts-ID wird angezeigt und kann kopiert werden
- Katalogquelle zeigt „en-US“
Nachdem Sie die Celport-Katalogansicht und die zugehörigen Richtlinien erstellt haben, besteht der nächste Schritt darin, die Storefront für die Verwendung Ihres neuen Celport-Katalogs zu konfigurieren.
3. Aktualisieren der Storefront
Der letzte Teil dieses Tutorials beinhaltet die Aktualisierung der Storefront, die Sie bereits erstellt haben um Daten an den neuen Celport-Katalog zu liefern. In diesem Abschnitt ersetzen Sie die Katalogansichts-ID in Ihrer Storefront-Konfigurationsdatei durch die Katalogansichts-ID für Celport.
-
Öffnen Sie in Ihrer lokalen Entwicklungsumgebung den Ordner, in den Sie das GitHub-Repository geklont haben, mit Ihren Textbausteinkonfigurationsdateien für die Storefront.
-
Öffnen Sie im Stammverzeichnis des Ordners die
config.json
.accordion config.json-Code code language-json { "public": { "default": { "commerce-core-endpoint": "https://www.aemshop.net/graphql", "commerce-endpoint": "https://na1-sandbox.api.commerce.adobe.com/Fwus6kdpvYCmeEdcCX7PZg/graphql", "headers": { "cs": { "ac-view-id": "9ced53d7-35a6-40c5-830e-8288c00985ad", "ac-price-book-id": "west_coast_inc", "ac-source-locale": "en-US" } }, "analytics": { "base-currency-code": "USD", "environment": "Production", "store-id": 1, "store-name": "ACO Demo", "store-url": "https://www.aemshop.net", "store-view-id": 1, "store-view-name": "Default Store View", "website-id": 1, "website-name": "Main Website" } } } }
Beachten Sie, dass die Kopfzeile der Katalogansicht die folgenden Werte enthält:
commerce-endpoint
:"https://na1-sandbox.api.commerce.adobe.com/Fwus6kdpvYCmeEdcCX7PZg/graphql"
ac-view-id
:"9ced53d7-35a6-40c5-830e-8288c00985ad"
ac-price-book-id
:"west_coast_inc"
ac-source-locale
:"en-US"
-
Ersetzen Sie im
commerce-endpoint
die Mandanten-ID in der URL durch die URL für Ihre Adobe Commerce Optimizer.Die Mandanten-ID finden Sie in der URL für die Commerce Optimizer-Benutzeroberfläche. Bei der folgenden URL ist die Mandanten-ID beispielsweise
XDevkG9W6UbwgQmPn995r3
.code language-text https://experience.adobe.com/#/@commerceprojectbeacon/in:XDevkG9W6UbwgQmPn995r3/commerce-optimizer-studio/catalog
-
Ersetzen Sie den
ac-view-id
Wert durch die Celport-Katalogansichts-ID, die Sie zuvor kopiert haben. -
Ersetzen Sie den
ac-price-book-id
durch"east_coast_inc"
.Nachdem Sie diese Änderungen vorgenommen haben, sollte Ihre
config.json
-Datei etwa wie folgt aussehen, wobei dieACO-tenant-id
undcelport-catalog-view-id
Platzhalter durch Ihre Werte ersetzt werden:code language-json { "public": { "default": { "commerce-core-endpoint": "https://www.aemshop.net/graphql", "commerce-endpoint": "https://na1-sandbox.api.commerce.adobe.com/{{ACO-tenant-id}}/graphql", "headers": { "cs": { "ac-view-id": "{{celport-catalog-view-id}}", "ac-price-book-id": "east_coast_inc", "ac-source-locale": "en-US" } }, "analytics": { "base-currency-code": "USD", "environment": "Production", "store-id": 1, "store-name": "ACO Demo", "store-url": "https://www.aemshop.net", "store-view-id": 1, "store-view-name": "Default Store View", "website-id": 1, "website-name": "Main Website" } } } }
-
Speichern Sie die Datei.
Wenn Sie die Änderungen speichern, aktualisieren Sie die Katalogkonfiguration, um die Carvelo-Katalogansicht zu verwenden, die so konfiguriert wurde, dass nur Brems- und Federungsteile verkauft werden.
4. Vorschau der Storefront
Nachdem Sie die Konfiguration der Storefront aktualisiert haben, um die Celport-Katalogansicht zu verwenden, können Sie eine Vorschau der Storefront anzeigen, um zu sehen, wie sie die Katalogdaten rendert.
-
Starten Sie die Storefront, um das Celport-spezifische Katalogerlebnis anzuzeigen, das von Ihrer Storefront-Konfiguration erstellt wurde.
-
Starten Sie im Terminal-Fenster in Ihrer IDE die Vorschau Ihrer lokalen Storefront.
code language-shell npm start
Der Browser öffnet die Vorschau der lokalen Entwicklung unter
http://localhost:3000
.Wenn der Befehl fehlschlägt oder sich der Browser nicht öffnet, lesen Sie die Anweisungen für die lokale Entwicklung im Thema „Storefront-Setup“.
-
-
Suchen Sie im Browser nach
brakes
und drücken Sie die Eingabetaste.Die Storefront wird aktualisiert, um die Produktlistenseite mit den Bremsteilen anzuzeigen.
Klicken Sie auf ein Bild eines Bremsteils, um die Produktdetails mit Preisinformationen anzuzeigen und die Produktpreisinformationen zu beachten.
-
Suchen Sie nach
tires
, was eine weitere Komponentenkategorie ist, die in den Anwendungsfalldaten auf Ihrer Adobe Commerce Optimizer-Instanz verfügbar ist.Es werden keine Ergebnisse zurückgegeben. Dies liegt daran, dass die Celport-Katalogansicht so konfiguriert wurde, dass nur Brems- und Federungsteile verkauft werden.
-
Experimentieren Sie mit der Aktualisierung Ihrer Storefront-Konfigurationsdatei (
config.json
).- Ändern Sie die
ac-view-id
- undac-price-book
.
Sie können beispielsweise die Katalogansichts-ID in die Kingsbluff-Katalogansicht und die Preisbuch-ID in
east_coast_inc
ändern. Sie können die für Kingsbluff verfügbaren Teilekategorien sehen, indem Sie die Richtlinie Kingsbluff-) lesen.-
Speichern Sie die Datei.
Wenn Sie die Datei speichern, wird die Vorschau der lokalen Storefront automatisch aktualisiert.
-
Zeigen Sie eine Vorschau der Änderungen im Browser an, indem Sie die Suchfunktion verwenden, um Reifenteile zu finden.
Beachten Sie die verschiedenen verfügbaren Teiletypen und die Preise, die der Kingsbluff-Katalogansicht zugeordnet sind.
Diese Experimente zeigen die Flexibilität von Adobe Commerce Optimizer. Sie können schnell zwischen verschiedenen Katalogansichten und Preisverzeichnissen wechseln, um benutzerdefinierte Einkaufserlebnisse für verschiedene Zielgruppen zu erstellen, ohne Ihre Katalogdaten zu duplizieren.
- Ändern Sie die
Fehlerbehebung
Wenn während dieses Tutorials Probleme auftreten, versuchen Sie die folgenden Lösungen:
Probleme bei der Richtlinienerstellung
Problem: Schaltfläche „Speichern“ ist nicht aktiv
- Lösung: Stellen Sie sicher, dass der Richtlinienname eingegeben und alle erforderlichen Felder ausgefüllt sind
Problem: Filter funktioniert nicht erwartungsgemäß
- Lösung: Überprüfen Sie, ob der Attributname genau mit dem SKU-Attribut in Ihrem Katalog übereinstimmt.
Probleme mit der Katalogansicht
Problem: Katalogansicht wird nicht in der Liste angezeigt
- Lösung: Stellen Sie sicher, dass alle zugehörigen Richtlinien aktiviert und ordnungsgemäß konfiguriert sind
Storefront-Konfigurationsprobleme
Problem: Storefront wird nicht geladen
- Lösung: Überprüfen Sie, ob Ihre Mandanten-ID und Katalogansichts-ID in der Datei config.json korrekt eingegeben wurden
Problem: Keine Produkte angezeigt
- Lösung: Überprüfen Sie, ob die Preisbuch-ID mit der in Ihrer Adobe Commerce Optimizer-Instanz verfügbaren ID übereinstimmt.
Problem: Suche gibt keine Ergebnisse zurück
- Lösung: Vergewissern Sie sich, dass die Richtlinien zur Katalogansicht die durchsuchte Produktkategorie zulassen.
Weitere Hilfe finden Sie in der Dokumentation zu Adobe Commerce Optimizer oderSie sich an den Adobe-Support.
Zusammenfassung
In diesem Tutorial haben Sie erfolgreich:
- Neue Richtlinie zum Filtern von Produktkategorien für den Celport-Händler erstellt
- Einrichten einer Katalogansicht mit mehreren Richtlinien zur Steuerung der Produktansicht
- Storefront zur Verwendung der neuen Katalogansicht konfiguriert
- Konfiguration überprüft, indem Sichtbarkeit und Preise des Produkts getestet wurden.
Nächste Schritte
So erfahren Sie mehr über Adobe Commerce Optimizer:
- Erkunden Sie Merchandising-Funktionen um das Einkaufserlebnis zu personalisieren
- Erfahren Sie mehr erweiterte Richtlinienkonfigurationen
- ( Katalogansichten)andere Händler einrichten
- Lesen Sie die API-Dokumentation für die programmgesteuerte Katalogverwaltung
- Erfahren Sie, wie Sie Dropdown-Komponenten für Ihre Edge Delivery Services-Storefront konfigurieren, um benutzerdefinierte Storefront-Erlebnisse für die Produkterkennung, Empfehlungen und andere Storefront-Funktionen zu erstellen. Siehe die Storefront-Dokumentation