Shopify App Overview

Sailthru’s Shopify app allows you to quickly integrate Sailthru into your Shopify store workflow.

Features

  • Sync purchase data with Sailthru.
  • Attribute purchases originating from Sailthru email campaigns
  • Send Abandoned Cart emails for incomplete purchases
  • Gather your customers’ product page views, and user interest data using Horizon.
  • Update all of your product information directly into your Sailthru Content library.
  • Add users to Sailthru that make a purchase.

Installation

  1. Install the app.
  2. Connect your Sailthru account.

1. Install the app

Install the app by visiting this urlYou will be asked to provide your Shopify Store URL and you may need to log in to your Shopify account.

Once logged in, confirm that you want to install the app. Recent changes to Shopify’s App Store will show the app as an unlisted app, this is expected.

shopify-install

2. Configure Your Sailthru Settings

Now that the app is installed you can enable the Sailthru JavaScript and add your API keys. Most customers should select Sailthru Script tag from the dropdown. This is the latest version of our JavaScript tag and supports our JavaScript API. New customers should not use Horizon JS as this is legacy code and will be deprecated in the future.

Note: If you are using an external tag manager you can leave the Sailthru Javascript field empty.

  • Sailthru API Key and Secret (available in My Sailthru in Settings > Setup > API & Postbacks)
  • Add your Customer Id, also available in My Sailthru->Settings->Setup->API & Postbacks.

Once installed and configured, the Shopify app will pass all purchase data to Sailthru as it happens.

In order to import your historical purchase data, consult your Sailthru Project Manager or Customer Success Manager. They can advise you on the proper route for importing this data, typically using the Sailthru Job API.

Note: If you use Sailthru’s Allowed IPs feature, you will need a 3rd-party Sailthru API Key to complete Shopify setup. Contact your CSM or Support for assistance.

Content Management

Tags on your content items are required for Sailthru’s Personalization Engine to be able to measure individual user interests. The Shopify app will use your existing Shopify tags to build interest profiles for each user. Tags are managed within Shopify on each product using the Shopify admin. To manage tags for a specific product you can browse to the product page and adjust the “Tags” field.

shopify-tagging

When the product is saved the Content API call is saved and the tags that were applied to the product in Shopify will be visible in your Content Library in Sailthru for that product and used as interest tags. For more information about how interest tags are used see our documentation on Content in Sailthru.

Tags are used for personalization , but can also be used to create/filter a feed for email campaigns and Site Personalization Manager. Please note that tags will be automatically converted to dashed-lowercase-format for consistency.

For example the tag “Vintage Tee Shirt” in Shopify would be converted to “vintage-tee-shirt” in Sailthru so if you are creating feeds or using Zephyr in Sailthru with tags remember to use the Sailthru tags from the Content Library and not your Shopify tags to filter content.

Customer Information in Sailthru

Customer data is automatically imported when you install the app and set your API keys. If you have an existing account and would like the customer import run, contact your CSM or Support. 

When your customers create an account, check out, or are added via automatic customer import Sailthru adds the following fields to profiles for building templates and audiences

Name Description
first_name The customer’s first name.
last_name The customer’s last name.
shopify_tags Tags that have been attached to the customer’s account by the shop owner.  
shopify_state The state of a customer’s account with a shop. Valid states are:

  • disabled: The customer doesn’t have an active account. 
  • invited: The customer has received an email invite to create an account. 
  • enabled: The customer has created an account. 
  • declined: The customer declined the email invitation to create an account.
shopify_created_date The date and time when the customer’s account was created. 
shopify_updated_date The date and time the customer’s account was last updated. 
shopify_note A note about the customer. 
shopify_addresses The ten most recently updated addresses for the customer. 
shopify_phone The customer’s phone number.

Note: If you have multiple Shopify accounts hooked up to one Sailthru account, the user’s profile data will be based on the Shopify store they have most recently engaged with.

Top