Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone

Introduction

Overview

The app provides a seamless solution for Shopify store owners and marketers to automate customer communication with ease. By integrating your Shopify store with Maileon, this plugin allows you to effortlessly manage customer engagement without the need for manual intervention.

...

If you do not want DOI process, then disable it in both Shopify and Maileon

shopify-turn-off-doi-1.png

shopify-turn-off-doi-2.png

Sync Order Confirmations

Order details are transferred to Maileon as a contact event for each new order. Two contact event types are used by the plugin:

  • shopify_orders_v3: in this contact event type, the order data is stored in a JSON type field, and the ordered products are stored in a JSON type field.

  • shopify_ordered_products_v1: in this contact event only one of the ordered products is included, so if three products were ordered when the order was placed, three contact events will be created.

If the subscriber is also a customer, the following contact fields will be filled in:

Custom field name

Type

shopify_created

boolean

shopify_total_spent

float

shopify_total_spent_currency

string

shopify_total_orders

integer

shopify_phone

string

shopify_last_order_date

date

shopify_last_order_id

string

shopify_last_skus

string

shopify_orders_v3 contact event type fields

Field name

Type

order.id

string

order.date

timestamp

order.status

string

order.items

JSON

order.product_ids

string

order.product_names

string

order.categories

string

order.subcategories

string

order.brands

string

order.total

float

order.total_no_shipping

float

order.total_tax

float

order.currency

string

order.total_refunds

float

payment.method.id

string

payment.method.name

string

discountpayment.codestatus

string

discount.total

float

discountcustomer.rules_stringfirstname

string

customer.salutationlastname

string

customer.fullnameid

string

customerbilling.address.firstname

string

customerbilling.address.lastname

string

billing.address.salutationregion

string

billing.address.firstnamecity

string

billing.address.lastnamecountry

string

billing.address.phonezip

string

billing.address.regionstreet

string

billingshipping.address.cityfirstname

string

billingshipping.address.countrylastname

string

billingshipping.address.zipregion

string

billingshipping.address.streetcity

string

shipping.address.firstnamecountry

string

shipping.address.lastnamezip

string

shipping.address.salutationstreet

string

shipping.address.phone

string

shipping.address.region

string

shipping.address.city

string

shipping.address.country

string

shipping.address.zip

string

shipping.address.street

string

shipping.service.name

string

shipping.service.tracking.code

string

shipping.service.tracking.url

string

...

.service.name

string

order.items json content

Field name

Type

id

string

name

string

sku

string

total

float

single_price

float

quantity

string

weight

string

gift_card

boolean

description

string

category

string

categories

string

brand

string

image_url

string

url

string

shopify_ordered_products_v1 contact event type fields

Field name

Type

order.id

string

order.date

timestamp

product.sku

string

product.id

string

single_price

float

product.is_gift

boolean

product.title

string

product.description

string

product.url

string

product.image_url

string

categories

string

product.quantity

integer

product.single_price

string

product.total

float

product.categories

string

product.brand

string

product.weight

string

order.total

float

order.currency

string

payment.method.id

string

payment.method.name

string

Send Abandoned cart reminder

If the abandoned cart functionality is enabled in the settings and the duration is set, the abandoned carts will be transferred to Maileon as contact events.
The abandoned carts will be transferred if they are left in the cart by registered users and their email address is not empty.

shopify_abandoned_carts_v3 contact event fields

Field name

Type

cart.id

string

cart.date

timestamp

cart.url

string

cart.items

JSON

cart.product_ids

string

cart.product_names

string

cart.categories

string

cart.subcategories

string

cart.brands

string

cart.total

float

cart.total_tax

float

cart.currency

string

discount.total

float

customer.firstname

string

customer.lastname

string

customer.id

string

cart.items json content

Field name

Type

id

string

title

name

string

sku

string

total

float

single_price

float

quantity

string

weight

string

attributes

string

ean

string

gift_card

boolean

description

string

discount_price

float

category

string

subcategory

categories

string

brand

string

image_url

string

url

string

...

Import all newsletters subscribers

This functionality imports the existing subscribers in Shopify into Maileon.
If a contact already exists in Maileon it will update their details. It will not recreate a contact that has unsubscribed in Maileon.
It will create the contact with the configured permission if it does not already exist in Maileon, if the contact already exists in Maileon it will not change its permission.
It will not start a DOI (Double Opt-in) process, if the permission is set to DOI or DOI+ then the contact will get the set permission without DOI process.

shopify-app-initial-sync.pngImage Added

Import Orders history

You can import previous order details into Maileon as a contact event. A maximum of 1 month's data can be imported at a time. The import will take place in the background.

Please use this feature with care, if you have been using the plugin for a longer period of time and your orders are synchronized with Maileon, you may create duplicates if you re-import the data.

shopify-app-orders-history-import.pngImage Added

Webhook Monitor

This interface allows you to check the webhooks set up and used by the Maileon App.

If you have used an older version (V1 or V2) and switched to the new version (V3), be sure to check if the new webhooks have been created and delete the deprecated webhooks.

If everything is set up correctly you should see these webhooks:

shopify-app-webhooks-monitor.pngImage Added

App Update Process: Upgrading to Version 3

With the release of Version 3, we've made significant improvements, including replacing the old webhooks with new ones to enhance functionality. However, to ensure a smooth transition, the old webhooks will continue to function until January 2025. The new webhooks leverage an updated version of contact events, so it’s important to manually switch to the new version and adjust the corresponding contact events in your trigger emails.

Steps to Update:

  1. Access the Maileon App:
    Log in to your Shopify admin panel and launch the Maileon App that is already installed in your store.

  2. Configure New Settings:
    Within the app, navigate to the Settings section to configure the desired functionality for the new version.

  3. Webhook Monitor:
    Go to the Webhook Monitor to review any deprecated webhooks still in use. If deprecated webhooks are detected, the app will activate a button in the top right corner of the screen. Click this button to remove the old webhooks and prevent any future issues.

shopify-delete-deprecated-webhooks.pngImage Added

Important Deadline:

  • All users still on the older version of the Maileon App must complete the upgrade process by January 1, 2025. After this date, the old webhooks will be decommissioned, and their functionality will no longer be supported.

Avoiding Duplicate Data:

If you continue to use both the old and new webhooks simultaneously, this may result in duplicate entries being created in your Maileon account. To avoid any duplication, ensure that all deprecated webhooks are deleted as part of the upgrade process.

By following these steps, you’ll be able to take full advantage of the new features and ensure that your customer communication remains seamless.