[Solo SaaS]{class="badge positive" title="Applicabile solo ai progetti Adobe Commerce as a Cloud Service e Adobe Commerce Optimizer (infrastruttura SaaS gestita da Adobe)."}

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

  • 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:

  1. 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.

  2. 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 e config.json.

NOTE
Scopri di più sui file di configurazione della vetrina consultando l'argomento Esplora la versione standard nella documentazione di Adobe Commerce Storefront.

‌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.

Automobile Carvelo

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 e vip_west_coast_inc
  • east_coast_inc e vip_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:

recommendation-more-help

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:

  1. Gestisci un sito web "globale", che ha tutte le SKU per tutti e tre i marchi.
  2. 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:

Adobe Commerce Optimizer UI

NOTE
Consulta l'articolo overview per informazioni sui componenti chiave dell'interfaccia utente di Adobe Commerce Optimizer.

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:

Visualizzazioni catalogo esistenti configurate per i dati di esempio

NOTE
Per il momento puoi ignorare la visualizzazione del catalogo Global.

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.

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.

Rivenditore Celport

Utilizzando Adobe Commerce Optimizer, il responsabile Commerce:

  1. Creare un nuovo criterio denominato Categorie di parti Celport per consentire a Celport di vendere solo parti di freni e sospensioni.

  2. 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.

  3. 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.

  1. Nella barra a sinistra, espandi la sezione Store setup e fai clic su Policies.

  2. Fare clic su Create Policy.

    Viene visualizzata una nuova pagina per aggiungere i dettagli del criterio.

  3. Aggiungi i dettagli richiesti:

    Nome = Categorie Di Parti Celport

  4. Fare clic su Add Filter.

    Viene visualizzata una finestra di dialogo per aggiungere i dettagli del filtro.

  5. 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.

  6. Nella finestra di dialogo Filter details, fare clic su Save.

  7. Per abilitare il filtro appena creato, fare clic sui punti azione (…) e selezionare Abilita.

  8. 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.
  9. 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"

Crea una nuova visualizzazione catalogo per il dealer Celport e collega i seguenti criteri: Marchi East Coast Inc e Categorie parte Celport.

  1. Nella barra a sinistra, espandi la sezione Store setup e fai clic su Catalog views.

    Osserva le viste catalogo esistenti: Arkbridge, Kingsbluff e Global.

    Pagina visualizzazioni catalogo esistente

  2. Fare clic su Add catalog view.

  3. 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
  4. Fare clic su Add per creare la visualizzazione del catalogo.

    La pagina Visualizzazioni catalogo viene aggiornata per visualizzare la nuova visualizzazione catalogo.

    Elenco visualizzazioni catalogo aggiornato

  5. Ottieni l’ID della vista catalogo Celport.

    Fai clic sull'icona delle informazioni per la visualizzazione del catalogo Celport nella pagina Visualizzazioni catalogo.

    Celport ID visualizzazione 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.

  1. Nell’ambiente di sviluppo locale, apri la cartella in cui hai clonato l’archivio GitHub con i file di configurazione boilerplate della vetrina.

  2. 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"
  3. 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
    
  4. Sostituisci il valore ac-view-id con l'ID della vista catalogo Celport copiato in precedenza.

  5. 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 segnaposto ACO-tenant-id e celport-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"
              }
          }
      }
    }
    
  6. 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.

  1. Avvia la vetrina per visualizzare l’esperienza del catalogo specifica per Celport creata dalla configurazione della vetrina.

    1. 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.

  2. Nel browser, cercare brakes e premere Invio.

    La vetrina si aggiorna per visualizzare la pagina dell'elenco dei prodotti con le parti dei freni.

    Pagina elenco prodotti per 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.

  3. Cerca tires, che è un'altra categoria di parte disponibile nei dati del caso d'uso nell'istanza Adobe Commerce Optimizer.

    Configurazione vetrina con intestazioni non corrette

    Non viene restituito alcun risultato. Questo perché la vista catalogo Celport è stata configurata per vendere solo parti di freni e sospensioni.

  4. Prova ad aggiornare il file di configurazione della vetrina (config.json).

    1. Modificare i valori ac-view-id e ac-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.

    1. Salva il file.

      Quando si salva il file, l'anteprima della vetrina locale viene aggiornata automaticamente.

    2. 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.

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

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.

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:

781d83dd-7e7a-4d27-809a-ebf216b88dc1