Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Current version: v1.9.0

...

The module synchronizes customer data, order data and shopping cart information between Magento and Maileon. Magento is the primary system, which means that the customer information in Magento is considered the main information and changes to that data are synchronized with Magento. Conversely, only certain information is synchronized: the DOI confirmation and unsubscription. For order details and cart abandonments, this information is sent to Maileon as transactions (events) and can be used either to analyze data using contact filters or to activate a trigger mailing. All functions can be set via a configuration panel in Magento.

Install the Module

Below version 1.0.8

The first step is to copy the Maileon directory into the /app/code directory of the Magento installation. If the app directory doesn't already contain a code subdirectory please create it. After this the module must be enabled using the following steps:

...

php bin/magento setup:upgrade

Configuration in Magento

The configuration can be found under “Stores” “Configuration” and, since version 1.8, can be set on Storeview level. This means, that for each Storeview, you can select an own API key, to use different Maileon accounts or you can select different DOI mail keys to send out DOIs in e.g. different languages.

...

Field name

Type

Description

cart.id

string

The cart id (quote id)

cart.date

timestamp

The cart last updated timestamp

cart.items

JSON

Cart items

cart.product_ids

string

Cart items product ids in a list

cart.categories

string

Cart items product category names in a list

cart.total

float

Cart grand total

cart.total_tax

float

Cart tax amount

cart.currency

string

Cart currency

customer.salutation

string

Customer salutation

customer.full_name

string

Customer full name

customer.firstname

string

Customer first name

customer.lastname

string

Customer last name

customer.id

string

Customer id

Configuring Custom Forms

In order to submit other standard or custom data to Maileon, the following scheme must be used:

...

Example: custom_MySpecialField

Enhancing Transactional Data

In some cases, it is required to add custom data transactions. E.g. if you use a plugin, which allows customizing products with names, custom images, etc., and the image shall be displayed in the order confirmation mail, you need to pass this URL to Maileon. Or this case, the plugin provides a simple way to add data to the transactions by overriding class Maileon\SyncPlugin\Helper\External\Data from an external plugin.

...

If everything was installed as expected, the next time e.g. an order is triggered, some additional data should be attached to it.

Webhook Settings in Maileon

Changed parameters in version 1.8:
Since Magento 2.4, an email can be added as newsletter subscriber for each storeview, thus, the email can exist multiple times in the Magento newsletter module. As of version 1.8 of the plugin, configuration is based on storeview level, thus, an email can be added to different Maileon newsletter accounts based on its origin. Thus, when Maileon reports back a DOI confirmation or unsubscription, it needs to identify the correct storeview for a given contact. This is done by adding a new parameter “storeview_id”.

...

The token must match the value given for the DOI Hook Token given in Magento settings.

...

Changelog

2023.06.14 - v 1.9.0

  • Add customer account related transactions

  • Add order related transactions

  • Improve abandoned carts functionality

??? 2023.04.06 - v 1.8.12

  • Bugfix: AfterPlaceOrder product categories

??? 2022.12.06 - v 1.8.11

  • Abandoned cart work with storeviews

??? 2022.10.25 - v 1.8.10

  • Update Maileon Php API client minimum version

...