๐Ÿ“˜

Shopify is official partner of Channel.io - only takes a few minutes to install Channel.io to your web site!

This guide will show you how to install "Channel.io" using the app store operated by Shopify.

Install Channel.io

  1. Search for Channel.io on the App Store or go to this link and click Add app to Install.
1471
  1. Click Install app.
963 1497
  1. To use channel.io, you must create a channel.io account and your channel. This is a separate account from the Shopify admin account)
  • If you already have a channel.io account, please log in instead of signing up for a new account.

  1. After signing up, proceed to the next step. This page is shown to ask for your permission on the terms and conditions. Please review and tick the check marks, then click Sign Up.
1651
  1. To link with your Shopify website, you need to create a channel. A channel is your workspace that manages all your customer inquiries and communicates with your teammates. Enter the business information that you want to display.
1317

  1. The channel has been created. Let's move on to the next step!
1321
  1. Set a period to accumulate purchase data, and utilize recent purchase amounts and counts in customer profiles based on data collected during this period.

๐Ÿ“˜

If you change the accumulation period midway, data will need to be re-accumulated from the beginning, and you'll have to wait again for the accurate data. It's best to keep the period consistent once set.

(e.g.)

  • 3 months โ†’ 4 months: need to wait for 4 months for the accurate data
  • 3 months โ†’ 1 month: need to wait for 3 months for the accurate data
  • The Shopify store currency is set as the default for calculating values related to recent purchases.
  • If the base currency differs from the currency the customer paid in, the exchange rate at the time of payment is used to calculate the recent purchase values.
  • If either the base currency or the payment currency is unsupported, the purchase is excluded from the calculation of recent purchase values.
  • Supported currencies list
  1. If either the base currency or the payment currency is unsupported, the purchase is excluded from the calculation of recent purchase values.When you finish signing up and creating your channel, you have only one more step to do to complete the installation process. Click Let's start! button.
1317
  1. The installation is now complete. If you see the following screen, the installation has been successfully done.
  • Check if the chat button appears on your website, and visit the Channel.io desktop app to set up your chat operation settings.
1304

All chats can be managed through the Channel.io desktop app. You can also check them out through Channel.io mobile app, both available in Android and iOS.


User Profile Data from Shopify

Once you install Channel.io, Channel will start to collect and save customersโ€™ information to your channel database. User profile data will automatically be integrated and stored in Contacts when a member logs in or a new user signs up on the website.

1. User Profile

When you chat with customers via Channel.io, you will be able to see detailed customer information under the Guest Info box on the right side panel of your Inbox. The below table shows the list of customer data from Shopify which allows you to analyze customer data and create segments to send targeted messages to.

Data keyDescriptionRemark
memberIdA unique key to distinguish each customer
extMemberShopify account registration status- True : Member - False : Non-member
nameCustomer's name
firstNameCustomer's first name
lastNameCustomer's last name
emailCustomer's email
mobileNumberCustomer's mobile phone number
cartPriceTotal price of products in the customer's cart
recentPurchaseAmountTotal amount of purchases during accumulation periodDefault set to 3 months
recentPurchaseCountTotal count of purchases during accumulation periodDefault set to 3 months
cartCountTotal number of products in the customer's cart
totalPurchaseAmountCustomer's total purchase amountThis value gets updated when the customer signs-up/logs-in/completes a checkout or purchases
totalPurchaseCountTotal number of products that the customer has purchasedThis value gets updated when the customer signs-up/logs-in/completes a checkout or purchases
lastCheckoutCompletedAtLast time a customer completed a purchaseThe time is updated when the purchase happens after installing Channel.io
tagsTags to categorize customers
unsubscribeEmailUnsubscribe to marketing emails
unsubscribeTextingUnsubscribe to marketing texts
shippingCityCity name collected from the customer's default shipping address
shippingProvinceProvince name collected from the customer's default shipping address
shippingCountryCountry name collected from the customer's default shipping address
shippingZipCodeZip code collected from the customer's default shipping address

2. Event

What is an event? โ†’ https://developers.channel.io/docs/what-is-an-event

The event will help you to track customer behaviors on your website. You may use the event as a trigger to run marketing campaigns.

  • The data under products properties cannot be used for marketing messeging.
Data keyDescriptionEvent properties
SignUpWhen a user signs up- id : Member ID
- name : Member name
ProductViewWhen a user lands on
a product detail page (similar with pageview)
- id : Product ID
- name : Product name
- amount : Product price
CheckoutBeginWhen a member starts the checkout process (not available for non-members)- id : Order ID
- totalAmount : Total amount price to purchase
- products : Product information (product name, quantity, price, product id)
CheckoutCompleteWhen a user reaches to the end of the checkout process- id : Oder ID
- paymentMethods : Payment method to complete this order (e.g. credit card, paypal)
- products : Product information (product name, quantity, price, product id)
- productsSummary : List of product summary (e.g. 1 milk and 7 others)
- totalAmount : Total purchase amount
- shippingAmount : Shipping fee
Purchasewhen a user completes purchase- id : Order ID
- paymentMethods : Payment method to complete this order (e.g. credit card, paypal)
- products : Product information (product name, quantity, price, product id)
- productsSummary : List of product summary (e.g. 1 milk and 7 others)
- totalAmount : Total purchase amount
- shippingAmount : Shipping fee

User data Integration from Shopify to Channel.io

By clicking [Import from Shopify], you can store customer data information from your Shopify website to your channel database.

  • If you have been using Channel.io starting before Oct 28, 2022, user data for the last 60 days will be updated in Contacts including order history and user profile changes. This may cause an increasing MAU.
  • If you install Channel.io after Oct 28, 2022, you will be able to integrate user data from the date you install it.

  • Only the channel owners can import customer data from Shopify.
  • You can import customer data every 30 minutes. The time required to complete import customer data can vary from a few seconds to many hours depending on the number of customer data stored in Shopify.

* List of customer data fields that can be imported by clicking [Import from Shopify] button

  • Customer data key not mentioned in the table will be updated when a user logs in after the integration.
  • You will see the customer's recent order information in your Inbox under order history or when you chat with a member.
Data keyDescriptionRemark
memberIdA unique key to distinguish each customer
nameCustomer's name
firstNameCustomer's first name
lastNameCustomer's last name
emailCustomer's email
mobileNumberCustomer's mobile phone number
totalPurchaseAmountCustomer's total purchase amount
totalPurchaseCountTotal number of products that the customer has purchased
tagsTags to categorize customers
unsubscribeEmailUnsubscribe to marketing emails
unsubscribeTextingUnsubscribe to marketing texts
shippingCityCity name collected from the customer's default shipping address
shippingProvinceProvince name collected from the customer's default shipping address
shippingCountryCountry name collected from the customer's default shipping address
shippingZipCodeZip code collected from the customer's default shipping address

Access Permission Update after 2022.9.28

Please check the access permission for the Channel.io app if you installed it before Sep 28th, 2022. This update allows your channel to collect the most recent user information.

How to check your access permission in Shopify admin panel

  1. Go to Shopify admin panel โ†’ Settings โ†’ Apps and sales channels โ†’ click [Channel.io]
1280
  1. Click [Open app] button โ†’ under the PERMISSION DETAIL part, check if View Products is on the list.
    • If the list already has View Products, the app is up-to-date, the update is not required.
    • If View Products does not exist, please follow the next step.
1123 1748
  1. To update the app, please click [Open app] button โ†’ and click [Update app] button.
734
  1. Once the access permission is updated, you will see VIEW PRODUCTS on the list.
1434

Deleting Channel.io

There are two ways to delete Channel.io, and you can always reinstall the app when you want it back.

  • Select Channel.io from your app list โ†’ you will see the [Uninstall] button. If you click the button, it will remove your channel from your website. Channel.io will still remain in the app list and you can always reinstall it if you want.

  • If you click [Remove] on the app list instead of uninstalling, it will completely remove the Channel.io app and all its user data. Once you finish deleting the app, you should look up Channel.io from the app store if you want to install the app again.