Konfigurieren der Experience Cloud-Integration mit Commerce Admin

Beginnen Sie mit der Experience Cloud-Integration mit Commerce Admin, indem Sie die Commerce-Anwendung für die Verwendung der Commerce Admin Unified Experience und Commerce Events-Erweiterungen konfigurieren.

Voraussetzungen

  • Adobe Commerce muss für die Verwendung von Adobe IMS-Authentifizierung konfiguriert werden

  • Kontobereitstellung und -berechtigungen - Administratoren müssen über ein Adobe-Geschäftsprofil mit Zugriff auf die folgenden Ressourcen verfügen, um die Experience Cloud-Integration zu konfigurieren:

    • Adobe Admin Console - Hinzufügen und Verwalten von Adobe-Benutzer- und Entwicklerkonten für das Unternehmen
    • Adobe Developer Console - Entwickler- oder Systemadministratorzugriff zum Erstellen von App Builder-Projekten und Generieren der Verbindungsanmeldeinformationen und der Projektkonfiguration für die Verwendung des Adobe I/O Events-Dienstes
    • Commerce im Cloud-Infrastrukturprojekt - Installieren Sie die erforderlichen Module und konfigurieren Sie den Commerce-Anwendungsserver mithilfe der Adobe Commerce-CLI.
    • Commerce Admin - Aktualisieren der Speicherkonfiguration und Verwalten von Commerce-Benutzerkonten

Konfigurationsübersicht

Aktivieren Sie die Integration, indem Sie die folgenden Aufgaben ausführen:

Überprüfen der Commerce-Umgebung und Anwendungskonfiguration

Bevor Sie die Experience Cloud-Integration konfigurieren, stellen Sie sicher, dass Ihr Projekt und Ihre Commerce-Anwendung die Anforderungen erfüllen.

  1. Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis für Ihr Commerce-Projekt.

  2. Sehen Sie sich die Umgebungsverzweigung an, damit die Instanz mit Experience Cloud integriert werden kann.

  3. Stellen Sie sicher, dass Adobe IMS aktiviert ist.

    • Verwenden Sie die SSH-Zugriffs-URL für die Umgebung, um eine Verbindung zum Commerce-Anwendungsserver herzustellen.

    • Verwenden Sie in der Befehlszeile die Adobe Commerce-CLI, um den IMS-Modulstatus zu überprüfen.

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

    Wenn das Modul nicht aktiviert ist, aktivieren Sie es mithilfe der Organisation und der Anmeldeinformationen für das IMS-Integrationsprojekt🔗.

  4. Vergewissern Sie sich, dass sich der Admin-Benutzer über seine Adobe ID bei Commerce Admin anmelden kann.

    • Rufen Sie die Commerce Admin-URL auf.

    • Wenn Sie angemeldet sind, melden Sie sich ab.

    • Stellen Sie sicher, dass der Admin-Benutzer zur Anmeldung mit seinem Adobe ID umgeleitet wird.

      Adobe Commerce-Anmeldung mit Adobe ID {width="600" modal="regular"}

  5. Überprüfen Sie im Cloud-Projektverzeichnis auf Ihrer lokalen Workstation, ob die Commerce Admin Unified Experience-Erweiterung installiert ist.

    code language-bash
    composer show *unified-experience*
    

    Wenn die Erweiterung installiert ist, gibt der Composer den Namen und die Beschreibung der Erweiterung zurück.

    code language-none
    magento/module-unified-experience <version> Commerce module responsible for integration with Adobe Experience Cloud
    

    Wenn die Erweiterung nicht installiert ist, installieren Sie sie mit Composer. Übertragen Sie dann die Änderungen und stellen Sie die Cloud-Umgebung erneut bereit.

    code language-none
    composer require magento/module-unified-experience
    composer update
    

Commerce Admin Unified Experience aktivieren

Aktivieren Sie die Commerce Admin Unified Experience-Erweiterung und melden Sie sich dann über Experience Cloud an.

NOTE
Diese Anweisungen zeigen, wie ein Commerce Cloud-Projekt-Administrator die Erweiterung mithilfe der Adobe Commerce-CLI aktivieren kann. Commerce-Administratoren können die Erweiterung auch aktivieren, indem sie die Konfigurationseinstellungen für den Commerce-Store aktualisieren.
  1. Melden Sie sich über das CLI-Tool magento-cloud (Magento-Cloud) im Stammverzeichnis Ihrer Cloud-Projektumgebung auf Ihrer lokalen Workstation beim Commerce-Anwendungsserver an.

    code language-bash
    magento-cloud ssh
    
  2. Aktivieren Sie die Erweiterung "magento/module-unified-experience"mithilfe der Adobe Commerce-CLI:

    code language-bash
    bin/magento config:set admin/unified_experience/enabled 1
    Admin Unified Experience integration is enabled
    
  3. Löschen Sie den Cache.

    code language-bash
    bin/magento cache:clean
    

Einrichten von Adobe I/O-Ereignissen für Commerce

Wenn die Experience Cloud-Integration aktiviert ist, sendet der Adobe I/O Events-Dienst Commerce-Ereignisdaten an Experience Cloud, um den Administratorzugriff auf Commerce-Projekte zu verwalten. Für die Einrichtung des Dienstes müssen die Adobe I/O-Ereignisse für die Commerce-Erweiterung (magento/commerce-eventing) aktiviert und der Adobe I/O-Ereignisdienst in Admin konfiguriert werden.

Commerce-Ereignisse aktivieren

Aktivieren Sie die Commerce Events-Erweiterung (magento/commerce-eventing), um benutzerdefinierte Ereignisdaten von der Commerce-Anwendung an den Adobe I/O Events-Dienst zu senden.

NOTE
Für Commerce 2.4.6 und höher ist die Commerce Events-Erweiterung standardmäßig installiert. Verwenden Sie bei Commerce-Projekten mit Commerce 2.4.5 zunächst Composer , um die Erweiterung zu installieren, und aktivieren Sie sie dann.
  1. Fügen Sie in Ihrer lokalen Commerce-Projektentwicklungsumgebung die folgende Konfiguration zur Datei .magento.env.yaml hinzu.

    code language-yaml
    stage:
      global:
        ENABLE_EVENTING: true
      deploy:
        CRON_CONSUMERS_RUNNER:
          cron_run: true
          max_messages: 0
          consumers: []
    
  2. Fügen Sie das aktualisierte .magento.env.yaml file hinzu, übertragen Sie es und stellen Sie es in der Cloud-Umgebung bereit.

TIP
Weitere Informationen zum Konfigurieren und Verwalten von Umgebungsvariablen mithilfe der Datei .magento.env.yaml finden Sie unter Konfigurieren von Umgebungsvariablen für die Bereitstellung.

Commerce Events-Integration konfigurieren

Konfigurieren Sie die Commerce Events-Integration, indem Sie die folgenden Aufgaben ausführen. Detaillierte Anweisungen finden Sie in der Entwicklerdokumentation für Commerce🔗 unter Adobe I/O-Ereignisse .

  1. Erstellen Sie ein App Builder-Projekt , um Ereignisdaten von der Commerce-Instanz zu erhalten.

    Sie benötigen Anmeldeinformationen und Konfigurationsdaten aus dem App Builder-Projekt, um die Integration in Commerce Admin zu konfigurieren.

  2. Konfigurieren Sie Adobe Commerce für die Verwendung von Adobe I/O-Ereignissen.

  3. Aktualisieren Sie das App Builder-Projekt, um Ereignisdaten von der Commerce-Instanz zu erhalten.

    Registrieren Sie keine Ereignisse von der Commerce-Instanz oder abonnieren Sie sie. Die Ereignisregistrierung wird an das App Builder-Projekt gesendet, wenn Sie den Ereignisanbieter für die Commerce-Anwendung konfigurieren.

    Nachdem Sie den Ereignisanbieter mit dem App Builder-Projekt verbunden haben, abonnieren Sie das observer.uex_commerce_instance_update -Ereignis und speichern Sie die Änderungen.

  4. Um die Verbindung herzustellen, senden Sie ein Ereignis über den Ereignisanbieter an den Verbraucher.

    • Verwenden Sie über die Befehlszeile im lokalen Cloud-Projektverzeichnis SSH, um eine Verbindung zum Commerce-Anwendungsserver herzustellen.

      code language-bash
      magento-cloud ssh
      
    • Senden Sie Ereignisdaten, indem Sie den Status der Admin Unified Experience-Erweiterung mit der Adobe Commerce-CLI überprüfen.

      code language-bash
      bin/magento bin/magento admin:uex:status
      

Integration testen

Stellen Sie sicher, dass sich ein Commerce-Administrator bei Experience Cloud anmelden kann, um verfügbare Commerce-Projekte anzuzeigen und auf die Admin- und Storefront für jedes Projekt zuzugreifen.

  1. Melden Sie sich mit der Adobe ID und der Organisation, die mit der Commerce-Instanz verbunden sind, bei Experience Cloud an.

    Greifen Sie über die Experience Cloud-Startseite auf Commerce-Projekte zu {width="600" modal="regular"}

  2. Zeigen Sie verfügbare Commerce-Projekte durch Auswahl von "Commerce"an.

    Arbeitsbereich "Commerce-Projekte"für Experience Cloud {width="600" modal="regular"}

  3. Öffnen Sie den Admin für eine Instanz, indem Sie Open auswählen.

    Commerce-Admin-Ansicht mit aktivierter Experience Cloud-Integration {width="600" modal="regular"}

  4. Stellen Sie sicher, dass Sie Admin-Aufgaben erwartungsgemäß ausführen können.

    Workflows in Commerce Admin sollten denselben Prozess verfolgen. Wenn Workflow-Änderungen oder Fehler nach der Aktivierung der Experience Cloud-Integration auftreten, wenden Sie sich an Ihren Commerce-Systemadministrator oder senden Sie ein Adobe-Supportticket🔗.

Nachdem Sie die Experience Cloud-Integration konfiguriert haben, stellen Sie sicher, dass die Administratorkonten ordnungsgemäß bereitgestellt wurden, um über Experience Cloud auf Commerce-Projekte zuzugreifen. Siehe Verwalten von Admin-Benutzern.

recommendation-more-help
31746fd0-1ead-45b5-9192-1aaf582c5f66