Shopify - E-Commerce

If you run an e-commerce store with Shopify, you can use the Blueshift Shopify App to integrate with the Shopify platform. Blueshift then gets data from your store, and you can use the Blueshift platform to run campaigns for your customers. The Blueshift Shopify app makes it easy and seamless for you to integrate your store with the Blueshift platform, and the integration requires almost no input from your developers.

Blueshift app for Shopify

The Blueshift Shopify App can be found on the Shopify App Store by searching for ‘Blueshift’ or using this link. If you run a Shopify store, you can set up the sync with just one click and a few simple configurations.

Events collected by Blueshift Shopify App

Login activities	Login Logout
Views	Page views Product views
Cart activities	Cart create Cart update
Cart activities	Checkout create Checkout update
Order activities	Order create Order cancel Fulfillment create Fulfillment update Refund create
Customer related activities	Customer create Customer update Customer delete Customer enable Customer disable Customer email subscription status Customer SMS subscription status
Product related activities	Product create Product delete Product update

 

Set up integration with Blueshift

1. Search for the Blueshift app on the Shopify App Store
   
2. Click Install
3. Review the permissions and proceed with installing the app
   
4. Once you click install, you will be redirected to the Shopify adapter setup page in Blueshift App Hub. You will have to log into your Blueshift account if you are not already logged in
5. On the Authorisation section, verify the Shopify Store URL and click next
   
6. Synchronization settings will open up. Follow the instructions and description in the table below to configure the adapter
   
   

   Synchronization Time	Select the date from which you want to synchronize your store’s data with our platform. However, Shopify only provides API access to the last three months’ data. If you want to synchronize data older than three months, ask Shopify to enable API access to the older data.
   Update Shopify profile if a user unsubscribes from marketing	Select Yes if you want us to update the customer’s Shopify profile with information about their unsubscription from marketing communications sent through our platform. Otherwise, select No.
   Catalog	Select a catalog from the list of all catalogs you create on our platform to which you want to add products to your Shopify store. You can also create a new catalog.
   Fetch all images for each product	If your Shopify product catalog has multiple images per product, you can choose to fetch the first one or all images.
   Map Category and Select Headers	This section provides options for Blueshift to categorize products in your store. For example, if you run a fashion store and one of your categories is Apparel, you can use the Select field or Split field options to indicate how your products are categorized under Apparel. In your store, trousers can be categorized as Apparel > Bottomwear > Trousers. If you choose the Select field option and need to categorize trousers, select “Apparel” and “Bottomwear” in that order. This means you would choose “Apparel” first, followed by “Bottomwear” in the Select Headers menu. This way, trousers in your store are categorized under “Apparel” and “Apparel > Bottomwear.” If you choose the Split field option, select a field and specify a separator that separates the values in the field. For example, if the field is product_type and its value is Apparel/Bottomwear, select product_type and specify “/” as the separator. This allows us to categorize trousers under “Apparel” and “Apparel > Bottomwear.” We can also have multiple sub-categories. If the value of product_type is Apparel/Bottomwear/full_length, trousers can be categorized under “Apparel,” “Apparel > Bottomwear,” and “Apparel > Bottomwear > full_length.” You can also use the collections you have created in your Shopify account as the category name in Blueshift. The integration provides an additional option to set product categories based on the collections in which the product is present. When you configure your Shopify store in Blueshift, you will see an option under the map category section. Once you select that option, the categories of a product will be populated by the title of the collections to which that product belongs. Note: Blueshift honors Shopify’s Do not track and Continue selling after out-of-stock inventory settings. This means that if one of these settings is turned on, inventory will be shown as available at all times.

7. Use the Onsite tracking feature to track login and logout activity. This is an optional configuration and is powered by an App embed block that Blueshift directly adds to your Shopify theme.
   
   
   • The status of the App embed block will be shown on the adapter page. You can click the enable Blueshift embed app button to redirect directly to your theme customization page on Shopify.
     
   • Turn on the Blueshift App embed block and Save the changes
8. Save the adapter in Blueshift. You should see the Orders, Products, and Customer data status getting synced from Shopify to Blueshift.
   

The Blueshift app for Shopify requires specific information (such as an image URL) about the products on your store to be sent to the Blueshift platform. If that information is unavailable, the API call that sends the required information to the Blueshift platform fails.

 

Blueshift custom app for Shopify 

If you want more control over what data is synced between Shopify and Blueshift, you can use our legacy integration, which sets up the integration using the Shopify Custom App framework. This method may require knowledge about Shopify webhooks.

Events collected by the Shopify extension

Here is the list of events that the Shopify app collects:

The extension uses the JavaScript snippet (that you insert at the time of setup) to track the following events:

Login activities	Login Logout
Views	Page views Product views
Cart activities	Cart create Cart update

The extension uses webhooks to track the following events:

Cart activities	Checkout create
Order activities	Order create Order cancel Fulfillment create Fulfillment update Refund create
Customer related activities	Customer create Customer update Customer delete Customer enable Customer disable Customer email subscription status Customer SMS subscription status
Product related activities	Product create Product delete Product update

The Blueshift app for Shopify requires certain information (such as an image URL) about the products on your store that it sends to the Blueshift platform. If that information is unavailable, the API call that sends the required information to the Blueshift platform fails.

Prerequisites

Before you can set up integration with Blueshift, you must add the Blueshift app to your Shopify store.

Add the Blueshift app to your Shopify store

To add the Blueshift app to your Shopify store, complete the following steps:

1. Sign in to your Shopify store admin. 
2. Click Apps in the left menu. 
3. On the Apps page, click Develop Apps. The apps for that store are displayed.
4. Click Create an app. 
5. Specify the App Name as Blueshift and add your email address in the App developer field. The Blueshift app is created.
6. Go to the Configuration tab and click Configure to set up the Admin API integration.
7. Grant the following Admin API access scopes permissions.
    

   Store content	View or manage articles, blogs, comments, pages, and redirects (Includes personally identifiable information)	read_content
   Customers	View or manage customers, customer addresses, order history, and customer groups (Includes personally identifiable information)	read_customers
   Orders	View or manage orders, transactions, fulfillments, and abandoned checkouts (Includes personally identifiable information)	read_orders
   Products	View or manage products, variants, and collections	read_products
   Fulfillment services	View or manage fulfillment services (Includes personally identifiable information)	read_fulfillments

8. For Webhook subscriptions, select 2023-10.
9. Click Save.
10. Click Install App.
11. On the Blueshift app Settings page, go to the API Credentials tab and copy the following values. You will need these when you set up the integration with Blueshift.
    • Admin API access token
    • API key
    • API secret key

Set up integration in Blueshift

After you copy these values from the private app that you created in your Shopify store, complete the following steps to set up the integration in Blueshift:

1. Sign in to the Blueshift app and click App Hub in the left navigation menu.
2. Go to All Apps, search for, and select Shopify.
3. You can also go to Advertising Apps and select Shopify.
4. Click Configure to view all the configured adapters.
5. Click +ADAPTER to add an adapter.
6. Add a Name for the adapter. If you have multiple adapters, the name of the adapter helps you identify the integration.
7. Provide the following details for Authorization and click Next.
    

   

   Store URL	Using the URL, specify the name of your Shopify store. For example, if your store’s URL is myshopifystore.myshopify.com, specify my Shopify store here.
   API key	Provide the API key that you copied in step 7.
   API password	Provide the Admin API access token that you copied in step 7.
   Shared secret	Provide the API secret key that you copied in step 7.

8. Provide the following details for the Synchronization Settings.
    

   

   Synchronization Time	Select the date from which you want to synchronize your store’s data with our platform. However, Shopify only provides API access to the last three months’ data. If you want to synchronize data older than three months, ask Shopify to enable API access to the older data.
   Update Shopify profile if a user unsubscribes from marketing	Select Yes if you want us to add information about a customer’s unsubscription from marketing communications sent via our platform to their Shopify profile. Otherwise, select No.
   Catalog	Select a catalog from the list of all catalogs that you create on our platform to which you want to add products to your Shopify store. You can also create a new catalog.
   Map Category and Select Headers	This section provides options for Blueshift to categorize products in your store. For example, if you run a fashion store and one of your categories is Apparel, you can use the Select field or Split field options to indicate how your products are categorized under Apparel. In your store, trousers can be categorized as Apparel > Bottomwear > Trousers. If you choose the Select field option and need to categorize trousers, select Apparel and Bottomwear in that order. This means you would choose Apparel first, followed by Bottomwear in the Select Headers menu. This way, a trouser in your store is categorized under Apparel and Apparel > Bottomwear. If you choose the Split field option, select a field and specify a separator that separates the values of the field. For example, if the field is product_type and its value is Apparel/Bottomwear, select product_type and specify “/” as the separator. We can categorize a trouser under Apparel and Apparel > Bottomwear. We can also have multiple sub-categories here. If the value of product_type is Apparel/Bottomwear/full_length, then we can categorize trousers under Apparel, Apparel > Bottomwear, and Apparel > Bottomwear > full_length. You can also use the collections you have created in your Shopify account as the category name in Blueshift. The integration provides an additional option to set categories of the product based on the collections in which the product is present. When configuring your Shopify store in Blueshift, you see an option under the map category section. Once you select that option, the categories of a product will be populated by the title of the collections to which that product belongs. Note: Blueshift honors Shopify’s Do not track and Continue selling after out-of-stock inventory settings. If one of these settings is turned on, inventory will be shown as available at all times.

9. Copy the script from the JavaScript snippet section and add that script to your Shopify store.

   The app uses this script and webhooks to track events on your Shopify store—those that occur when a customer performs an action on your store—and sends them to our platform.

   1. Copy the script and then navigate back to the Shopify admin. 
   2. On the Shopify admin page, click Online Store in the left navigation bar.
      
   3. On the Themes page, click Actions > Edit code.
   4. In the theme.liquid file, paste the script before the head tag closes (</head>).
   5. Click Save.