General: Getting started - Magento 2

Learn about the Dotdigital for Magento 2 extension.

Overview

The Dotdigital for Magento connector is a powerful extension that enables you to integrate your email marketing with your Magento store's customer and product data. Straightforward and speedy installation and integration allows for swift synchronisation of all of your Dotdigital email data with your Magento ecommerce customer data.

It is the most feature-rich integration for Magento in both B2C and B2B channels.

Making use of key Dotdigital features such as OrderInsight, external dynamic content, automation and page and ROI tracking, the connector enables storage of all your customers' orders, carts and wishlists; segmentation on purchase behaviour; automation of email triggers, such as a welcome series or post-purchase feedback; reporting on page visits and ROI for each campaign; abandoned cart emails, including the cart contents; inclusion of dynamic product recommendations in emails; sending of SMS order status notifications; and insertion of uniquely generated voucher codes for each individual customers in your campaigns.

About the extension

Dotdigital for Magento 2 is a family of extensions that integrate with different functionality in Dotdigital. We have a combined package (referred to as a ‘metapackage’) that provides:

  • Our main extension Dotdigitalgroup_Email
  • A Chat extension
  • An SMS extension
  • An Inventory extension
  • Two extensions for GraphQl support

In addition, we have two further extensions that you can install separately:

  • Our Enterprise extension supports features exclusive to Adobe Commerce
  • Our B2B extension is for merchants running Adobe Commerce for B2B

Our latest code runs on Magento Open Source and Adobe Commerce (version 2.3 upwards). Compatibility changes over time; to check the latest requirements, check out our Github page.

How the core data synchronisation process works

The core data synchronisation process works via the creation and population of database tables during the installation process, and these are then updated and maintained using a handful of observers and cron services.

Creation of databases

Upon installation of the connector, we create nine new database tables. These are:

  • email_contact - All contacts who will be synced to Dotdigital
  • email_order - All orders that will be synced
  • email_wishlist - All wishlists that will be synced
  • email_review - All reviews that will be synced
  • email_catalog - All products that will be synced
  • email_automation - All contacts due to be enrolled or that have been enrolled into a program that will be synced
  • email_campaign - All campaign sends sent or due to be sent (abandoned cart or review requests only) that will be synced
  • email_importer - All batches of data that have been imported or due to be imported that will be synced
  • email_abandoned_cart - Stores quotes for the abandoned cart email series
  • email_contact_consent - Stores consent data if Stores > Configuration > Dotdigital > Configuration > Consent settings are enabled.
  • email_coupon_attribute - Stores coupon properties for coupons created via our coupon URL.
  • email_failed_auth - Logs authorization failures when our dynamic content URLs are accessed with an incorrect passcode.
  • email_rules - Stores exclusion rules configured in Marketing > Exclusion Rules.

During installation these tables become populated with your historical data, after which time they are updated automatically by cron services.

Cron services

The following cron services batch data from these tables and add them to the email_importer table ready for import:

  • ddg_automation_customer_subscriber_guest_sync - Batches data from email_contact table
  • ddg_automation_order_and_quote_sync - Batches data from email_order and email_quote tables. Also finds orders placed via guests and adds contacts to email_contact table (the frequency can be configured).
  • ddg_automation_reviews_and_wishlist - Batches data from email_review and email_wishlist tables (the frequency can be configured)
  • ddg_automation_catalog_sync - Batches product data from email_catalog table (frequency can be configured)

All of the above cron services can have their frequency configured.

All of this data gets batched and then added to the email_importer table, which involves the running of the following cron service:

  • ddg_automation_importer - Looks for the oldest non-imported import and kicks off an import. This runs every 5 minutes (again, the frequency can be configured), checks the status of the last import and, if complete, marks it as done and then starts the next one. 

The importer also checks the import fault file for all contact imports and if it contains suppressed contacts, it updates their status in both the email_contact table and the core Magento newsletter table.

The following cron services also perform the following tasks:

  • ddg_automation_abandonedcarts - Detects abandoned carts based on the time settings you specify and adds contacts that are due to receive an email to email_campaign table (this runs every 5 minutes)
  • ddg_automation_campaign - Creates contacts and performs sends of all unsent campaigns (abandoned cart and review requests only; this runs every 5 minutes)
  • ddg_automation_status - Creates and enrols any contacts into the email_automation table that haven't been added yet (this runs every 15 minutes)
  • ddg_automation_cleaner - Archives files created from the batching process (this runs once a month, so it keeps your table clean. Contact support if this isn't working.).
  • ddg_automation_monitor - Scans your tables for errors, to be flagged in System Alerts (runs every 15 minutes).
  • ddg_automation_integration_insights - Sends data about your Magento installation and your connector configuration to Dotdigital (runs once a week).
  • ddg_automation_unsubscribe - Fetches recent suppressions from Dotdigital and unsubscribes matching email addresses in Magento.
  • ddg_automation_resubscribe - Fetches recently-modified contacts in Dotdigital and resubscribes matching email addresses in Magento.

Magento multisite implementation

If you have multiple Magento websites and stores, the connector will support these. All the data we send includes both the website and the store that the data originated from, so you can use this information for segmentation.

In addition, all settings can be configured on a per-website basis, allowing different websites to sync to different Dotdigital accounts.

Did you find this article helpful?

Can we help?

Thanks for using Dotdigital. If you need more help or support, then contact our support team.