Abilitare e configurare eventi catalogo con Adobe I/O
Gli eventi del catalogo sono notifiche generate automaticamente che descrivono le modifiche del catalogo supportate rese disponibili tramite Catalog Service. Consentono flussi di lavoro basati su eventi quali:
- Mantenimento della sincronizzazione tra cache o servizi esterni e aggiornamenti del catalogo.
- Attivazione di processi a valle quando cambiano prodotti, varianti, prezzi o categorie.
- Attivazione dei casi d’uso di Experience Edge e Edge Delivery Services che richiedono aggiornamenti quasi in tempo reale del catalogo.
Per il percorso end-to-end da Adobe Commerce ai consumatori dell’evento, vedi Consegna degli eventi tramite Adobe I/O Events.
Tipi di evento supportati supported-event-types
Gli eventi del catalogo si concentrano sulle modifiche rilevanti per la vetrina esposte tramite Adobe Developer Console. Le seguenti sottoscrizioni sono attualmente supportate.
Ogni evento include:
- Identificatore di evento che descrive il tipo di modifica.
- Contesto di entità e ambiente, ad esempio ID istanza e SKU.
- Un payload che descrive l’entità modificata e le informazioni rilevanti sull’ambito.
Esempio di payload di eventi
Evento ProductUpdated
{
"imsOrgId": "aaa-0",
"instanceId": "instance-9",
"eventCode": "productUpdated",
"sku": "1234",
"links": [
{"type": "variantOf", "sku": "5678"}
],
"scope": [
{ "storeViewCode": "US-us" },
{ "storeViewCode": "FR-fr" },
{ "storeViewCode": "DE-de" }
]
}
Evento PriceUpdated
{
"imsOrgId": "aaa-0",
"instanceId": "instance-9",
"eventCode": "priceUpdated",
"sku": "1234",
"scope": [
{
"websiteCode": "website1",
"customerGroupCode": "customer-group-code1"
},
{
"websiteCode": "website2",
"customerGroupCode": "customer-group-code2"
}
]
}
Consegna degli eventi tramite Adobe I/O Events event-delivery-through-adobe-io-events
Adobe I/O Events distribuisce gli eventi del catalogo alle integrazioni. Il diagramma seguente mostra il flusso di alto livello delle modifiche del catalogo da Adobe Commerce a Catalog Service e Adobe I/O Events ai consumatori abbonati:
I passaggi seguenti spiegano più dettagliatamente ogni handoff:
- Adobe Commerce → Catalog Service
Adobe Commerce esporta i dati del catalogo in Catalog Service utilizzando le estensioni SaaS Data Export supportate.
-
Elaborazione servizio catalogo
- Catalog Service elabora le modifiche al catalogo supportate e le prepara per la consegna dell’evento.
-
Servizio catalogo → Adobe I/O Events
- Gli eventi catalogo sono pubblicati in Adobe I/O Events.
- Gli utenti possono effettuare l’abbonamento utilizzando il journal, i webhook, Adobe I/O Runtime, Amazon EventBridge o altri meccanismi di consegna supportati.
Adobe I/O Events fornisce:
- Consegna almeno una volta per sottoscrittore (sono possibili eventi duplicati).
- Nessuna garanzia di ordini per le consegne.
I consumatori devono gestire gli eventi duplicati e la consegna fuori servizio. Per informazioni sull’implementazione, vedere Idempotenza.
Casi d’uso use-cases
Puoi utilizzare gli eventi Catalogo in più scenari.
Consegna statica di siti e edge
- Rigenera o invalida le pagine di catalogo e i frammenti di vetrina quando i dati del catalogo cambiano.
- Evitare il polling frequente di Catalog Service API.
Ricerca indicizzazione e caching
- Attiva aggiornamenti incrementali negli indici di ricerca a valle.
- Aggiorna i livelli della cache o le viste esterne del catalogo quando i dati di prodotto o categoria cambiano.
Integrazione con sistemi esterni
- Inoltra le modifiche al catalogo a sistemi esterni come PIM, motori di determinazione prezzi o altri sistemi line-of-business.
- Mantieni sincronizzate le applicazioni downstream senza accesso diretto al database.
Monitoraggio e osservabilità
Combina gli eventi del catalogo con il monitoraggio esistente (ad esempio, Grafana e Prometheus) in:
- Monitorare la velocità effettiva degli eventi.
- Rileva anomalie nel volume di aggiornamento del catalogo.
Abilita eventi catalogo enable-catalog-events
Per abilitare gli eventi del catalogo end-to-end, segui la procedura riportata di seguito.
- Ambiente Adobe Commerce supportato con Catalog Service abilitato.
- La connessione Adobe I/O è configurata per Adobe Commerce.
- Accesso a Adobe Developer Console nella stessa organizzazione IMS in cui è stato eseguito il provisioning dell’ambiente Commerce.
- Per verificare la sincronizzazione con i servizi SaaS di Commerce, utilizzare Data Management Dashboard in Admin.
- Per la verifica del dashboard sono necessari i consigli di prodotto v6.0, Live Search v4.1.0+ o Catalog Service v1.17+. Adobe consiglia di aggiornare il progetto Commerce alle versioni più recenti supportate di questi servizi. Per le versioni precedenti del servizio, utilizzare Sincronizzazione catalogo per verificare la sincronizzazione.
Verifica dati catalogo verify-catalog-data
Verificare che Catalog Service disponga dei dati del catalogo correnti dell’istanza di Commerce prima di eseguire la configurazione. Gli eventi catalogo dipendono dal completamento di SaaS Data Export in due fasi. Confermare entrambi:
-
Conferma l’esportazione di feed da Commerce.
Dall’amministratore Adobe Commerce, aprire la pagina Stato sincronizzazione feed dati (System > Data Transfer > Data Feed Sync Status) e confermare che l’ultimo stato di esportazione è stato completato correttamente per ogni feed Catalog Service.
-
Conferma sincronizzazione riuscita con i servizi Commerce connessi dall’amministratore Adobe Commerce.
Dall’amministratore Adobe Commerce, apri Data Management Dashboard (System > Data Transfer > Data Management Dashboard) e verifica che i dati dei prodotti sincronizzati includano i prodotti previsti.
Registrati e abbonati a Adobe I/O Events register-events
Definisci gli eventi Commerce a cui abbonarti, quindi registrali nel progetto.
Se l’istanza non è inclusa nell’elenco di selezione, non è connessa a Adobe I/O. Per istruzioni su come risolvere il problema, consulta Configurare la Adobe I/O connessione nella documentazione di Adobe Commerce Developer.
-
Da Adobe Developer Console, accedi alla stessa organizzazione IMS utilizzata per il progetto Commerce.
-
Crea un progetto per Commerce Catalog Events o aggiungi l’API degli eventi a un progetto esistente.
-
Seleziona APIs and services nella navigazione superiore.
-
Nella pagina Browse APIs and services, selezionare la scheda Events.
-
Trova rapidamente le API degli eventi del catalogo Commerce. Digitare Catalogo nella casella di ricerca oppure filtrare in base al prodotto Commerce.
-
Sulla scheda Commerce Catalog Events, seleziona Project.
-
-
Configurare la registrazione degli eventi.
Seleziona l’istanza Commerce da cui ricevere le notifiche degli eventi. Quindi, selezionare Next.
-
Scegli gli eventi a cui abbonarti.
Selezionare le sottoscrizioni di eventi supportate che si desidera ricevere, ad esempio Product Update o Price Update. Quindi, selezionare Next.
-
Aggiungi credenziali server-to-server OAuth.
Immetti Credential name. Quindi, selezionare Next.
-
Immettere Event registration name e Event registration description. Quindi, selezionare Next.
-
Nella schermata di registrazione finale, accetta il consumer predefinito, l’API di inserimento nel journal.
Il consumatore API di inserimento nel journal predefinito consente di verificare la registrazione degli eventi e confermare che gli eventi vengono consegnati. Se hai già configurato un consumer di azioni webhook o Adobe I/O Runtime, selezionalo qui. In caso contrario, modifica la registrazione dell’evento in un secondo momento, quando il consumatore sarà pronto.
-
Selezionare Complete registration.
Configurare il consumer di eventi configure-consumer
-
Configurare un consumatore, ad esempio:
- Endpoint di webhook
- Azione Adobe I/O Runtime
- Un’altra destinazione supportata
-
Se non hai selezionato un consumatore durante la registrazione, modifica la registrazione dell’evento per aggiungere i dettagli del consumatore.
-
Da Adobe Developer Console, modifica il progetto. Quindi, seleziona la registrazione dell’evento creata.
-
Nella pagina dei dettagli di registrazione dell’evento, selezionare Edit Events Registration.
-
Selezionare Next fino a quando non si raggiunge la schermata di selezione del consumatore. Quindi, seleziona il consumatore configurato.
-
Aggiorna il consumatore alla destinazione configurata. Quindi, selezionare Save configured events.
-
Convalidare il flusso di eventi validate-event-flow
Gli eventi catalogo sono abilitati per il tuo ambiente. Quando i dati del catalogo cambiano in Commerce, gli aggiornamenti passano attraverso Catalog Service a Adobe I/O Events e il consumatore che ha effettuato l’abbonamento riceve l’evento di catalogo corrispondente. Rivedi Limiti e best practice prima di creare integrazioni di produzione.
-
Apportare una semplice modifica al catalogo supportata, ad esempio aggiornare il nome di un prodotto o modificare un prezzo.
-
Conferma i seguenti risultati:
- La modifica è visibile tramite Catalog Service API.
- Il consumatore Adobe I/O Events riceve il prodotto o l’evento di prezzo corrispondente.
Limiti e best practice limits-and-best-practices
Per creare eventi di catalogo, segui queste best practice.
Idempotenza idempotency
Adobe I/O Events può inviare lo stesso evento catalogo più di una volta e gli eventi per un singolo prodotto possono arrivare fuori servizio. Progettare i consumatori in modo che siano idempotenti:
- Utilizzo di ID entità con un campo versione o timestamp.
- Ignorare in modo sicuro le notifiche duplicate per la stessa modifica.
Throughput e contropressione
I cataloghi di grandi dimensioni con tassi di aggiornamento elevati possono generare un volume di eventi significativo. Assicurati che:
- I consumatori possono elaborare gli eventi al picco di velocità effettiva.
- Se necessario, puoi utilizzare il buffering, la gestione in batch o le code.
Sicurezza e isolamento
- Adobe I/O Events applica isolamento tenant.
- L’organizzazione riceve gli eventi solo per i propri ambienti e adesioni.
Evoluzione dello schema
I payload degli eventi del catalogo seguono lo stesso modello concettuale delle API Catalog Service. Per mantenere la compatibilità con la modalità di inoltro:
- Se possibile, evita un’applicazione rigorosa dello schema.
- Ignora i campi sconosciuti invece di generare un errore.
Risolvere i problemi relativi agli eventi catalogo troubleshoot-catalog-events
Se gli eventi del catalogo sono mancanti o in ritardo, segui questi passaggi.
-
Verifica dati Catalog Service
Utilizza l’API Catalog Service API per verificare che la modifica al catalogo sia stata archiviata correttamente.
-
VerificaSaaS Data Export
Gli eventi catalogo richiedono dati correnti in Catalog Service. Confermare entrambe le fasi del percorso di esportazione:
-
Esportazione feed da Commerce. Nella pagina Stato sincronizzazione feed dati o in
var/log/saas-export.log, confermare che Catalog Service feed sono stati esportati correttamente da Commerce. -
Sincronizza con i servizi SaaS di Commerce connessi. Nel Dashboard di gestione dati, Sincronizzazione catalogo o nei registri di esportazione, verificare che i dati siano stati sincronizzati correttamente in Catalog Service.
Per la risoluzione dei problemi relativi ai processi di esportazione e sincronizzazione, vedere Sincronizzare i dati con l’esportazione dei dati SaaS e Registrazione e risoluzione dei problemi.
-
-
Convalida Adobe I/O Events configurazione
Conferma che:
- Sei connesso all’organizzazione IMS corretta in Adobe Developer Console.
- Il provider Commerce Catalog Events è abilitato.
- Il provider Commerce Catalog Events e l’ambiente previsti sono visibili.
- La sottoscrizione è attiva.
- Il consumer di endpoint, azione o diario può ricevere ed elaborare eventi di test.
-
Contatta il supporto Adobe
All’apertura di un ticket di supporto, selezionare il motivo del problema corrispondente all’applicazione Adobe Commerce e includere le informazioni seguenti:
- Dettagli di Catalog Service (ambiente, area geografica).
- Dettagli sottoscrizione Adobe I/O Events.
- Tempo approssimativo e descrizione degli eventi mancanti.
Per ulteriori informazioni, consulta Ticket di supporto.