Documentazione Commerce Guida introduttiva

Configurare l’integrazione di Experience Cloud con l’amministratore di Commerce

Ultimo aggiornamento: 15 luglio 2024

Argomenti:

Creato per:

Principiante
Intermedio
Amministratore
Leader

Inizia a usare l’integrazione di Experience Cloud con Commerce Admin configurando l’applicazione Commerce per l’utilizzo delle estensioni Commerce Admin Unified Experience e Commerce Events.

Prerequisiti

Adobe Commerce deve essere configurato per l'utilizzo di autenticazione Adobe IMS
Provisioning account e autorizzazioni: gli amministratori devono disporre di un profilo aziendale Adobe con accesso alle risorse seguenti per configurare l'integrazione Experience Cloud:
- Adobe Admin Console - Aggiungi e gestisci gli account utente e sviluppatore Adobi per l'organizzazione
- Adobe Developer Console: accesso per sviluppatori o amministratori di sistema per creare progetti App Builder e generare le credenziali di connessione e la configurazione del progetto per utilizzare il servizio Adobe I/O Events
- Progetto Commerce su infrastruttura cloud: installazione dei moduli richiesti e configurazione del server applicazioni Commerce tramite Adobe Commerce CLI
- Amministratore Commerce: aggiorna la configurazione dell'archivio e gestisci gli account utente di Commerce

Panoramica sulla configurazione

Abilita l’integrazione completando le seguenti attività:

Controllare l'ambiente Commerce e la configurazione dell'applicazione.
Abilita l'estensione Commerce Admin Unified Experience.
Configura eventi di Adobe I/O per Commerce.
Verifica l'integrazione.

Controllare l'ambiente Commerce e la configurazione dell'applicazione

Prima di configurare l’integrazione Experience Cloud, verifica che il progetto e l’applicazione Commerce soddisfino i requisiti.

Sulla workstation locale, passa alla directory del progetto per il progetto Commerce.
Consulta il ramo dell’ambiente per l’istanza da integrare con Experience Cloud.
Verifica che Adobe IMS sia abilitato.
- Utilizzare l'URL di accesso SSH per l'ambiente per connettersi al server applicazioni Commerce.
- Dalla riga di comando, utilizza Adobe Commerce CLI per verificare lo stato del modulo IMS.
  bin/magento admin:adobe-ims:status
Se il modulo non è abilitato, attivalo utilizzando l'organizzazione e le credenziali per il progetto di integrazione IMS.
Verifica che l’utente Admin possa accedere a Commerce Admin utilizzando il proprio Adobe ID.
- Passa all’URL dell’amministratore di Commerce.
- Se hai effettuato l’accesso, disconnettiti.
- Assicurati che l’utente Admin venga reindirizzato per l’accesso utilizzando il proprio Adobe ID.
Dalla directory del progetto cloud sulla workstation locale, verifica che sia installata l’estensione Commerce Admin Unified Experience.
composer show *unified-experience*
Se l'estensione è installata, Composer restituisce il nome e la descrizione dell'estensione.
magento/module-unified-experience <version> Commerce module responsible for integration with Adobe Experience Cloud
Se l'estensione non è installata, utilizza Composer per installarla. Quindi, esegui il commit delle modifiche e ridistribuisci l’ambiente cloud.
composer require magento/module-unified-experience composer update

Abilita esperienza unificata amministrazione Commerce

Abilita l’estensione Commerce Admin Unified Experience, quindi accedi tramite Experience Cloud.

NOTE

Queste istruzioni mostrano come un amministratore di progetto Commerce Cloud può abilitare l’estensione utilizzando Adobe Commerce CLI. Gli utenti di Commerce Admin possono inoltre abilitare l'estensione aggiornando le impostazioni di configurazione dell'archivio Commerce.

Dalla directory principale dell'ambiente di progetto Cloud sulla workstation locale, utilizza lo strumento CLI magento-cloud per accedere al server applicazioni Commerce.
magento-cloud ssh

Abilitare l'estensione magento/module-unified-experience utilizzando Adobe Commerce CLI:

bin/magento config:set admin/unified_experience/enabled 1
Admin Unified Experience integration is enabled

Cancella la cache.
bin/magento cache:clean

Configurare eventi di Adobe I/O per Commerce

Quando l’integrazione Experience Cloud è abilitata, il servizio Adobe I/O Events invia i dati dell’evento Commerce ad Experience Cloud per gestire l’accesso degli amministratori ai progetti Commerce. La configurazione del servizio richiede l'abilitazione dell'estensione Adobe I/O Events for Commerce (magento/commerce-eventing) e la configurazione del servizio Adobe I/O Events in Admin.

Abilita eventi Commerce

Abilitare l'estensione Commerce Events (magento/commerce-eventing) per inviare dati evento personalizzati dall'applicazione Commerce al servizio Adobe I/O Events.

NOTE

Per Commerce 2.4.6 e versioni successive, l’estensione Commerce Events viene installata per impostazione predefinita. Per i progetti Commerce con Commerce 2.4.5, utilizzare innanzitutto Composer per installare l'estensione, quindi abilitarla.

Nell'ambiente di sviluppo del progetto Commerce locale, aggiungere la seguente configurazione al file .magento.env.yaml.

stage:
  global:
    ENABLE_EVENTING: true
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 0
      consumers: []

Aggiungere, eseguire il commit e distribuire .magento.env.yaml file aggiornato nell'ambiente cloud.

TIP

Per informazioni dettagliate sulla configurazione e la gestione delle variabili di ambiente tramite il file .magento.env.yaml, vedere Configurare le variabili di ambiente per la distribuzione.

Configurare l’integrazione di Commerce Events

Configura l’integrazione degli eventi di Commerce completando le seguenti attività. Per istruzioni dettagliate, consulta la documentazione di Adobe I/O Events for Commerce Developer.

Crea un progetto App Builder per ricevere i dati dell'evento dall'istanza Commerce.

Per configurare l’integrazione in Commerce Admin, sono necessari le credenziali e i dati di configurazione del progetto App Builder.
Configura Adobe Commerce per utilizzare gli eventi Adobe I/O.
- Aggiorna le impostazioni di configurazione dell'archivio per il servizio Eventi Adobe I/O.
- Configurare un provider di eventi per inviare eventi Commerce.
Aggiorna il progetto App Builder per ricevere i dati evento dall'istanza Commerce.

Non registrarti o iscriverti a eventi dall’istanza di Commerce. La registrazione dell’evento viene inviata al progetto App Builder quando configuri il provider di eventi per l’applicazione Commerce.

Dopo aver collegato il provider di eventi al progetto App Builder, abbonati all'evento observer.uex_commerce_instance_update e salva le modifiche.
Per stabilire la connessione, invia un evento al consumatore tramite il provider di eventi.
- Dalla riga di comando nella directory del progetto cloud locale, utilizzare SSH per connettersi al server applicazioni Commerce.
  magento-cloud ssh
- Invia i dati dell’evento controllando lo stato dell’estensione Admin Unified Experience tramite Adobe Commerce CLI.
  bin/magento bin/magento admin:uex:status

Testare l’integrazione

Verifica che un amministratore di Commerce possa accedere ad Experience Cloud per visualizzare i progetti Commerce disponibili e accedere ad Admin e Storefront per ciascun progetto.

Accedi a Experience Cloud utilizzando l'Adobe ID e l'organizzazione associate all'istanza di Commerce.
Visualizza progetti Commerce disponibili selezionando Commerce.
Aprire l'amministratore per un'istanza selezionando Open.
Verifica di poter eseguire le attività di amministrazione come previsto.

I flussi di lavoro nell’amministratore di Commerce devono seguire la stessa procedura. Se si verificano modifiche o errori del flusso di lavoro dopo l'abilitazione dell'integrazione Experience Cloud, contattare l'amministratore di sistema di Commerce o inviare un ticket di supporto Adobe.

Dopo aver configurato l’integrazione di Experience Cloud, verifica che gli account amministratore dispongano del provisioning corretto per accedere ai progetti Commerce tramite Experience Cloud. Consulta Gestione utenti amministratori.

recommendation-more-help