Configure the Experience Cloud Integration with the Commerce Admin

Check the Commerce environment and application configuration.

Enable the Commerce Admin Unified Experience extension.

Set up Adobe I/O Events for Commerce.

Test the integration.

On your local workstation, change to the project directory for your Commerce project.

Check out the environment branch for the instance to integrate with Experience Cloud.

Verify that Adobe IMS is enabled.

• Use the SSH Access URL for the environment to connect to the Commerce application server.

• From the command line, use the Adobe Commerce CLI to check the IMS module status.

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

If the module is not enabled, enable it using the Organization and credentials for the IMS integration project.

Verify that the Admin user can log into the Commerce Admin using their Adobe ID.

• Go to the Commerce Admin URL.

• If you are logged in, log out.

• Ensure that the Admin user is redirected to log in using their Adobe ID.

  {width="600" modal="regular"}

From the cloud project directory on your local workstation, verify that the Commerce Admin Unified Experience extension is installed.

composer show *unified-experience*

If the extension is installed, Composer returns the extension name and description.

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

If the extension is not installed, use Composer to install it. Then, commit the changes and redeploy the cloud environment.

composer require magento/module-unified-experience
composer update

From the root directory of your Cloud project environment on your local workstation, use the magento-cloud CLI tool to log in to the Commerce application server.

magento-cloud ssh

Enable the magento/module-unified-experience extension using the Adobe Commerce CLI:

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

Clear the cache.

bin/magento cache:clean

From your local Commerce project development environment, add the following configuration to the .magento.env.yaml file.

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

Add, commit, and deploy the updated .magento.env.yaml file to the cloud environment.

Create an App Builder project to receive event data from the Commerce instance.

You need credentials and configuration data from the App Builder project to configure the integration in the Commerce Admin.

Configure Adobe Commerce to use Adobe I/O Events.

• Update the Store Configuration settings for the Adobe I/O Events service.

• Configure an event provider to send Commerce events.

Update the App Builder project to receive event data from the Commerce instance.

Do not register or subscribe to events from the Commerce instance. The event registration is pushed to the App Builder project when you configure the event provider for the Commerce application.

After connecting the event provider to the App Builder project, subscribe to the observer.uex_commerce_instance_update event and save the changes.

To establish the connection, send an event through the event provider to the consumer.

• From the command line in the local cloud project directory, use SSH to connect to the Commerce application server.

  code language-bash
  magento-cloud ssh

• Send event data by checking the status of the Admin Unified Experience extension using the Adobe Commerce CLI.

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

Sign in to Experience Cloud using the Adobe ID and organization associated with the Commerce instance.

{width="600" modal="regular"}

View available Commerce Projects by selecting Commerce.

{width="600" modal="regular"}

Open the Admin for an instance by selecting Open.

{width="600" modal="regular"}

Verify that you can perform Admin tasks as expected.

Workflows in the Commerce Admin should follow the same process. If you experience workflow changes or errors after enabling the Experience Cloud integration, contact your Commerce system administrator or submit an Adobe Support ticket.