Settings

Contents

'Data Fields' configuration
'Developer' advanced settings
FAQs

Summary

With the dotmailer for Magento connector, you have additional data syncing configuration options within 'Configuration' and 'Developer'. For instance, you can select which order status types are used in order calculations.

To access these data field configuration options, click on SystemConfiguration > DOTMAILER > Configuration > Data Fields

To access advanced settings, click on SystemConfiguration > DOTMAILER Developer.

'Data Fields' configuration

Data fields calculations from status

You can select which order status type or types are used when calculating contact data field values such as total spend, average order value or number of orders, for instance. This means you can exclude those that you don't want to impact upon the calculation at all.

mag_config_data_fields.png

To choose multiple statuses, hold Ctrl whilst selecting. 

Select Save Config in the top right. Magento will confirm that the settings have been saved.

Brand attribute

Depending on how your Magento site has been set up, it could be that you don't use the default manufacturer attribute to define a product's brand. This option allows you to select an alternative attribute for the brand related values which are synced.

Select Save Config in the top right. Magento will confirm that the settings have been saved.

'Developer' advanced settings

You also have the ability to set some advanced settings, as well as manually running and resetting synchronisations, under 'Developer'. If you're not a developer, then it's probably more likely that you'll want your developer to deal with this section. For instance, you can adjust your import settings, automap your customers' details to dotmailer contact data fields, manually run synchronisations,  as well as reset/refresh synchronisations. This includes the ability to delete all contact IDs when wanting to synchronise with a different dotmailer account and API credentials.

Sync memory limit (under 'Import Settings')

Click on the dropdown list to select No to use the system default memory or Yes to use the customer sync memory default.

Depending on your site's configuration you may not have either enough memory set in the PHP memory or too low a PHP timeout setting for our sync to work. As a default we use your site's default setting but selecting 'Yes' will set the timeout as 7200 and the memory as 512MB.

mag_sync_memory_limit.png

Select Save Config in the top right. Magento will confirm that the settings have been saved.

Contact sync size 

You can set the batch size limit you require for the amount of contacts loaded for every sync. Just type this number into the box and then click Save Config.

Settling upon the ideal number will best be arrived at via your own cut-and-try process, dependent upon your particular server specifications.

It is important to note this batch size is per website, as we sync details at a website level. A batch size of 1000 would be 4000 if your Magento site has four websites running on the same instance and linked to dotmailer.

mag_contact_sync_size.png

Automap data fields (under 'Admin Tasks' in 'Sync Settings')

If you do not wish to manually map the key information that you store on customers from your Magento website to dotmailer contact data fields, then you can use this option to do it automatically.

Click Run Now and the relevant contact data fields will immediately be created in your dotmailer account to match your customer, address and sales information fields.

Delete all contact IDs

You may decide at a later date to synchronise your Magento site with a different dotmailer account, or even synchronise a different store front to a new dotmailer account. To ensure this works correctly you will need to delete all the customer contact IDs that have been stored against the customers, as these are unique to the dotmailer account.

mag_delete_all_contact_IDs.png

Manually run sync 

Click on Run Now to manually run synchronisation on contacts, subscribers, orders, wishlists, reviews, quotes and catalog.

mag_manually_run_sync.png

Refresh customers (under 'Reset Sync Options')

Clicking Run Now will refresh all of the customer data stored in dotmailer that you've already imported from Magento, marking it all for import again and ensuring it's up to date.

mag_refresh_customers.png

Refresh subscribers

Clicking Run Now will ensure your subscribers to your Magento site are refreshed and added to your contacts, ensuring they are marked for import and will be included in the next scheduled sync.

mag_refresh_subscribers.png

FAQs

When I manually run a contact sync it's fine but when the cron runs nothing happens. Why is this?

The server user you use when manually running a sync is typically different to the user cron uses. If this is happening it is likely the cron user doesn't have the correct permissions on the /var/email/export folder.

When I manually run a contact sync I get an error about permissions. How come?

This normally happens when the var/export/email folder does not have the correct permissions to write and read the files the connector produces. To test whether this is the case, set the folder and subfolders as 0777 and run the sync again. You should see a sync success message.

Please comment underneath with any further questions you may have.

Magento 2.0

The above also applies for Magento 2.0, with the only difference being that the 'Configuration' and 'Developer' sections are found by going to Stores > Configuration > DOTMAILER > Configuration and StoresConfiguration > DOTMAILER > Developer.

Have more questions? Submit a request

Comments