Search the Help Center
  1. Spotler Mail+ Help Center
  2. API & Developer
  3. Connectors

Articles in this section

Connecting with Magento 2.3 or higher

The connection between your Magento online store (version 2.3 or higher) and your Spotler Mail+ account is established via Spotler's Connector Platform. You will need to install our plugin in your Magento web shop. The data on the Connector Platform remains within Spotler and is not processed by a third party.

A connection is made on the Connector Platform between the source system (Magento) and the target system (Spotler Mail+ account) for the purpose of exchanging information. This is how it works: 

magento__002_.png

The Connector Platform retrieves data from your Magento store through the Magento connector and sends it to your Mail+ account. The connector retrieves any modified data periodically from Spotler through the Connector Platform and sends it to Magento. By doing so, all systems remain up-to-date.

Requirements for a successful connection

A couple of requirements to ensure the correct functioning of the connection:

  • You are running Magento version 2.3 or higher.
  • You have installed our plugin: https://github.com/SpotlerSoftware/magento2-mailplus-connector. Spotler Mail+ will provide you with an implementation manual for the installation.
  • The following IP-addresses have been whitelisted: 46.31.48.0/21, 213.34.87.217 and 188.204.90.130 .
  • You are not using rate limiters.
  • You are not using useragent filters on the API. The blacklist on useragents is turned off.
  • You are not using a hypernode-environment for our Connector Platform.
  • Spotler Mail+ automatically adds Google Analytics code to product links. Make sure your website structure supports this.
  • For multiple sites in Magento 2, you will need multiple Mail+ accounts (multiple licenses). The triggers for Spotler Mail+ eCommerce campaigns for Magento 2 work with one newsletter permission only. 
  • If you are running a Magento store in multiple languages, they could be interpreted as multiple store views. However, brands or labels should run on separate websites. This has to do with the newsletter opt ins. Magento 2 can only process one newsletter permission for each website.
  • The Magento 2 "base_media_url" cannot redirect to external image hosting for product images. The "base_media_url" should lead to an image directly. 
  • The product image must be an RGB image. CMYK images are not supported.  

Remarks

  • We can only indicate what should be added to Magento to ensure a proper connection with Spotler Mail+. Spotler does not specialise in Magento and will not advise on how Magento should be set up.
  • The longer it will take you to release the Spotler API, the longer it will take up to set up the connection.
  • Spotler Mail+ always sends first and last name data back to Magento whenever a modification has been made to a contact in Mail+. This is a requirement of Magento 2.
  • With newsletter subscribers (guest registrations), only the email address is passed on with the newsletter permission. When it concerns a customer, other fields can also be synchronised to Mail+. For example, names and addresses.
  • There are several ways in Magento 2 to add 'from' and 'to' prices. During implementation, we will discuss which method we will use for our connection.
  • Custom price fields and custom product fields that have been added to Magento 2 through a plugin cannot be used in Spotler Mail+. The connection uses the standard Magento 2 product fields. 
  • Configurable products cannot be used as products in your mailing.
  • New contacts, products, orders and conversion are synced from Magento 2 to Spotler Mail+ every 15 minutes. 
  • Contact modifications in Spotler Mail+ are synced to Magento 2 every 15 minutes as well. 
  • If you are synchronising products only, you cannot use the standard eCommerce campaigns.
  • The abandoned cart campaign is triggered after 240 minutes (4 hours) by default through the Magento 2 connection for contacts with a customer account and newsletter permission. The number of minutes is set up by Spotler. The campaign starts after the set up time + set up sync time (15 minutes by default) of the connection. The exact moment the campaign is triggered varies between 240 and 255 minutes (set up time +15) because of the sync. 
  • Product changes are only processed in the sync when the product has gotten a date of revision in Magento 2 (updated_at date). 
  • You can see double products in Spotler Mail+ if there are multiple store views on one website in the web shop. Double the number of products are synced to Mail+ because of this. In Spotler's Storesync (settings > integrations > products) you can recognise this from the prefix that is added by the connector to product ID's 1- or 2- (language versions). productId 1-123456 for example. 
  • You can review order conversions in Spotler Mail+ mailing statistics. For this to function properly we are dependent upon the way Magento has been setup and the settings of the order statuses on the Connector Platform.
  • Conversion in set up in mailing reports if a purchase is made in your web shop directly from a mailing. 
  • Updating your Magento version or updating/installing any Magento plugins could affect your Mail+ connection.
  • The connection will be tested by you (potentially with a Magento partner). We will provide you with a testing plan for this purpose.