If you run an e-commerce store with Shopify, you can use the Blueshift Shopify App to integrate with the Shopify platform. Blueshift then retrieves data from your store, allowing you to utilize the Blueshift platform to run targeted campaigns for your customers. The Blueshift Shopify app makes it easy and seamless for you to integrate your store with the Blueshift platform, requiring minimal 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.

Regional availability

The Blueshift app on the Shopify store is currently available only for Blueshift accounts in the US region. For accounts in the EU region, we recommend connecting your Shopify store using a custom app.

Events collected by the blueshift-shopify app

Login activities	Login Logout
Views	Page views Product views
Cart activities	Cart create Cart update
Checkout 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

Search for the Blueshift app on the Shopify app store
Click Install
Review the permissions and proceed with installing the app
Once you click install, you will be redirected to the Shopify adapter setup page in the Blueshift App Hub. You will have to log into your Blueshift account if you are not already logged in
On the Authorisation section, verify the Shopify Store URL and click next
Synchronization settings will open up. Follow the instructions and description in the table below to configure the adapter
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 be redirected directly to your theme customization page on Shopify.
Turn on the Blueshift App embed block and save the changes
Save the adapter in Blueshift. You should see the Orders, Products, and Customer data status getting synced from Shopify to Blueshift.

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 data from the last three months. If you want to synchronize data older than three months, request that Shopify enable API access to the older data.
Update the 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 from 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 & 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 titles 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 any of these settings are turned on, inventory will be displayed as available at all times.

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 information needed 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 specific 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:

Sign in to your Shopify store admin.
Click Apps in the left menu.
On the Apps page, click Develop Apps. The apps for that store are displayed.
Click Create an app.
Specify the App Name as Blueshift and add your email address in the App developer field. The Blueshift app has been created.
Go to the Configuration tab and click Configure to set up the Admin API integration.
Grant the following Admin API access scopes permissions.
For Webhook subscriptions, select 2024-07.
Click Save.
Click Install App.
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

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

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:

Sign in to the Blueshift app and click App Hub in the left navigation menu.
Go to All Apps, search for, and select Shopify.
You can also go to Advertising Apps and select Shopify.
Click "Configure" to view all configured adapters.
Click +ADAPTER to add an adapter.
Add a Name for the adapter. If you have multiple adapters, the name of the adapter helps you identify the integration.
Provide the following details for Authorization and click Next.
Provide the following details for the Synchronization Settings.
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.
- Copy the script and then navigate back to the Shopify admin.
- On the Shopify admin page, click Online Store in the left navigation bar.
- On the Themes page, click Actions > Edit code.
- In the theme.liquid file, paste the script before the head tag closes (</head>).
- Click Save.

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 data from the last three months. If you want to synchronize data older than three months, request that Shopify enable API access to the older data.
Update the 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 from your Shopify store. You can also create a new catalog.
Map category & 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 then "Bottomwear" in that order. This means you would choose Apparel first, followed by Bottomwear in the Select Headers menu. This way, a pair of trousers in your store is categorized under 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 trousers under Apparel and then further under 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 categorize products based on the collections in which they are present. When configuring 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 titles of the collections to which that product belongs. Note: Blueshift honors Shopify’s Do Not Track and continues selling after out-of-stock inventory settings are met. If one of these settings is enabled, inventory will be displayed as available at all times.

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.

Shopify – E-Commerce