This is not an integration with Shopify Email.
You want to connect your Shopify Custom App with the Retention.com app to start using Grow and/or Reclaim.
By following this guide, Retention.com’s scripts will be installed to your Shopify store.
The Collection Script identifies new contacts landing on your Shopify store, also referred to as Grow contacts from Retention.com.
The Revenue Tracking Script tracks revenue generated from purchases made by Grow contacts.
The Viewed Product and Add to Cart Scripts improve the identification of shoppers who abandon products and carts.
Your Implementation Manager will set up the integration for you during onboarding. For existing customers, please reach out to support[at]retention.com for assistance.
Table of Contents
Prerequisite: Locate and save your Shopify URL.
Step 1: Develop a Retention App in your Shopify account.
Step 2: Sync your Shopify account with your Retention.com app.
Steps to uninstall the Shopify integration.
Prerequisite: Locate and Save your Shopify URL
Before you begin, locate and save your Shopify URL. You'll need this URL handy to successfully complete the upcoming steps.
To find you Shopify URL:
Navigate to the Stores option in the left-hand menu of your Shopify Account.
Copy your Shopify URL and store to use later.
Note: Shopify URL is NOT your website URL. The Shopify URL path includes “.myshopify.com”.
Step 1: Develop a Retention App in Your Shopify Account
1. In your Shopify account locate the develop apps section.
Navigate to Settings from the bottom left sidebar.
Select Apps and sales channels from the left-hand menu.
Click on Develop apps in the top right corner.
2. Create the “Retention.com Script Manger” App
Click on the button Create an app.
In the pop-up, name the App “Retention.com Script Management” and click on Create app.
3. Set permissions for the “Retention.com Script Management” App in Shopify.
In the tab Overview, select Configure Admin API scopes.
From the Admin API Access Scopes:
Locate Orders and check the box next to read_orders.
Locate Script Tags and check the box next to write_script_tags, and read_script_tags.
Locate Customers and check the box next to write_customers and read_customers.
Locate Products and check the box next to read_products.
Save.
In the tab Overview, select Configure Admin API scopes.
Locate Script Tags and check the box next to write_script_tags, and read_script_tags.
Locate Customers and check the box next to write_customers and read_customers.
Locate Products and check the box next to read_products.
5. Install Retention.com Script Manager on your Shopify Store.
Select Install App in the top right corner.
From the pop-up, select Install.
Step 2: Sync Shopify with your Retention App
Prerequisite: Locate and copy your Admin API access token.
⚠️This token can only be viewed/copied once, so be sure to save it somewhere safe.
In App development, select the app Retention.com Script Management
Tab to the API credentials.
Click Reveal token once and copy the Access Token.
1. Locate the Shopify Integration App in Retention.com App.
Select Integrations from the left navigation panel in Retention.com.
Click on Available Integrations at the top
Locate and click on the Shopify Integration App.
2. Connect to Shopify Integration App
Enter your Shopify Store URL (This is the URL that ends in .myshopify.com)
Enter the Admin API Access Token from your Shopify account
Click Connect.
3. Enable Shopify integration.
The toggle will be set to DISABLE.
Toggle to ENABLE.
Click Finish.
The integration with Shopify is a success when the Shopify Integration toggle is enabled.
For those who have the Collection, Add to Cart, Viewed Product, or Revenue Tracking scripts installed manually in your Shopify theme code, please ensure these are removed before completing the custom integration. This step is crucial to avoid any conflicts and ensure the integration functions smoothly.
Steps to uninstall the Shopify integration.
1. Remove the Shopify integration from the Retention.com App.
Select Integrations from the left navigation bar.
Locate the Shopify integration and tap the three vertical dots (⋮) to open the menu.
Select remove.
2. Locate the “Retention.com Script Management” from your Shopify store.
Navigate to Settings from the bottom left sidebar.
Select Apps and sales channels from the left-hand menu.
Click on Develop apps in the top right corner.From your Shopify store, go to Settings > Apps and sales channels > Develop apps.
3. Remove the “Retention.com Script Management” from your Shopify store.
Select the Retention.com Script Management app you created for the integration.
Click Uninstall app
Confirm action by clicking on Uninstall.
