After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Setting Up Engagement Cloud

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

To get started with dotdigital Engagement Cloud, you must first sign up for a free account. Then, follow the instructions to complete the setup and log in to your account dashboard.

Step 1: Sign Up for a Free Trial

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand DOTDIGITAL and choose Accounts.

  3. In the banner, click Start free trial.

    dotdigital configuration - start free trial Start Free Trial

  4. Complete the form and click Create an Account.

    dotdigital - free trial sign up Create an Account

  5. Wait a few moments while your account is created. When the congratulations message appears, click Close ( Close icon).

    dotdigital is now enabled, and your API Username and API Password appear in the Settings section of the Magento configuration.

  6. In the upper-right corner, click Save Config.

  7. When prompted, click the Cache Management link in the message at the top of the page. Then, refresh any invalid cache.

    dotdigital configuration - account credentials Account Credentials

Step 2: Set Up dotdigital Chat (Optional)

  1. In the Magento Configuration under DOTDIGITAL, choose Chat Settings.

  2. Set Enabled to Yes. Then, click Save Config.

  3. Return to the Chat Settings section, and at Configure Chat Widget, click Configure.

    dotdigital configuration - chat settings Chat Settings - Enabled

    If you set up the Chat widget at a later time, you will be required to log in to your dotdigital account. When your account opens, click the Chat option in the sidebar on the left. Then at the top of the page, choose Settings.

  4. In the Theme section For new visitors, click Sonar.

    This setting makes the Chat button glow green for new visitors to your store.

    The diagram to the right shows how the chat window looks with the current settings.

  5. When complete, click Save and generate code.

    dotdigital configuration - chat widget Chat Widget Settings

  6. In your store, the name of the team appears in the heading of the Chat window. To set up your Chat Teams, do one of the following:

    • From the Chat Settings tab of your dotdigital account, choose the Teams tab.

    • From the Chat Settings section of the Magento configuration, at Configure Chat Teams, click Configure.

    Then, do the following:

    • Enter your Team name. (You can set up more teams later.)
  7. When complete, click Save.

Step 3: Create a Campaign

  1. During the welcome interview, you are asked to answer a few questions about your business. When prompted, complete the interview and navigate through the introduction.

  2. Click Build your first campaign.

    To continue, see Create a Campaign.

    At some point while working with your free trial, you’ll be asked to verify your account. When prompted, click the free trial message above the header and follow the instructions. Until then, the status of your account will be unverified.

    dotdigital - build your first campaign Build Your First Campaign

Step 4: Complete the Magento Configuration

The dotdigital configuration includes numerous settings to sync order, catalog, and abandoned cart data, and to configure additional features. To learn more, see the Quick Start Configuration Guide for Magento 2.