If you run an e-commerce store with Shopify, you can use our Shopify app to integrate our platform with it. We will then get data from your store and you can use our platform to run campaigns for your users.  Our Shopify app makes it easy and seamless for you to integrate your store with our platform, and the integration requires almost no input from your developers. 

Here's how to deploy the Blueshift app into your Shopify store:

  1. Sign in to your Shopify admin. 
  2. After you sign in, click Apps in the left menu. 
  3. On the Apps page, click Manage private apps.
  4. On the Private apps page, click Create a new private app
  5. On the Create private app page:
    1. Specify Blueshift in the Private app name field and your email address in the Emergency developer email address field of the App details section.
    2. Choose the following settings in the Admin API section:
      • Read access for Store content like articles, blogs, comments, pages, and redirects field
      • Read and write for Customer details and customer groups field
      • Read access for Orders, transactions and fulfillments field
      • Read access for Products, variants and collections field
      • Read access for Fulfillment services field
      • 2020-10 for Webhook API version field
    3. Click Save.
  6. In the Create a new private app dialog that appears, click I understand, create the app. You are redirected to the app page. 
  7. On the Blueshift private app page, copy the values of the following fields:
    • API key
    • Password
    • Shared Secret

  8. After you copy these values from the private app that you created in your Shopify store, sign in to the Blueshift app and perform the following steps.
  9. Click on the gear icon (settings button) on the top right corner of the page > Integrationssetup_integrations.png
  10. On the Setup Integrations page, select Shopify under eCommerce
  11. On the Shopify page, click Add Shopify Store.
  12. On the Add Shopify Store page that appears, provide the following information:
    (Click to enlarge)

    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 API password that you copied in step 7.
    Shared secret Provide the shared secret key that you copied in step 7. 
    Synchronization Date 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 user has unsubscribed to marketing communications sent from our platform, to the user'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:

    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.

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

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. 

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.