Konfigurieren der Experience Cloud-Integration mit Commerce Admin

Beginnen Sie mit der Experience Cloud-Integration in Commerce Admin, indem Sie das Commerce-Programm so konfigurieren, dass es die Erweiterungen Commerce Admin Unified Experience und Commerce Events verwendet.

Voraussetzungen

  • Adobe Commerce muss für die Verwendung der Adobe IMS-Authentifizierung“ konfiguriert

  • Kontobereitstellung und -berechtigungen: Administratoren müssen über ein Adobe-GeschäftsprofilZugriff 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 zum Generieren der Verbindungsanmeldeinformationen und der Projektkonfiguration für die Verwendung des Adobe I/O-Ereignisdienstes
    • Commerce in einem Cloud-Infrastrukturprojekt—Installieren Sie die erforderlichen Module und konfigurieren Sie den Commerce-Anwendungsserver mithilfe der Adobe Commerce-CLI
    • Commerce Admin: Aktualisieren der Store-Konfiguration und Verwalten von Commerce-Benutzerkonten

Konfigurationsübersicht

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

Überprüfen der Commerce-Umgebung und der Anwendungskonfiguration

Stellen Sie vor dem Konfigurieren der Experience Cloud-Integration sicher, dass Ihr Projekt und Commerce-Programm die Anforderungen erfüllen.

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

  2. Checken Sie die Umgebungsverzweigung für die Instanz aus, die mit Experience Cloud integriert werden soll.

  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 aktivieren Sie es mithilfe der Organisation und der Anmeldeinformationen für das IMS-Integrationsprojekt.

  4. Vergewissern Sie sich, dass sich der Admin-Benutzer mit seiner Adobe ID bei Commerce Admin anmelden kann.

    • Navigieren Sie zur Commerce Admin-URL.

    • Wenn Sie angemeldet sind, melden Sie sich ab.

    • Stellen Sie sicher, dass der Administrator umgeleitet wird, um sich mit seiner Adobe ID anzumelden.

      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 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, verwenden Sie Composer, um sie zu installieren. Übertragen Sie dann die Änderungen und stellen Sie die Cloud-Umgebung erneut bereit.

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

Einheitliches Erlebnis für Commerce Admin aktivieren

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

NOTE
Diese Anweisungen zeigen, wie ein Commerce Cloud-Projekt-Administrator die Erweiterung mithilfe der Adobe Commerce-CLI aktivieren kann. Commerce-Admin-Benutzer können die Erweiterung auch aktivieren, indem sie die Konfigurationseinstellungen des Commerce Stores aktualisieren.
  1. Verwenden Sie im Stammverzeichnis Ihrer Cloud-Projektumgebung auf Ihrer lokalen Workstation das magento-cloud-CLI-Tool, um sich beim Commerce-Anwendungs-Server anzumelden.

    code language-bash
    magento-cloud ssh
    
  2. Aktivieren der magento/module-unified-experience-Erweiterung über die 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-Ereignisdienst Commerce-Ereignisdaten an Experience Cloud, um den Administratorzugriff auf Commerce-Projekte zu verwalten. Zum Einrichten des Service müssen Sie die Erweiterung Adobe I/O-Ereignisse für Commerce (magento/commerce-eventing) aktivieren und den Dienst Adobe I/O-Ereignisse in der Admin Console konfigurieren.

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-Service zu senden.

NOTE
Bei Commerce 2.4.6 und höher ist die Commerce Events-Erweiterung standardmäßig installiert. Verwenden Sie für Commerce-Projekte 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 der .magento.env.yaml-Datei die folgende Konfiguration hinzu.

    code language-yaml
    stage:
      global:
        ENABLE_EVENTING: true
      deploy:
        CRON_CONSUMERS_RUNNER:
          cron_run: true
          max_messages: 0
          consumers: []
    
  2. Hinzufügen, Übertragen und Bereitstellen der aktualisierten .magento.env.yaml file in die Cloud-Umgebung.

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

Konfigurieren der Commerce-Ereignisintegration

Konfigurieren Sie die Commerce-Ereignisintegration, indem Sie die folgenden Aufgaben ausführen. Detaillierte Anweisungen finden Sie in der Entwicklerdokumentation zu Adobe I/O-Ereignissen für Commerce.

  1. Erstellen eines App Builder-Projekts um Ereignisdaten von der Commerce-Instanz zu erhalten.

    Sie benötigen Anmeldedaten 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.

    Melden Sie sich nicht an und abonnieren Sie keine Ereignisse aus der Commerce-Instanz. Die Ereignisregistrierung wird an das App Builder-Projekt übergeben, 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 in der 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 einheitlichen Admin-Erlebniserweiterung mithilfe der Adobe Commerce-CLI überprüfen.

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

Testen der Integration

Stellen Sie sicher, dass sich ein Commerce-Administrator beim 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 bei Experience Cloud an indem Sie die Adobe ID und das mit der Commerce-Instanz verknüpfte Unternehmen verwenden.

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

  2. Anzeigen verfügbarer Commerce-Projekte durch Auswahl von Commerce.

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

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

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

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

    Workflows in der Commerce Admin sollten demselben Prozess folgen. Wenn nach der Aktivierung der Experience Cloud-Integration Workflow-Änderungen oder -Fehler auftreten, wenden Sie sich an Ihren Commerce-Systemadministrator oder Sie ein Adobe-Support-Ticket.

Stellen Sie nach dem Konfigurieren der Experience Cloud-Integration sicher, dass Administratorkonten für den Zugriff auf Commerce-Projekte über Experience Cloud korrekt bereitgestellt wurden. Siehe Verwalten von Admin-.

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