Shopify - E-commerce

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 (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 the 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
  • 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 begin

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)	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 2022-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

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 Apps 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 myshopifystore.myshopify.com, 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 us 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.
   Javascript snippet	This section provides a script that you have to add to your Shopify store. Perform the following steps to do this: 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. 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.