Skip to main content
All CollectionsIntegrationscommercetools
Integrate commercetools with Dotdigital
Integrate commercetools with Dotdigital

Learn how to automatically import your commercetools commerce data into your Dotdigital account.

Gareth Burroughes avatar
Written by Gareth Burroughes
Updated over a year ago

Once you automatically import your commercetools commerce data into your Dotdigital account, you can start to take advantage of our commerce intelligence tools to enrich your marketing and customer engagement.


Before you start

Things you need to know:

  • You must have a commercetools account.

  • You must be able to provide access to the commercetools API.

    We can help you with this.

  • The integration syncs data one way; from commercetools to Dotdigital.

  • Abandoned carts are not included in the integration by default. Your developers can install the necessary scripts on your storefront and we can assist in troubleshooting and testing.

    Learn more in Setting up abandoned carts and speak to your Customer Success representative.


Benefits


Features

  • Import your product catalog.

  • Import your customers as contacts.

    When an email is available for the customer

  • Import your order data and link it with a customer or contact .

  • New data is imported every 15 minutes.


Synced contact data

Contact records from commercetools are added into a pre-defined list in Dotdigital.

You can specify which list to sync customers to during the integration setup process.

The integration creates contact records in Dotdigital for all contacts present in commercetool’s customer list. The following data fields are mapped by default:

Dotdigital data field

commercetools data field

First name

First name

Last name

Last name

Full name

N/A

DOB

Date of birth

Customer ID

Customer ID

Custom attributes

It’s possible to map any custom contact fields you have created in commercetools to a custom data field in Dotdigital.

Mapping of custom fields can be requested during the integration setup process.

Marketing opt-in statuses

As commercetools does not automatically store any marketing or opt in information for contacts, you might be storing opt-in information in a CRM or another platform. If you want to sync opt-in data for contacts you can:

  • Create a custom field in commercetools for storing opt-in information. The integration can use this as a basis to map into a custom data field in Dotdigital, for example, NEWSLETTER_SUBSCRIBE = YES/NO.

  • Consider syncing opt-in status from your CRM or other system to Dotdigital directly.

    Learn more about the other integrations that are available in the Integrations section of the Help Centre.

  • If you’re not currently storing opt-in or consent data, contacts synced to Dotdigital are set to an Unknown opt-in state. You can use Dotdigital to gather and store consent data.


Synced Insight data

Your commercetools product (catalog) and order data are synced into Dotdigital as Insight data collections.

Product catalog data

The following product attributes are synced to Dotdigital by default:

Additional attributes can be mapped by request to the Dotdigital team during the integration setup process.

Attribute

Type

id

string

name (✔️)

string

price (✔️)

numerical

specialPrice

numerical

url (✔️)

string

sku (✔️)

string

stock

numerical

status

string

image_path (✔️)

string

Currency

string

A tick (✔️) next to an attribute indicates that it's mandatory for our product recommendations feature.

Order data

All orders present in commercetools’ Order lists sync to Dotdigital as long as there is an email address associated with the order record.

The following order statuses are synced to Dotdigital:

commercetools order status

Dotdigital order status

Open

Pending

Confirmed

Paid

Complete

Completed

Cancelled

Cancelled

Did this answer your question?