Shopify

Prerequisites

• Active Engage and Shopify accounts.

• Shopify Plus is required to stop Shopify messages and replace them with Engage messages.

• If you are not already using Shopify with Intelligence, install the Mapp Cloud app from the Shopify App Store.

You can only "stop" the Shopify messages and replace them with Engage messages if you have Shopify plus

The Shopify help page has more information about finding applications. To set this up, select the Engage tab. 

Data Flow

The following webhooks handle data flow between Shopify and Mapp Engage:

• CUSTOMERS_CREATE, CUSTOMERS_UPDATE, CUSTOMERS_DELETE

• PRODUCTS_CREATE, PRODUCTS_UPDATE

• ORDERS_CREATE, ORDERS_FULFILLED, ORDERS_CANCELLED, ORDERS_DELETE

• REFUNDS_CREATE

• ORDERS_EDITED

For products with up to 2000 variants, data is fetched in increments:

• The initial 100 variants are processed first.

• Subsequent requests handle 250 variants at a time while respecting API limits.

Procedure

A) Create Subscriber and Customer Groups for Shopify

Please refer to this article: Create a New Group

B) (Optional) Create prepared messages

You can use Shopify to send updates, confirmations, refunds, and cancellations of orders. See Prepared Messages for information on how to create these. 

C) Create a new integration in Mapp Connect

1. In the main navigation, click Data Management > Mapp Connect.

2. Click Add New Integration.

3. In the Create new integration window, select Type: Shopify. Provide the Name and Description (optional).

4. Click Create.

5. Make sure to note your Integration ID and Secret. You will need to add these to Shopify.

6. Also, set up mapping with your new groups and messages. 

More information about Mapp Connect integrations can be found here: Integration Setup.

D) Set Up Shopify

1. In the Shopify admin page, go to the Apps section and click Add apps.

2. Click Shopify App Store and search for Mapp Cloud.

3. Open the Mapp Cloud app and click Add app.

4. Click Install app.

5. Select Engage from the menu on the left.
    

6. Add your Cluster and domain.

7. Next, add the integration ID and Secret. 
    

8. Select Save. Now, other fields will become visible.

9. Add in your SFTP information. 
    

10. Under "Other Configurations", you can select if you want your users to confirm their subscription or use the abandoned cart function.
     

11. Under "Mapp Engage Group Configuration", choose groups where customers and subscribers will be added.

12. If you want emails sent from Mapp Engage, go to the "Message Configuration" section and select prepared messages for the given scenarios.

    You must manually turn off emails in Shopify settings to avoid duplicate emails. This is only possible if you have Shopify Plus. 

13. Select Save.

If the primary domain of your Shopify store ever changes, or if you add or remove market regions, please come to these Mapp Engage settings and click the "Save" button. The domain name is stored in the session. By saving again, you will reset it to the current value. Otherwise, your product URLs will have the old domain.

E) Initial import

You must set up this one-time job to connect Engage and Shopify. First, go to Data Management > Mapp Connect.

1. Find the integration you created and click on Edit.

2. Select Import Configuration.

3. Add new import job.

4. Enter a job name.

5. Define the job run (set at least 1 hour after the current time) and click on Apply.

   

6. Set job status to enabled.

7. To configure the import, choose FTP and click on Test Connection in the Import from FTP/SFTP section.
   

8. A green check icon indicates that the connection is successful. 

9. Create an appropriate event. You can use the following: 

   1. Add users to the group (initial import of customers)

   2. Add new Transactions Data

   3. Add new Product Data

      Please note that importing product categories via our Mapp Connect Shopify Plugin is currently impossible.

      

10. Add monitoring users by entering the email address of the person responsible for monitoring jobs. After you save this, the monitor will have an overview of the jobs.

11. Click Save.

For more general information about this tab, please see Set Up Data Imports.

Unsubscribe Behavior

• When a user unsubscribes via Shopify, this information is included in every future user update.

• Important: This functionality only works if the user unsubscribes via Shopify. The plugin does not recognize unsubscribe actions made directly in Engage.

• If a user unsubscribes through Engage (e.g., using Engage unsubscribe links), Shopify will not be updated. Future user updates in Shopify may re-add the user to the subscriber group.

Additional Information

1. Data Sources
   Key data like customer details, orders, and products are captured through webhooks and mapped as follows:

   • Customer: Includes id, email, first_name, last_name, phone, currency, and subscription status.

   • Order: Includes orderId, orderTotal, shippingAddress, and other key order details.

   • Product: Captures productName, productSKU, stockTotal, and descriptions.

2. Exports
   Shopify’s Bulk API creates export jobs, and webhook notifications handle data delivery to an SFTP server.

3. Debugging

   • FTP Errors: Credentials validation occurs before starting exports.

   • Export Issues: Contact Mapp support for unresolved issues.

4. Limitations

   • Abandoned carts only track carts entering checkout for logged-in users.

   • Unsubscribes: Shopify does not recognize unsubscribes from Engage links.