Shopware connector - Installation and setup

Contents

Installing the Shopware connector
Working with your Shopware store settings
   » Connected store
   » Contacts
   » Automation
   » Store access
How order and product synchronisation works
Working with your field mapping settings

Summary

The Shopware connector enables you to synchronise all of your Shopware customers to dotmailer. You can choose which of your Shopware data fields get mapped to your dotmailer contact data fields, allowing you to synchronise your customers' order histories and use it for better campaign targeting. You can also enrol new customers, new subscribers and abandoned baskets into your programs.

Firstly, and before you can get going with any of the above, you'll need to install the connector.

Installing the Shopware connector

The Shopware connector needs our plugin installed, and then a bridge file needs to be downloaded from dotmailer and added to your store's root directory to complete the connection.

Follow these steps:

  1. Go to the dotmailer App Directory (https://apps.dotmailer.com/Shopware/) or Shopware and download the plugin
  2. Log into your Shopware backend
  3. Go to Configuration > Plugin Manager
  4. Under 'Management' to the left, select Installed and click on + Upload plugin
  5. In the window that appears, click Select to choose your downloaded zip and then click Upload pluginshopware_upload_plugin.png
  6. Click Activate
  7. Go to Marketing and click on dotmailer Email Marketing
    shopware_dotmailer_email_marketing.png
  8. dotmailer will be opened in a new browser window
  9. Log into dotmailer
  10. You'll see the 'Almost there!' message, outlining the three final steps to complete:
    • Download the bridge zip file
    • Copy and unzip the bridge file into your Shopware root folder
    • Click on 'Test connection' to check all's well
      commerce_flow_bridge_file_steps.png

A message will confirm a successful connection, and your store data will begin syncing very soon.

commerce_flow_successfully_connected.png

Otherwise, you'll be informed of a problem in connecting. In this case, you'll need to go back over the steps to make sure everything was done correctly.

commerce_flow_unable_to_connect.png

Working with your Shopware store settings

Once you've successfully installed the connector, you can start working with your general Shopware connector settings in dotmailer. They're accessed by clicking on Shopware in the settings menu.

settings_shopware.png

This takes you to the 'Store' tab, where you can access data synchronisation, contact synchronisation and program enrolment settings. You can also remove your Shopware connection completely if you wish.

Remember to click Save after making any changes here.

shopware_store_tab.png

Let's go through the sections.

Connected store

Store name: Your store's name is confirmed here.

Store URL: The URL for your store is confirmed here. Click on it if you want to open it in a new browser.

Data sync: Syncs take place every 5 minutes. If something has changed with one of your Shopware customers, such as they've unsubscribed from your store, then it will only be a matter of minutes until this is reflected in dotmailer.

You're able to turn data syncing On or Off, should you need to. You can also force an unscheduled sync by clicking Sync now.

Last sync: The date and time of the last sync is provided here.

shopware_connected_store.png

Contacts

Sync customers to: A dropdown allows you to choose the dotmailer address book you'd like to sync your Shopware customers to. Alternatively, you don't have to choose an address book and your customers won't get synced at all.

Any contacts in Shopware will, by default, get synced into the 'Store customers' address book. Note that these can be guests, prospects, subscribers, and first-time buyers or returning customers.

Sync subscribers to: This operates in a similar way as above.

The system prevents you from being able to sync customers and subscribers to the same address book, ensuring that they always remain separate.

Only contacts who are subscribers get synced into 'Store subscribers'. That is, only contacts who have opted in to receive your marketing emails when creating an account, or while checking out in your store, will be synced here.

Please only send to subscribers

Some of your customers may not have explicitly opted into your marketing emails when purchasing in your store. Please make sure that you only send campaigns to the 'Store subscribers' address book. These are the contacts you have permission to send to, and, in turn, you'll be ensuring you're adhering to international email spam laws, upkeeping best email marketing practice, and maintaining a good sending reputation.

woocommerce_contacts.png

Automation

Enrol new customers to: A dropdown allows you to choose the dotmailer program you'd like to enrol new Shopware customers into.

Enrol new subscribers to: Similarly, a dropdown allows you to choose the dotmailer program you'd like to enrol new Shopware subscribers into.

Enrol customers on their first order to: A dropdown allows you to choose the dotmailer program you'd like to enrol your Shopware customers to as soon as they place their first order. Please be aware that this may include customers who aren't subscribed, therefore you should always check whether they also belong to your subscribers group if you intend to send them marketing emails (please see above - 'Please only send to subscribers').

shopware_automation.png

Store access

Click on Remove Shopware connection to disable the connector and remove the integration with immediate effect.

shopware_store_access.png

How order and product synchronisation works

Automatic synchronisation of your Shopware customers' order histories and of your Shopware product catalogue requires Insight data and AccountInsight to be enabled on your account respectively. Speak to your account manager if you'd like to enable these.

Order synchronisation

Your Shopware customers' order histories will automatically synchronise upon installation. This data gets synced to your account's Insight data collections for contacts. You'll then be able to segment upon contact order data and target your customers more effectively.

Product synchronisation

All of your visible products in Shopware will also automatically synchronise upon installation. This data gets synced to your AccountInsight 'Catalog_Default' collection. You'll then be able to make use of EasyEditor's product block.

Working with your field mapping settings

Clicking on the Field mapping tab will enable you to map the Shopware customer fields of your choice to corresponding dotmailer contact data fields.

The customer fields for Shopware are (with data types in parentheses):

  • First name (text)
  • Last name (text)
  • Created date (date)
  • Billing address 1 (text)
  • Billing address 2 (text)
  • Billing phone (text)
  • Billing fax (text)
  • Billing city (text)
  • Billing postcode (text)
  • Billing state (text)
  • Billing region (text)
  • Billing country (text)
  • Billing company (text)
  • Shipping address 1 (text)
  • Shipping address 2 (text)
  • Shipping phone (text)
  • Shipping fax (text)
  • Shipping city (text)
  • Shipping postcode (text)
  • Shipping state (text)
  • Shipping region (text)
  • Shipping country (text)
  • Shipping company (text)

Click on the dropdown next to the Shopware customer field and select the dotmailer contact data field that you wish to map and sync to.

shopware_select_field_mapping.png

dotmailer's default contact data fields are automatically mapped to their equivalent Shopware customer field for you.

It's up to you which Shopware customer fields that you wish to synchronise. Leave them unmapped if you don't wish to sync that specific data to dotmailer.

Click Save once you're happy with your mapping settings and begin syncing to these dotmailer contact data fields.

If you no longer wish to sync data from a Shopware customer field, you can simply deselect the mapping here and click Save to update your mapping settings. The next time a sync runs, your Shopware data will no longer sync to this dotmailer contact data field.

Have more questions? Submit a request

Comments