Caso di utilizzo end-to-end per Storefront e Catalog Administrator
Questo caso d’uso si basa su un conglomerato automobilistico fittizio denominato Carvelo Automobile, che dispone di una configurazione operativa complessa. Viene illustrato come utilizzare Adobe Commerce Optimizer per gestire un catalogo che supporta più marchi, concessionari e listini prezzi, offrendo al contempo un'esperienza di vetrina personalizzata.
Prerequisiti
Questo caso d'uso è progettato per amministratori e sviluppatori che desiderano imparare a configurare una vetrina e gestire un catalogo utilizzando Adobe Commerce Optimizer. Si presuppone che tu abbia una conoscenza di base di Adobe Commerce Optimizer e delle sue funzionalità.
Tempo stimato per il completamento: 45-60 minuti
Configurazione necessaria
Prima di iniziare questa esercitazione, accertati di disporre dei seguenti prerequisiti:
-
Istanza Adobe Commerce Optimizer
- Accesso a un’istanza di test in Cloud Manager
- Consulta Introduzione per le istruzioni di installazione
-
Autorizzazioni utente
- Accesso amministratore a Adobe Admin Console
- Consulta Gestione utente per la configurazione dell'account
- Se non disponi dell’accesso, contatta il rappresentante del tuo account Adobe.
-
Dati di esempio
- Carvelo Automobile: dati del catalogo caricati nell’istanza
- Segui le istruzioni nell'Archivio per l'acquisizione dei dati del catalogo di esempio
- È possibile eliminare i dati di esempio dopo il completamento utilizzando lo script
reset.js
incluso
-
Ambiente vetrina
- Ambiente di sviluppo locale con Node.js
- Progetto boilerplate storefront clonato e configurato
- Per istruzioni dettagliate, consulta Configurazione vetrina
Iniziamo
In questo caso d’uso, stai lavorando con quanto segue:
-
Interfaccia utente Adobe Commerce Optimizer: configura le visualizzazioni e i criteri del catalogo per gestire la configurazione operativa complessa del catalogo per il caso d'uso Carvelo.
-
Commerce Storefront - Eseguire il rendering della vetrina utilizzando i dati del catalogo di esempio caricati nell'istanza Adobe Commerce Optimizer e nei file di configurazione Commerce Storefront,
fstab.yaml
econfig.json
.
Soluzioni principali
Entro la fine di questo articolo:
- Scopri le nozioni di base di Adobe Commerce Optimizer con il suo modello dati catalogo scalabile ed performante.
- Scopri come il modello dati del catalogo si integra con i componenti della vetrina indipendenti dalla piattaforma e costruiti da Adobe.
- Scopri come utilizzare le viste e i criteri del catalogo di Adobe Commerce Optimizer per creare viste di catalogo personalizzate e filtri di accesso ai dati e inviare i dati a una vetrina Adobe Commerce con tecnologia Edge Delivery.
Scenario di business - Carvelo Automobile
Carvelo Automobile è un conglomerato automobilistico fittizio con una configurazione operativa complessa.
In questo grafico vedete che Carvelo vende prodotti automobilistici di tre marche. Ogni marchio è un’azienda figlia diversa:
- Aurora (veicoli elettrici)
- Bullone (SUV)
- Cruz (ibrido)
Vende questi marchi attraverso tre dealer:
- Arkbridge
- Kingsbluff
- Celport
Questi dealer appartengono a due diverse società madri di dealer:
- West Coast Inc. (Arkbridge)
- East Coast Inc. (Kingsbluff, Celport)
Ogni azienda ha due listini prezzi che vengono utilizzati per vendere prodotti a un prezzo specifico per acquirenti diversi (base, VIP).
west_coast_inc
evip_west_coast_inc
east_coast_inc
evip_east_coast_inc
Come puoi vedere, si tratta di un caso d’uso aziendale molto complesso. Con Adobe Commerce Optimizer, un commerciante può supportare una struttura aziendale complessa utilizzando un singolo catalogo di base per diffondere i dati senza duplicazione del catalogo, scalare i listini prezzi (oltre 30.000 listini prezzi) e consegnare tutti questi dati a una vetrina Edge Delivery Services.
Ora che hai una panoramica del caso d’uso aziendale, ecco il tuo obiettivo mentre lavori attraverso questa esercitazione:
Carvelo vuole vendere parti dei suoi tre marchi (Aurora, Bolt e Cruz) attraverso i diversi concessionari (Arkbridge, Kingsbluff e Celport). Carvelo vuole garantire che i concessionari abbiano accesso solo alle parti e ai prezzi corretti secondo i rispettivi accordi di licenza.
In definitiva, Carvelo ha due obiettivi principali:
- Gestisci un sito web "globale", che ha tutte le SKU per tutti e tre i marchi.
- Offrire ai dealer un percorso per creare i propri punti vendita in base alla visibilità SKU e ai prezzi per ogni SKU. Il tutto utilizzando un singolo catalogo di base, che elimina la duplicazione dei cataloghi.
1. Accedere all'istanza Adobe Commerce Optimizer
Passa all’URL dell’applicazione Commerce Optimizer preconfigurata con i dati di esempio. Puoi trovare l’URL in Commerce Cloud Manager dai dettagli dell’istanza per il progetto Commerce Optimizer o recuperarlo dall’amministratore di sistema. (Vedi Accedere a un'istanza.)
All'avvio di Adobe Commerce Optimizer, vengono visualizzati i seguenti elementi:
Nel menu di navigazione a sinistra, espandi la sezione Store setup e fai clic su Catalog views. Tieni presente che i concessionari Arkbridge e Kingsbluff dispongono già di viste catalogo create:
Fai clic sull’icona info per esaminare i dettagli della vista catalogo.
Arkbridge dispone dei seguenti criteri:
- Marchio
- Modello
- Marchi West Coast Inc
- Categorie di parti di Arkbridge
Kingsbluff dispone dei seguenti criteri:
- Marchio
- Modello
- Marchi East Coast Inc
- Categorie di parti Kingsbluff
Nella sezione successiva verranno create una vista catalogo e le policy per il concessionario Celport.
2. Creare una vista criterio e catalogo
Il responsabile commerciale di Carvelo deve impostare una nuova vetrina per un dealer chiamato Celport che appartiene all'azienda East Coast Inc. Celport venderà freni e sospensioni per i marchi Bolt e Cruz.
Utilizzando Adobe Commerce Optimizer, il responsabile Commerce:
-
Creare un nuovo criterio denominato Categorie di parti Celport per consentire a Celport di vendere solo parti di freni e sospensioni.
-
Crea una nuova vista catalogo per la vetrina Celport.
Questa visualizzazione catalogo utilizza i criteri appena creati Categorie di parti Celport e i Marchi East Coast Inc esistenti per garantire che Celport possa vendere solo i marchi Bolt e Cruz come parte dell'accordo con East Coast Inc. La visualizzazione catalogo Celport utilizza il listino prezzi
east_coast_inc
per supportare i programmi di prezzo dei prodotti in linea con gli accordi di licenza dei marchi. -
Aggiorna la configurazione della vetrina commerce per utilizzare i dati della vista del catalogo Celport creata.
Al termine di questa sezione, Celport sarà pronto a vendere i prodotti Carvelo.
Creare un criterio
Creiamo un nuovo criterio denominato Categorie di parti Celport per filtrare gli SKU venduti dal dealer Celport, che includono parti di freni e sospensioni.
-
Nella barra a sinistra, espandi la sezione Store setup e fai clic su Policies.
-
Fare clic su Create Policy.
Viene visualizzata una nuova pagina per aggiungere i dettagli del criterio.
-
Aggiungi i dettagli richiesti:
Nome = Categorie Di Parti Celport
-
Fare clic su Add Filter.
Viene visualizzata una finestra di dialogo per aggiungere i dettagli del filtro.
-
Aggiungi i dettagli del filtro:
- Attributo = categoria_parte
- Operatore = IN
- Valore Source = STATICO
- Valore = freni
- Valore = sospensione
note important IMPORTANT Ogni valore di attributo deve essere immesso separatamente. Dopo aver immesso un valore, premi Invio per aggiungerlo alla configurazione del filtro. Quindi, immetti il valore successivo. Tutti i valori devono corrispondere esattamente al nome dell’attributo SKU nel catalogo. Per ulteriori informazioni sulla differenza tra un'origine di valore STATIC e TRIGGER, vedere tipi di origine di valore.
-
Nella finestra di dialogo Filter details, fare clic su Save.
-
Per abilitare il filtro appena creato, fare clic sui punti azione (…) e selezionare Abilita.
-
Fare clic su Save.
note note NOTE Se il pulsante Save non è attivo (blu), è possibile che il nome del criterio non sia presente. Fai clic sull'icona a forma di matita accanto a Nuovo criterio per aggiungerlo. -
Torna all’elenco dei criteri facendo clic sulla freccia indietro.
Il nuovo criterio Categorie di parti Celport verrà visualizzato nell'elenco.
Verificare che il passaggio sia stato completato correttamente:
- Il criterio viene visualizzato nell'elenco dei criteri
- Lo stato del criterio è abilitato (indicatore verde)
- I dettagli del filtro mostrano "part_category IN (freni, sospensione)"
- Il nome del criterio è "Celport Part Categories"
Creare una vista catalogo
Crea una nuova visualizzazione catalogo per il dealer Celport e collega i seguenti criteri: Marchi East Coast Inc e Categorie parte Celport.
-
Nella barra a sinistra, espandi la sezione Store setup e fai clic su Catalog views.
Osserva le viste catalogo esistenti: Arkbridge, Kingsbluff e Global.
-
Fare clic su Add catalog view.
-
Inserisci i dettagli della vista catalogo:
- Nome = Celport
- Origini catalogo = en-US
- Criteri (usa elenco a discesa) = Marchi East Coast Inc; Categorie parte Celport; Marchio; Modello
-
Fare clic su Add per creare la visualizzazione del catalogo.
La pagina Visualizzazioni catalogo viene aggiornata per visualizzare la nuova visualizzazione catalogo.
-
Ottieni l’ID della vista catalogo Celport.
Fai clic sull'icona delle informazioni per la visualizzazione del catalogo Celport nella pagina Visualizzazioni catalogo.
Copia e salva l’ID della vista catalogo. Questo ID è necessario quando aggiorni la configurazione della vetrina per inviare i dati al nuovo catalogo Celport.
Verificare che il passaggio sia stato completato correttamente:
- Il nome della vista catalogo è "Celport"
- La vista Catalogo mostra 4 criteri associati
- Viene visualizzato l’ID della vista Catalogo che può essere copiato
- L’origine del catalogo mostra "en-US"
Dopo aver creato la vista Catalogo Celport e i criteri associati, il passaggio successivo consiste nel configurare la vetrina per l'utilizzo del nuovo catalogo Celport.
3. Aggiorna la vetrina
L'ultima parte di questo tutorial prevede l'aggiornamento della vetrina che hai già creato per inviare dati al nuovo catalogo Celport. In questa sezione sostituisci l’ID della vista catalogo nel file di configurazione della vetrina con l’ID della vista catalogo di Celport.
-
Nell’ambiente di sviluppo locale, apri la cartella in cui hai clonato l’archivio GitHub con i file di configurazione boilerplate della vetrina.
-
Nella directory principale della cartella, aprire il file
config.json
.accordion codice config.json 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" } } } }
L’intestazione della vista catalogo include i seguenti valori:
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"
-
Nel valore
commerce-endpoint
, sostituisci l'ID tenant nell'URL con l'URL per l'istanza Adobe Commerce Optimizer.Puoi trovare l’ID tenant nell’URL per l’interfaccia utente di Commerce Optimizer. Ad esempio, nell'URL seguente, l'ID tenant è
XDevkG9W6UbwgQmPn995r3
.code language-text https://experience.adobe.com/#/@commerceprojectbeacon/in:XDevkG9W6UbwgQmPn995r3/commerce-optimizer-studio/catalog
-
Sostituisci il valore
ac-view-id
con l'ID della vista catalogo Celport copiato in precedenza. -
Sostituire il valore
ac-price-book-id
con"east_coast_inc"
.Dopo aver apportato queste modifiche, il file
config.json
dovrebbe essere simile al seguente, con i segnapostoACO-tenant-id
ecelport-catalog-view-id
sostituiti dai valori: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" } } } }
-
Salva il file.
Quando si salvano le modifiche, si aggiorna la configurazione del catalogo in modo da utilizzare la vista del catalogo Carvelo configurata per vendere solo parti del freno e della sospensione.
4. Anteprima della vetrina
Ora che hai aggiornato la configurazione della vetrina per utilizzare la vista Catalogo Celerra, puoi visualizzare in anteprima la vetrina per vedere come riproduce i dati del catalogo.
-
Avvia la vetrina per visualizzare l’esperienza del catalogo specifica per Celport creata dalla configurazione della vetrina.
-
Dalla finestra del terminale nell’IDE, avvia l’anteprima della vetrina locale.
code language-shell npm start
Il browser si apre all'anteprima di sviluppo locale in
http://localhost:3000
.Se il comando non riesce o se il browser non si apre, esaminare le istruzioni per lo sviluppo locale nell'argomento relativo alla configurazione di Storefront.
-
-
Nel browser, cercare
brakes
e premere Invio.La vetrina si aggiorna per visualizzare la pagina dell'elenco dei prodotti con le parti dei freni.
Fare clic sull'immagine di una parte del freno per visualizzare i dettagli del prodotto con le informazioni sul prezzo e annotare le informazioni sul prezzo del prodotto.
-
Cerca
tires
, che è un'altra categoria di parte disponibile nei dati del caso d'uso nell'istanza Adobe Commerce Optimizer.Non viene restituito alcun risultato. Questo perché la vista catalogo Celport è stata configurata per vendere solo parti di freni e sospensioni.
-
Prova ad aggiornare il file di configurazione della vetrina (
config.json
).- Modificare i valori
ac-view-id
eac-price-book
.
Ad esempio, è possibile modificare l'ID della vista catalogo in vista catalogo Kingsbluff e l'ID del listino prezzi in
east_coast_inc
. È possibile visualizzare le categorie di parti disponibili per Kingsbluff consultando il criterio Categorie di parti Kingsbluff.-
Salva il file.
Quando si salva il file, l'anteprima della vetrina locale viene aggiornata automaticamente.
-
Visualizzate l'anteprima delle modifiche nel browser utilizzando la funzione di ricerca per trovare le parti dei pneumatici.
Osservare i diversi tipi di parti disponibili e i prezzi assegnati alla vista del catalogo Kingsbluff.
Questi esperimenti dimostrano la flessibilità di Adobe Commerce Optimizer: puoi passare rapidamente da una visualizzazione di catalogo all’altra e impostare listini prezzi personalizzati per diversi tipi di pubblico senza duplicare i dati del catalogo.
- Modificare i valori
Risoluzione dei problemi
Se riscontri problemi durante questa esercitazione, prova le seguenti soluzioni:
Problemi relativi alla creazione dei criteri
Problema: il pulsante Salva non è attivo
- Soluzione: Verificare che il nome del criterio sia stato immesso e che tutti i campi obbligatori siano stati completati
Problema: il filtro non funziona come previsto
- Soluzione: Verificare che il nome dell'attributo corrisponda esattamente all'attributo SKU nel catalogo
Problemi relativi alla vista catalogo
Problema: la visualizzazione del catalogo non viene visualizzata nell'elenco
- Soluzione: Verificare che tutti i criteri associati siano abilitati e configurati correttamente
Problemi di configurazione della vetrina
Problema: Storefront non caricato
- Soluzione: verifica che l'ID tenant e l'ID della vista catalogo siano immessi correttamente nel file config.json
Problema: nessun prodotto visualizzato
- Soluzione: Verificare che l'ID del listino prezzi dedicato corrisponda a quello disponibile nell'istanza di Adobe Commerce Optimizer
Problema: La ricerca non restituisce alcun risultato
- Soluzione: Verificare che i criteri di visualizzazione del catalogo consentano la categoria di prodotti cercata
Per ulteriori informazioni, consulta la documentazione di Adobe Commerce Optimizer o contatta il supporto Adobe.
Riepilogo
In questa esercitazione, esegui correttamente le seguenti operazioni:
- Creato un nuovo criterio per filtrare le categorie di prodotti per il dealer Celport
- Impostare una vista catalogo con più criteri per controllare la visibilità dei prodotti
- Configurazione di una vetrina per l'utilizzo della nuova vista catalogo
- Verifica della configurazione tramite test della visibilità e del prezzo del prodotto
Passaggi successivi
Per continuare a conoscere Adobe Commerce Optimizer:
- Esplora le funzionalità di merchandising per personalizzare l'esperienza di acquisto
- Scopri le configurazioni avanzate dei criteri
- Configura altre visualizzazioni catalogo per altri dealer
- Consulta la documentazione API per la gestione programmatica del catalogo
- Scopri come configurare i componenti di rilascio per la vetrina Edge Delivery Services per creare esperienze vetrina personalizzate per l’individuazione dei prodotti, raccomandazioni e altre funzionalità. Consulta la documentazione di Storefront