This article explains how to integrate your Shopify store with JMango360: installing the JMango360 apps, giving us access to your store backend, and the information we need to validate your app. It also covers the optional App Exclusive Promotions setup for stores on Shopify Plus.
Setup checklist
| Task | Needed? | Section |
|---|---|---|
| Install JMango360 Mobile App Builder | Required | 2.1 |
| Install the Headless app | Only if you use one-time login codes | 2.2 |
| Set up JMango360 App Promotions | Optional, Shopify Plus only | 2.3 |
| Add support@jmango360.com as staff | Required | 3 |
| Share coupon codes and customer group information, assign products to the sales channel | Required (customer groups only if you use them) | 4 |
One of the core functionalities of the JMango360 offering is the in-depth and seamless integration with Shopify. The mobile app fetches data directly from the Shopify admin and interacts with Shopify via the API.
The following information is fetched from Shopify:
Here are some key benefits that you, as a merchant, can gain from the integration with Shopify:
In addition, the integration is also beneficial to your customers. The shopping session between the website and the app will be aligned, ensuring a seamless experience for customers. They can enjoy a consistent and seamless shopping journey between the website and the app.
Depending on the features you use, one to three JMango360 apps are installed in your Shopify admin.
Step 1: Open JMango360 Mobile App Builder via this link and login to your Shopify Account
Step 2: On the app page, click Install.
Step 3: In your Shopify admin, to authorize the use of the app, click Install.
Step 4: Once the app is installed, you can view and use it from the Apps page in your Shopify admin.
If you choose the customer account set up with a one-time login code in the Shopify backend, you need to install the Headless app. After installing, please share the required store access (admin or collaborator) with the JMango360 team. This access will allow us to complete the integration of the Login with Code feature into your app.
App Exclusive Promotions let you offer discounts that only your mobile app users can get, giving shoppers a reason to download, keep and buy through your app. The discounts run on Shopify Functions through a custom app, JMango360 App Promotions, which the JMango360 team deploys into your store.
Step 1: Create an empty app in the Shopify Developer Dashboard
Step 2: Create the deploy token (service account)
Shopify now creates the deploy token through a service account in your organization. The token only allows us to deploy to the app you choose. It cannot access anything else in your store. Log in with an account that can manage apps (the store owner always can).
Renewing the token: the token expires after 6 months. Go to Settings → Users → Security in your Shopify admin, click the JMango360 deploy service account, click Rotate, and send us the new token.
Step 3: Share your details with us securely
Send us these three details:
Step 4: Install the app after we confirm the deployment
Our team deploys the code into your app; no action is needed from you in the meantime. Once we confirm the deployment is complete:
Shopify shows the message "This app is not listed in the Shopify App Store". This is expected, as it is a custom app built only for your store.
Step 5: Create your App Exclusive Discount
Step 6: Update your mobile app
A new build of your mobile app is needed for the promotion to work. The new version adds a cart attribute (jmango-mobile-app) to every shopping cart, which Shopify Functions check to unlock the app-only discount. Users on older app versions can't see or use the discount until they update.
Your website's backend access is required in order for us to do your app's integration. Please provide us with access to some administration areas of your website backend. Please be well noted that we require no access to anything related to the sales of your website. While testing the app, we assume that our test orders work well once we receive order confirmation emails.
Please add email support@jmango360.com as a collaborator and assign a custom set of permissions to it.
Step 1: Log in to the Shopify backend. Click on the Settings button at the bottom left to open the Settings window:
Step 2: On the menu side, choose Users and permissions. Then click on the button Add staff.
Step 3: Provide information as required. Make sure the Email address is set to support@jmango360.com.
Step 4: Select the permissions as shown below.
Step 5: Click Send invite to send the invitation. JMango360 will receive an email shortly after creating the account asking us to confirm our email address and create a password.
Additionally, you should grant access to specific Storefront API scopes if you are using app extensions on your Shopify store and want their functionality available in the mobile app.
Follow these steps:
Coupon codes are needed for the checkout process and testing purposes during the app development process, so you are expected to provide us with your coupon codes. With the coupon codes shared, we can conduct thorough testing and verification of the coupon-related features and ensure that the coupon codes are functioning correctly and delivering the intended outcomes.
Step 1: In the Shopify backend, create a coupon code for 20% discount.
Step 2: Share the coupon code with support@jmango360.com.
If you set up App Exclusive Promotions (section 2.3), please also share one app-only discount so we can test it in the new app build.
If you're using customer groups in Shopify and want to have this supported in the app we need to have information about the user group logic and access to each user group to complete our analysis and testing processes.
Step 1: Confirm if you're using Customer Groups. If yes, share information about your user groups, logic and rules.
Step 2: Use the following email addresses to add JMango360 to each user group:
To ensure that your products and collections appear in your mobile app, they must be assigned to the JMango360 Mobile App Builder sales channel. This step is essential for syncing product data between your e-commerce store and the mobile app.
Follow the steps below to update product visibility in bulk:
If you have any further questions regarding the app builder, we're happy to help! Please reach out to us at customer.success@jmango360.com.