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 availableservices

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:

Architettura di Commerce Services Connector

Le sezioni seguenti descrivono ciascuno di questi elementi in modo più dettagliato.

Credenziali apikey

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.

NOTE
Gli identificatori chiave Produzione e Sandbox non fanno riferimento al tuo ambiente. Utilizza lo stesso set di chiavi API per ogni ambiente, ad esempio locale, di sviluppo, di staging o di produzione.
Il proprietario della licenza è in genere il contatto principale sull’account Adobe Commerce e non è sempre lo stesso del proprietario del progetto di infrastruttura cloud Adobe Commerce on.

Generare le chiavi API di produzione e sandbox genapikey

  1. Accedi al tuo account Commerce all'indirizzo https://account.magento.com.

  2. Nella scheda Magento, seleziona Portale API nella barra laterale.

  3. Dal menu Ambiente, seleziona Produzione o Sandbox.

  4. Immetti un nome nella sezione Chiavi API e fai clic su Aggiungi nuovo per aprire la finestra di dialogo e scaricare la nuova chiave.

    Scarica chiave privata

    note warning
    WARNING
    Questa finestra di dialogo offre l’unica opportunità di copiare o scaricare le chiavi.
  5. Fai clic su Scarica, quindi su Annulla.

  6. 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/installazioni associati alla licenza.

Configurazione SaaS saasenv

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.

WARNING
Utilizza lo spazio dati SaaS di produzione solo nell'installazione di Commerce di produzione per evitare conflitti di dati. In caso contrario, si rischia di inquinare i dati del sito di produzione con i dati di test, causando ritardi nell’implementazione. Ad esempio, i dati del prodotto di produzione potrebbero essere erroneamente sovrascritti dai dati di staging, come gli URL di staging.
In 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 gestione temporanea, è possibile richiedere spazi dati di test aggiuntivi per ogni ambiente di gestione temporanea 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. Ciò comporta un costo aggiuntivo.
  • Inviare una richiesta di supporto per un ulteriore spazio dati di test e indicare la giustificazione aziendale per lo spazio dati aggiuntivo. Questa richiesta è soggetta ad approvazione.

Selezionare o creare un progetto SaaS createsaasenv

Per selezionare o creare un progetto SaaS, richiedere la chiave API Commerce al proprietario della licenza Commerce per l'archivio:

NOTE
Se la sezione Commerce Services Connector non è visualizzata nella configurazione di Commerce, è necessario installare i moduli Commerce per il Commerce servizio desiderato.
  1. 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-id sia installato.

  2. 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.
    note warning
    WARNING
    Se 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.
  3. Fai clic su Salva.

Tutti i progetti SaaS associati alle chiavi vengono visualizzati nel campo Progetto della sezione Identificatore SaaS.

  1. Se non esistono progetti SaaS, fare clic su Crea progetto. Quindi nel campo Progetto, inserisci un nome per il progetto SaaS.

  2. Seleziona lo Spazio dati da utilizzare per la configurazione corrente dell'archivio Commerce.

NOTE
Se si dispone di istanze separate da integrare con Commerce Services, inviare un ticket di supporto per richiedere un nuovo progetto SaaS per ogni istanza aggiuntiva. Dopo aver creato il progetto SaaS, configura l’integrazione dei servizi Commerce per l’istanza utilizzando la stessa chiave API e selezionando il nuovo progetto SaaS per lo spazio dati.
WARNING
Se generi nuove chiavi nella sezione Portale API di Il mio account, aggiorna immediatamente le chiavi API nella configurazione Amministratore. Se generi nuove chiavi e non le aggiorni nell’amministratore, le estensioni SaaS non funzioneranno più e perderai dati preziosi.

Per 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) organizationid

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.

recommendation-more-help
3d5a1200-3287-4b90-a075-6c594f65d80e