If you run an e-commerce store with Shopify, you can use the Shopify app in Blueshift to integrate with the Blueshift 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.

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
  • 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
  • Fulfilment create
  • Fulfilment 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) of the products on your store that it sends to the Blueshift platform. If that information is not available, the API call that sends the required information to the Blueshift platform fails.


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

Add the Blueshift app in your Shopify store

To add the Blueshift app into 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)



    View or manage customers, customer addresses, order history, and customer groups

    (Includes personally identifiable information)



    View or manage orders, transactions, fulfillments, and abandoned checkouts

    (Includes personally identifiable information)



    View or manage products, variants, and collections


    Fulfillment services

    View or manage fulfillment services

    (Includes personally identifiable information)


  8. For Webhook subscriptions, select 2023-07.
  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 adapter name helps you to identify the integration.
  7. Provide the following details for Authorization and click Next.


    Store URL Specify the name of your Shopify store from the URL. For example, if your store's Shopify URL is, specify myshopifystore 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 provides API access to last three months' data only. If you want to synchronize data that is 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 the information, that a customer has unsubscribed to marketing communications sent from our platform, to the customer's 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 of your Shopify store. You can also create a new catalog. 
    Map Category and Select Headers

    This section provides options to provide Blueshift with the categorization of products on your store.

    For example, if you run a fashion store, and one of your categories is Apparels. You can use the Select field or Split field options to provide how your products are categorized under Apparels. So in your store, trousers can be categorized as Apparels > Bottomwear > Trousers.

    If you choose Select field, and you have to categorize trousers: Select Apparels, and Bottomwear in that order. As in, choose Apparels first, followed by Bottomwear in the Select Headers menu. So a trouser on you store is categorized under Apparels and Apparels > Bottomwear

    If you choose the Split a field option, select a field and specify a separator that separates the values of the field. For example, the field is product_type its value is Apparels/Bottomwear. So choose product_type and then specify / as the separator. We can categorize a trouser product_type under Apparels and Apparels > Bottomwear. We can have multiple sub-categories here, too. If the value of the product_type is Apparels/Bottomwear/full_length, then we can categorize trousers under Apparels, Apparels > Bottomwear, Apparels > Bottomwear > full_length

    You can also use the collections that 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 the collections in which the product is present. When your configure 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.


    Blueshift honors Shopify’s Do not track and Continue selling after out of stock inventory settings. This means the inventory would be shown as available at all the times if one of these settings is turned on.

  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 -- 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.
Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.