Catalog Service per Adobe Commerce

Catalog Service per l'estensione Adobe Commerce migliora i tempi di caricamento della vetrina fornendo dati di catalogo ottimizzati e di sola lettura tramite un'API GraphQL dedicata. Questo servizio è progettato specificamente per migliorare le esperienze di pagina relative al prodotto, velocizzando il caricamento delle pagine e migliorando i tassi di conversione.

I dati rich view-model forniti da Catalog Service includono dettagli di prodotto, attributi, inventario e prezzi, consentendo il rendering rapido delle esperienze di vetrina relative al prodotto, ad esempio:

Vantaggi e caratteristiche principali

Panoramica dell’architettura

Catalog Service utilizza GraphQL per richiedere e ricevere i dati del catalogo, inclusi prodotti, attributi di prodotto, inventario e prezzi. GraphQL è un linguaggio di query che un client front-end utilizza per comunicare con l’API (Application Programming Interface) definita su un back-end come Adobe Commerce. GraphQL è un metodo di comunicazione diffuso perché è leggero e consente a un integratore di sistemi di specificare il contenuto e l’ordine di ciascuna risposta.

Adobe Commerce fornisce due sistemi GraphQL con scopi diversi:

Sistema core GraphQL

Sistema GraphQL di Catalog Service

I dati disponibili per Catalog Service vengono forniti dall’estensione SaaS Data Export. Questa estensione sincronizza i dati tra l’applicazione Commerce e i servizi Commerce connessi per garantire che le query sugli endpoint API di GraphQL Services restituiscano i dati del catalogo più recenti. Per informazioni sulla gestione e la risoluzione dei problemi relativi alle operazioni di esportazione dei dati SaaS, vedere la Guida all'esportazione dei dati SaaS.

I clienti Catalog Service possono utilizzare l'Indicizzatore prezzi SaaS, che fornisce aggiornamenti dei prezzi e tempi di sincronizzazione più rapidi.

Dettagli dell’architettura

Il diagramma seguente illustra le differenze a livello di architettura tra il sistema GraphQL di base e il sistema GraphQL di Catalog Service, illustrando come questi sistemi collaborino per ottimizzare le prestazioni della vetrina:

Funzionamento dei sistemi

Sistema GraphQL di base (approccio tradizionale):
L’app web progressiva (PWA) invia le richieste direttamente all’applicazione Commerce, che elabora ogni richiesta tramite più sottosistemi prima di restituire una risposta. Questo percorso di andata e ritorno in più passaggi può causare tempi di caricamento delle pagine lenti, che potrebbero comportare tassi di conversione più bassi.

Servizio catalogo (approccio ottimizzato):
Catalog Service funge da gateway dei servizi di Storefront che accede a un database dedicato e ottimizzato contenente dettagli dei prodotti, attributi, varianti, prezzi e categorie. Il servizio mantiene la sincronizzazione con Adobe Commerce tramite l’indicizzazione automatizzata, aggirando il tradizionale ciclo di richiesta-risposta per ridurre notevolmente la latenza.

I sistemi GraphQL di base e di servizio non comunicano direttamente tra loro. Puoi accedere a ogni sistema da un URL diverso e le chiamate richiedono informazioni di intestazione diverse. I due sistemi GraphQL sono progettati per essere utilizzati insieme. Il sistema GraphQL Catalog Service potenzia il sistema di base per rendere più veloci le esperienze di presentazione dei prodotti.

Facoltativamente, puoi implementare Mesh API per Adobe Developer App Builder per integrare i due sistemi Adobe Commerce GraphQL con API private e di terze parti e altre interfacce software tramite Adobe Developer. La mesh può essere configurata in modo da garantire che le chiamate instradate a ciascun endpoint contengano le informazioni di autorizzazione corrette nelle intestazioni.

Dettagli architetturali

Le sezioni seguenti descrivono alcune delle differenze tra i due sistemi GraphQL.

Gestione schema

Poiché Catalog Service funziona come un servizio, gli integratori non devono preoccuparsi della versione sottostante di Commerce. La sintassi delle query è la stessa per tutte le versioni. Inoltre, lo schema è coerente per tutti i commercianti. Questa coerenza semplifica la definizione delle best practice e aumenta in modo significativo il riutilizzo dei widget della vetrina.

Semplificazione dei tipi di prodotto

Lo schema riduce la diversità dei tipi di prodotto a due casi d’uso:

Attributi di visualizzazione del prodotto

Sia i prodotti semplici che quelli complessi dispongono di attributi definiti dal cliente che possono essere visualizzati nella vetrina. Questi attributi vengono restituiti come ProductViewAttributes. In Adobe Commerce, gli attributi disponibili vengono definiti al momento della creazione del prodotto. Puoi aggiungere attributi aggiuntivi dal backend di Adobe Commerce o a livello di programmazione. Vedi Estendere e personalizzare i dati del feed di esportazione dei dati SaaS.

Prezzi

I prodotti semplici rappresentano l'unità di vendita di base che ha un prezzo. Catalog Service calcola il prezzo regolare prima degli sconti e il prezzo finale dopo gli sconti. I calcoli dei prezzi possono includere imposte sui prodotti fisse. Escludono le promozioni personalizzate.

Un prodotto complesso non ha un prezzo stabilito. Catalog Service restituisce invece i prezzi dei semplici collegati. Ad esempio, un esercente può inizialmente assegnare gli stessi prezzi a tutte le varianti di un prodotto configurabile. Se determinate dimensioni o colori sono impopolari, il commerciante può ridurre i prezzi di tali varianti. Pertanto, il prezzo del prodotto complesso (configurabile) presenta inizialmente una fascia di prezzo, che riflette il prezzo sia delle varianti standard che di quelle impopolari. Dopo che l'acquirente ha selezionato un valore per tutte le opzioni disponibili, la vetrina visualizza un solo prezzo.

Catalog Service assicura aggiornamenti e calcoli accurati dei prezzi grazie al supporto di prezzi con valori elevati (fino a 16 cifre) e alta precisione decimale (fino a 4 cifre decimali).

Implementazione

Il processo di attuazione prevede: