If the Marketing Automation module is available on magnews, the advanced version of the connector adds new nodes and features to the basic ones to integrate with this tool.
New nodes
There are 4 nodes available in the workflow designer:
- A new event node Magento - New customer
- A new event node Magento - Abandoned cart
- A new action node Magento - Update contact
- A new condition node Magento - Check cart
Magento - New customer (event)
When a new customer from a store view registers on Magento, the contact data is imported using the synchronization configuration of the Magento Connector.
After synchronization, a workflow session is started, respecting the limits set within the workflow itself.
This node enters contacts into the workflow that were created on Magento, regardless of whether they are new to MagNews.
On the first run of the workflow, contacts registered up to 10 minutes prior to the initial run will be retrieved.
New contacts will then be added to the workflow every 10 minutes.
When the workflow is paused and then reactivated:
- If the pause duration exceeds the value configured in the field Retrieve new customers from a maximum of... (minutes):, then contacts added within the defined time range will be retrieved.
- If the pause duration is less than the value configured in the field Retrieve new customers from a maximum of... (minutes):, then contacts added during the pause will be retrieved.
Magento - Abandoned cart (event)
This node brings abandoned carts into the workflow. The time interval after which a cart is considered abandoned can be configured within the node itself (measured in minutes).
A procedure periodically checks for abandoned carts on Magento and triggers an automatic import to the database configured on the platform. To function correctly, this node requires that contact synchronization is configured and enabled, even if periodic sync is not active.
For each imported contact, a new workflow session will be started with the following session variables:
-
mage.cart.id
Magento cart ID -
mage.cart.updated_at
Most recent date a product was added to the cart -
mage.cart.productCount
Number of products in the cart -
mage.cart.productQuantity
Quantity of products in the cart -
mage.cart.grandTotal
Total cart value -
mage.cart.subTotal
Subtotal value
These variables can be used throughout the session, for example in a Contact Test node, by including them in expressions to be evaluated.
On the first run of the workflow, all carts since the previous midnight will be retrieved.
Subsequently, abandoned carts will be checked and retrieved every 20 minutes.
If the workflow is paused:
- If the pause duration is greater than the value configured in the field Retrieve abandoned carts from a maximum of... minutes, contacts added within that time frame will be retrieved.
- If the pause duration is less than the configured value, contacts added during the pause will be retrieved.
If a contact frequently updates their abandoned cart, multiple workflow sessions related to the same cart may be created within a short time frame.
To prevent this, set entry limits on the workflow so a contact can only start a session a certain number of times within the defined time period.
Magento - Update contact (action)
This node updates contact data previously imported from the Magento Connector using the synchronization configuration:
The possible outcomes are Success or Failure, depending on whether any errors occurred during the synchronization.
If the contact is linked to a newsletter subscription without an associated customer, the contact will not be updated.
Magento - Check cart (condition)
This node should always be used in combination with the Abandoned cart (Workflow) node and routes workflow sessions to four outputs by comparing the current cart status to when it entered the workflow.
The four possible outputs are:
- Abandoned: The cart was neither purchased nor modified.
- Updated: The cart is still abandoned but has changed since entering (products, quantity, etc.).
- Purchased: The cart was converted into an actual order.
- Deleted: The cart is no longer active.
Magento cart data is never updated during the lifecycle of the workflow session.
This node only compares the current cart state to the initial entry state.
How to test the workflow
To test a workflow, from the manual synchronization page for contacts, click the Test Workflow
button.
In the window that appears, enter the email of a contact already imported into the platform who has an available abandoned cart, then click Search Carts
.
A panel will appear showing all the details of the contact’s abandoned cart(s).
The Enter node
menu allows you to choose the entry node and the corresponding workflow.
Once selected, click the Start test session
button to enroll the contact in the workflow and analyze all its steps.