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 users. 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.
Integrating Shopify with Blueshift consists of two steps:
- Deploy the Blueshift app in your Shopify store.
- Set up integration with Blueshift.
To deploy the Blueshift app into your Shopify store, complete the following steps:
- Sign in to your Shopify admin.
- After you sign in, click Apps in the left menu.
- On the Apps page, click Manage private apps.
- On the Private apps page, click Create a new private app.
- On the Create private app page:
- Specify Blueshift in the Private app name field and your email address in the Emergency developer email address field of the App details section.
- Select 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
- Click Save.
- In the Create a new private app dialog that appears, click I understand, create the app. You are redirected to the app page.
- On the Blueshift private app page, copy the values of the following fields:
- API key
- Shared Secret
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 Apps 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 the configured adapters.
- Click +ADAPTER to add an adapter.
- Add a Name for the adapter. If you have multiple adapters, the adapter name helps you to identify the integration.
- 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 API password that you copied in step 7. Shared secret Provide the shared secret key that you copied in step 7.
- 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 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.
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 user performs an action on your store -- and sends them to our platform.
Here is the list of events that the Shopify app collects:
- Login activities
- Page views
- Product views
- Cart activities
- Cart create
- Cart update
- Login activities
- 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
- Cart activities
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.