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. È necessario configurarlo una sola volta.

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
Channel Manager
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 identificato da un ID Commerce univoco (MageID). Per superare la convalida dei diritti per servizi come Product Recommendations o Live Search, il proprietario della licenza per l'organizzazione del commerciante può generare il set di chiavi API, 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
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{:target="_blank"}.

  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.

    Viene visualizzata una finestra di dialogo per il download della nuova chiave.

    Scarica chiave privata

    note warning
    WARNING
    Questa è 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). Quando si seleziona o si crea un progetto SaaS, sono necessarie sia le chiavi di produzione che quelle di sandbox (pubblico+privato).

Configurazione SaaS saasenv

Le istanze di Commerce devono essere configurate con un progetto SaaS e uno spazio dati SaaS in modo che Commerce Services possa inviare i dati alla posizione giusta. Un progetto SaaS raggruppa tutti gli spazi di dati SaaS. Gli spazi 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
Utilizzare 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.

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 Chiavi API sandbox e Chiavi API di produzione, incolla i valori chiave.

    Le chiavi private devono includere ----BEGIN PRIVATE KEY--- all'inizio della chiave e ----END PRIVATE KEY---- alla fine della chiave privata.

  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.

    Quando si crea un progetto SaaS, Commerce genera uno o più spazi di dati SaaS a seconda della licenza di Commerce:

    • Adobe Commerce: uno spazio dati di produzione; due spazi dati di test. Nei progetti 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.
    • Magento Open Source: uno spazio dati di produzione; nessuno spazio dati di prova
  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