The connector allows you to map and synchronise your product catalog from your store to your Dotdigital account.
With your product catalog synchronised, you can insert products into campaigns with ease by utilising the Products building block in EasyEditor or setting up Product Recommendations.
Before you start
Things you need to know:
You need to make sure you have saved and valid API credentials.
Learn more in Getting started with the API.
Enable catalog sync
Go to Stores > Configuration > DOTDIGITAL > Sync Settings, and find the heading Sync.
Expand the Catalog Enabled drop-down menu, and select Yes.
Select Save Config.
List of synced catalog data
The catalog data that gets synced includes:
Field name | Description |
id | The database ID of the product. |
image_path | The image path of the default image for the product. |
stock | The current stock levels of the product. |
websites | The websites the product is currently available on. |
name | The name of the product. |
sku | The SKU of the product. |
status | The current status of the product in your store. |
visibility | The current visibility status of the product. |
price | The current price of the product. |
special_price | The current special price set on the product. |
categories | The current categories associated with the product. |
url | The current URL the product can be viewed on. |
Catalog sync settings
You can choose to sync only products of a certain visibility or product type rather than all products. This allows you to keep your catalog organised by excluding products that are no longer relevant on your site.
To sync products based on visibility or product type:
Go to Stores > Configuration > DOTDIGITAL > Configuration.
Under the heading Catalog Sync Settings, choose the Catalog Value, Product Visibility and Catalog Types that you want to sync.
When finished, select Save Config.
Broken Product Images?
Try setting the Store Value to Store. This uses the store URL for the image path instead of the admin URL.
Custom attributes
In addition to our standard default order data fields, you have the option to synchronise custom product attributes. This list comprises all of the order attributes that are available within your store's system, allowing you to segment and send content based upon these too.
To choose your product custom attributes status:
Go to Stores > Configuration > DOTDIGITAL > Configuration and find the heading Transactional Data.
For Product Custom Attributes, select the attributes you want to import.
To choose multiple, hold down the CTRL key on your keyboard.
Reset the synch after configuration update
After updating the configuration for catalog sync settings, it is recommended to reset the sync. This step is not mandatory but allows the data to sync through again with the updated configuration or attributes. Otherwise, only new changes reflect their updates
Learn how to Reset the sync.
Troubleshooting
Catalog sync is enabled but nothing is displaying in Dotdigital
This could be for the following reasons:
You do not have valid API credentials or saved details
Cron is not running on your site.
Learn more in Magento Open Source and Adobe Commerce databases and cron services.The importer is currently processing other imports and hasn't got to the catalog import yet
Catalog data is marked as imported in the storefront but not showing in Dotdigital
Insight data can take several minutes to be imported and show in Dotdigital even after a sync is complete. Also ensure you don’t already have catalog data imported with matching ID's, such as from a staging site, as this key must be unique.