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

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

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

  1. Sulla workstation locale, passa alla directory del progetto per il progetto Commerce.

  2. Consulta il ramo dell’ambiente per l’istanza da integrare con Experience Cloud.

  3. 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.

      code language-bash
      bin/magento admin:adobe-ims:status
      

    Se il modulo non è abilitato, attivalo utilizzando l'organizzazione e le credenziali per il progetto di integrazione IMS.

  4. 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.

      Accesso ad Adobe Commerce tramite Adobe ID {width="600" modal="regular"}

  5. Dalla directory del progetto cloud sulla workstation locale, verifica che sia installata l’estensione Commerce Admin Unified Experience.

    code language-bash
    composer show *unified-experience*
    

    Se l'estensione è installata, Composer restituisce il nome e la descrizione dell'estensione.

    code language-none
    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.

    code language-none
    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.
  1. Dalla directory principale dell'ambiente di progetto Cloud sulla workstation locale, utilizza lo strumento CLI magento-cloud per accedere al server applicazioni Commerce.

    code language-bash
    magento-cloud ssh
    
  2. Abilitare l'estensione magento/module-unified-experience utilizzando Adobe Commerce CLI:

    code language-bash
    bin/magento config:set admin/unified_experience/enabled 1
    Admin Unified Experience integration is enabled
    
  3. Cancella la cache.

    code language-bash
    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.
  1. Nell'ambiente di sviluppo del progetto Commerce locale, aggiungere la seguente configurazione al file .magento.env.yaml.

    code language-yaml
    stage:
      global:
        ENABLE_EVENTING: true
      deploy:
        CRON_CONSUMERS_RUNNER:
          cron_run: true
          max_messages: 0
          consumers: []
    
  2. 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.

  1. 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.

  2. Configura Adobe Commerce per utilizzare gli eventi Adobe I/O.

  3. 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.

  4. 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.

      code language-bash
      magento-cloud ssh
      
    • Invia i dati dell’evento controllando lo stato dell’estensione Admin Unified Experience tramite Adobe Commerce CLI.

      code language-bash
      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.

  1. Accedi a Experience Cloud utilizzando l'Adobe ID e l'organizzazione associate all'istanza di Commerce.

    Accedi ai progetti Commerce dalla home page di Experience Cloud {width="600" modal="regular"}

  2. Visualizza progetti Commerce disponibili selezionando Commerce.

    Area di lavoro Progetti Commerce per Experience Cloud {width="600" modal="regular"}

  3. Aprire l'amministratore per un'istanza selezionando Open.

    Visualizzazione amministratore Commerce con integrazione Experience Cloud abilitata {width="600" modal="regular"}

  4. 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
31746fd0-1ead-45b5-9192-1aaf582c5f66