Konfigurera integreringen av Experience Cloud med Commerce Admin

Kom igång med integreringen av Experience Cloud med Commerce Admin genom att konfigurera Commerce-programmet så att det använder tilläggen Commerce Admin Unified Experience och Commerce Events.

Förutsättningar

  • Adobe Commerce måste vara konfigurerat att använda Adobe IMS-autentisering

  • Kontoetablering och behörigheter - Administratörer måste ha en Adobe-affärsprofil med tillgång till följande resurser för att konfigurera Experience Cloud-integreringen:

    • Adobe Admin Console - Lägg till och hantera användare- och utvecklarkonton för Adobe för organisationen
    • Adobe Developer Console - Åtkomst för utvecklare eller systemadministratör för att skapa App Builder-projekt och generera anslutningsautentiseringsuppgifter och projektkonfiguration för att använda tjänsten Adobe I/O Events
    • Commerce i molninfrastrukturprojekt - Installera nödvändiga moduler och konfigurera Commerce-programservern med Adobe Commerce CLI
    • Commerce Admin - Uppdatera butikskonfigurationen och hantera Commerce-användarkonton

Konfigurationsöversikt

Aktivera integreringen genom att utföra följande uppgifter:

Kontrollera Commerce-miljön och programkonfigurationen

Innan du konfigurerar integreringen med Experience Cloud bör du kontrollera att ditt projekt och Commerce-programmet uppfyller kraven.

  1. Gå till projektkatalogen för ditt Commerce-projekt på din dator.

  2. Kolla in miljögrenen där instansen kan integreras med Experience Cloud.

  3. Kontrollera att Adobe IMS är aktiverat.

    • Använd SSH Access URL för miljön för att ansluta till Commerce-programservern.

    • Använd Adobe Commerce CLI på kommandoraden för att kontrollera IMS-modulens status.

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

    Om modulen inte är aktiverad aktiverar du den med hjälp av organisationen och autentiseringsuppgifterna för IMS-integrationsprojektet.

  4. Kontrollera att administratörsanvändaren kan logga in på Commerce Admin med sin Adobe ID.

    • Gå till Commerce Admin URL.

    • Logga ut om du är inloggad.

    • Se till att administratörsanvändaren omdirigeras för att logga in med sin Adobe ID.

      Adobe Commerce Logga in med Adobe ID {width="600" modal="regular"}

  5. Kontrollera att Commerce Admin Unified Experience-tillägget är installerat från molnprojektkatalogen på din lokala arbetsstation.

    code language-bash
    composer show *unified-experience*
    

    Om tillägget är installerat returnerar Composer tilläggets namn och beskrivning.

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

    Om tillägget inte är installerat kan du installera det med Composer. Verkställ sedan ändringarna och distribuera om molnmiljön.

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

Aktivera Commerce Admin Unified Experience

Aktivera tillägget Commerce Admin Unified Experience och logga sedan in via Experience Cloud.

NOTE
Dessa instruktioner visar hur en Commerce Cloud-projektadministratör kan aktivera tillägget med Adobe Commerce CLI. Commerce Admin-användare kan även aktivera tillägget genom att uppdatera konfigurationsinställningarna för Commerce Store.
  1. I rotkatalogen för din molnprojektmiljö på din lokala arbetsstation använder du magento-cloud CLI-verktyget för att logga in på Commerce programserver.

    code language-bash
    magento-cloud ssh
    
  2. Aktivera tillägget magento/module-unified-experience med Adobe Commerce CLI:

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

    code language-bash
    bin/magento cache:clean
    

Konfigurera Adobe I/O-händelser för Commerce

När integreringen av Experience Cloud är aktiverad skickar händelsetjänsten Adobe I/O händelsedata från Commerce till Experience Cloud för att hantera administratörsåtkomst till Commerce-projekt. Tjänstkonfigurationen kräver att du aktiverar tillägget Adobe I/O Events för Commerce (magento/commerce-eventing) och konfigurerar tjänsten Adobe I/O Events i Admin.

Aktivera Commerce Events

Aktivera tillägget Commerce Events (magento/commerce-eventing) för att skicka anpassade händelsedata från Commerce-programmet till tjänsten Adobe I/O Events.

NOTE
För Commerce 2.4.6 och senare installeras tillägget Commerce Events som standard. För Commerce-projekt med Commerce 2.4.5 använder du först Composer för att installera tillägget och sedan aktivera det.
  1. Lägg till följande konfiguration i filen .magento.env.yaml från den lokala Commerce-projektutvecklingsmiljön.

    code language-yaml
    stage:
      global:
        ENABLE_EVENTING: true
      deploy:
        CRON_CONSUMERS_RUNNER:
          cron_run: true
          max_messages: 0
          consumers: []
    
  2. Lägg till, bekräfta och distribuera den uppdaterade .magento.env.yaml file till molnmiljön.

TIP
Mer information om hur du konfigurerar och hanterar miljövariabler med filen .magento.env.yaml finns i Konfigurera miljövariabler för distribution.

Konfigurera integreringen med Commerce Events

Konfigurera integreringen av Commerce Events genom att utföra följande uppgifter. Mer information finns i Adobe I/O-händelser för Commerce-utvecklardokumentation.

  1. Skapa ett App Builder-projekt för att ta emot händelsedata från Commerce-instansen.

    Du behöver autentiseringsuppgifter och konfigurationsdata från App Builder-projektet för att konfigurera integreringen i Commerce Admin.

  2. Konfigurera Adobe Commerce att använda Adobe I/O Events.

  3. Uppdatera App Builder-projektet för att ta emot händelsedata från Commerce-instansen.

    Registrera eller prenumerera inte på händelser från Commerce-instansen. Händelseregistreringen skickas till App Builder-projektet när du konfigurerar händelseprovidern för Commerce-programmet.

    När du har anslutit händelseprovidern till App Builder-projektet kan du prenumerera på observer.uex_commerce_instance_update-händelsen och spara ändringarna.

  4. Om du vill upprätta anslutningen skickar du en händelse via händelseprovidern till konsumenten.

    • Från kommandoraden i den lokala molnprojektkatalogen använder du SSH för att ansluta till Commerce programserver.

      code language-bash
      magento-cloud ssh
      
    • Skicka händelsedata genom att kontrollera statusen för Admin Unified Experience-tillägget med Adobe Commerce CLI.

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

Testa integreringen

Kontrollera att en Commerce-administratör kan logga in på Experience Cloud för att visa tillgängliga Commerce-projekt och få åtkomst till Admin och Storefront för varje projekt.

  1. Logga in på Experience Cloud med den Adobe ID och organisation som är associerad med Commerce-instansen.

    Få åtkomst till Commerce-projekt från Experience Cloud hemsida {width="600" modal="regular"}

  2. Visa tillgängliga Commerce-projekt genom att välja Commerce.

    Commerce Projects-arbetsyta för Experience Cloud {width="600" modal="regular"}

  3. Öppna administratören för en instans genom att välja Open.

    Commerce Admin-vy med Experience Cloud-integrering aktiverad {width="600" modal="regular"}

  4. Verifiera att du kan utföra administratörsåtgärder som förväntat.

    Samma process bör användas för arbetsflöden i Commerce Admin. Om arbetsflödesändringar eller fel inträffar när integreringen med Experience Cloud har aktiverats kontaktar du Commerce systemadministratör eller skickar en Adobe Support-biljett.

När du har konfigurerat integreringen med Experience Cloud kontrollerar du att administratörskonton har etablerats korrekt för att få åtkomst till Commerce-projekt via Experience Cloud. Se Hantera administratörsanvändare.

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