Commerce Services Connector
Alcune funzionalità di Adobe Commerce e Magento Open Source sono basate su Commerce Services e distribuite come SaaS (software as a service). Per utilizzare questi servizi, è necessario connettere l'istanza Commerce utilizzando le chiavi API di produzione e sandbox e specificare lo spazio dati nella configurazione. È sufficiente configurare la connessione una sola volta per ogni istanza.
Servizi disponibili
Di seguito sono elencate le funzionalità di Commerce a cui è possibile accedere tramite Commerce Services Connector:
| Servizio | Disponibilità |
|---|---|
| Product Recommendations con tecnologia Adobe Sensei | Adobe Commerce |
| Live Search con tecnologia Adobe Sensei | Adobe Commerce |
| Payment Services | ADOBE COMMERCE e MAGENTO OPEN SOURCE |
| Site-Wide Analysis Tool | Adobe Commerce |
| Catalog Service | Adobe Commerce |
| Data Connection | Adobe Commerce |
Architettura
A un livello avanzato, Commerce Services Connector è costituito dai seguenti elementi principali:
Le sezioni seguenti descrivono ciascuno di questi elementi in modo più dettagliato.
Credenziali
Le chiavi API di produzione e sandbox sono generate dall'account Commerce del proprietario licenza. L'account Commerce è identificato da un ID Commerce univoco (MageID). Il proprietario della licenza per l’organizzazione del commerciante può generare chiavi API per servizi come Product Recommendations o Live Search, purché l’account sia in buono stato.
Le chiavi possono essere condivise in base alla necessità di sapere con l'integratore di sistemi o il team di sviluppo che gestisce progetti e ambienti per conto del titolare della licenza. Gli sviluppatori a cui il proprietario della licenza ha concesso Shared Access non possono generare le chiavi per loro conto anche se l'organizzazione del commerciante è presente nel menu a discesa Switch Accounts sul loro account.
Inoltre, gli integratori di soluzioni sono anche autorizzati a utilizzare Commerce Services. Se sei un integratore di soluzioni, il firmatario del contratto partner Commerce deve generare le chiavi API.
NOTEGenerare le chiavi API di produzione e sandbox
-
Accedi al tuo account Commerce all'indirizzo https://account.magento.com.
-
Nella scheda Magento, seleziona API Portal nella barra laterale.
-
Dal menu Ambiente, seleziona Produzione o Sandbox.
NOTEProduzione e Sandbox fanno riferimento agli ambienti di spazio dati in cui i dati vengono memorizzati nei sistemi back-end SaaS di Adobe. Non fa riferimento agli ambienti commerce in cui utilizzerai le chiavi. -
Immetti un nome nella sezione Chiavi API e fai clic su Aggiungi nuovo per aprire la finestra di dialogo e scaricare la nuova chiave.
WARNINGQuesta finestra di dialogo offre l’unica opportunità di copiare o scaricare le chiavi. -
Fai clic su Scarica, quindi su Annulla.
-
Ripeti i passaggi precedenti per ogni ambiente (produzione e sandbox).
Nella sezione Chiavi API sono ora visualizzate le chiavi API (pubbliche). Sono necessarie tutte e quattro le chiavi (sia quelle di produzione che quelle di sandbox, Public+Private) quando si seleziona o si crea un progetto SaaS in uno qualsiasi degli ambienti o delle installazioni associati alla licenza.
Configurazione SaaS
Commerce istanze devono essere configurate con un progetto SaaS e uno spazio dati SaaS in modo che Commerce Services possa inviare dati alla posizione giusta. Un progetto SaaS raggruppa tutti gli spazi di dati SaaS. Gli spazi di dati SaaS vengono utilizzati per raccogliere e archiviare dati che consentono il funzionamento di Commerce Services. Alcuni di questi dati possono essere esportati dall'istanza Commerce e altri possono essere raccolti dal comportamento dell'acquirente nella vetrina. Tali dati vengono quindi salvati in modo permanente nell’archiviazione cloud protetta.
Per Product Recommendations, lo spazio dati SaaS contiene dati di catalogo e comportamentali. È possibile indirizzare un'istanza Commerce a uno spazio dati SaaS selezionandola nella configurazione Commerce.
WARNINGIn questo caso, invia una richiesta di supporto per richiedere la pulizia dei dati.
Provisioning dello spazio dati SaaS
Tutti i commercianti di Adobe Commerce possono accedere a uno spazio di dati di produzione e due spazi di dati di test per ciascun progetto SaaS.
È possibile utilizzare gli spazi di dati di test in qualsiasi ambiente non di produzione, purché non si utilizzi lo stesso spazio di dati in più ambienti contemporaneamente. Per utilizzare lo spazio dati di test in un ambiente diverso, eseguire una pulizia dei dati prima di selezionare e configurare lo spazio dati in tale ambiente.
Per i progetti Adobe Commerce Cloud Pro con più ambienti di staging, puoi richiedere spazi di dati di test aggiuntivi per ogni ambiente di staging inviando una richiesta di supporto. Tuttavia, se disponi di un solo ambiente di staging e richiedi spazi di dati di test aggiuntivi, disponi delle seguenti opzioni:
- Contatta il team Customer Success o il Customer Success Manager designato per richiedere un ulteriore ambiente di staging.
- Inviare una richiesta di supporto per richiedere spazio dati di test aggiuntivo e indicare la giustificazione aziendale per lo spazio dati aggiuntivo. Questa richiesta è soggetta ad approvazione.
I clienti Magento Open Source che utilizzano Adobe Payment Services possono richiedere anche uno spazio di dati aggiuntivo. Contatta il team dei pagamenti per ottenere l'approvazione preventiva degli spazi di dati aggiuntivi prima di inviare una richiesta di supporto per richiedere lo spazio di dati di prova.
I clienti che possiedono più progetti Cloud o installazioni on-premise (live/production) possono anche richiedere spazi di dati aggiuntivi per la produzione e il test per ciascun progetto o istanza inviando una richiesta di supporto.
Selezionare o creare un progetto SaaS
Per selezionare o creare un progetto SaaS, richiedere la chiave API Commerce al proprietario della licenza Commerce per l'archivio:
NOTE-
Nella barra laterale Admin, vai a Sistema > Servizi > Connettore servizi Commerce.
Se non vedi la sezione Commerce Services Connector nella configurazione Commerce, installa i moduli Commerce per il Commerce servizio desiderato. Verificare inoltre che il pacchetto
magento/module-services-idsia installato. -
Nelle sezioni Sandbox API Keys e_Production API Keys_, incolla i valori chiave.
- Le chiavi private devono includere
----BEGIN PRIVATE KEY---all'inizio della chiave e----END PRIVATE KEY----alla fine. - Se non disponi di una copia delle chiavi effettive, chiedi al proprietario dell’account di inserirle, quindi collega i valori nella configurazione.
WARNINGSe si aggiungono valori chiave eseguendo una query su un backup o uno snapshot del database e si incollano i valori nella configurazione, viene applicato un ulteriore livello di crittografia e le chiavi non funzioneranno. - Le chiavi private devono includere
-
Fai clic su Salva.
Tutti i progetti SaaS associati alle chiavi vengono visualizzati nel campo Progetto della sezione Identificatore SaaS.
- Se non esistono progetti SaaS, fare clic su Crea progetto. Quindi nel campo Progetto, inserisci un nome per il progetto SaaS.
NOTE- Seleziona lo Spazio dati da utilizzare per la configurazione corrente dell'archivio Commerce.
NOTEWARNINGPer modificare i nomi del progetto SaaS o dello spazio dati, fare clic su Rinomina accanto a uno dei due. La modifica del nome non influisce sul servizio, in quanto il nome è solo un’etichetta per identificare e distinguere tra progetti e spazi di dati.
Organizzazione IMS (opzionale)
Per collegare la tua istanza di Adobe Commerce a Adobe Experience Platform, accedi al tuo account di Adobe utilizzando il tuo Adobe ID. Dopo l’accesso, l’organizzazione IMS associata al tuo account Adobe viene visualizzata in questa sezione.
Esportazione dati SaaS
Quando l'istanza Commerce si connette a Commerce Services, il processo di esportazione dei dati SaaS esporta i dati Commerce dal server Commerce in Commerce SaaS Services in modo che possano essere sincronizzati con i servizi Commerce connessi. In Admin, puoi controllare lo stato di sincronizzazione utilizzando Data Management dashboard. Per informazioni dettagliate, vedere la Guida all'esportazione dei dati SaaS.
