Blueshift Integration

Easily Integrate Your Blueshift Account for Marketing Automation

A Running Enthusiast avatar
Written by A Running Enthusiast
Updated over a week ago

This guide walks through enabling Blueshift tracking for customer, product, and order data. Adding and configuring this integration is simple.

What is Blueshift?

Blueshift combines the Power of a Customer Data Platform & Marketing Automation for personalized experiences for your customers.

How Run Free's Blueshift Integration Works

When enabled, Run Free's Advanced Blueshift integration pushes customer, product, activity, and order data from the Run Free Project platform to your Blueshift account. Run Free will send these events once a customer's identity has been registered. Customer identity is registered automatically in the following ways:

  • By signing up for a new account in your Run Free e-commerce store

  • By signing into their existing account in your Run Free e-commerce store

  • By filling and submitting a Blueshift-generated form

  • By clicking on URLs in emails from your Blueshift campaigns

When customer identity is registered, the following events are sent from Run Free to Blueshift:


event // purchase, cancel etc
products // array of line items
sku // product id
source // Run Free

Data from on-site event triggers and the optional product catalog integration gives you, or your marketing agency the ability to use Blueshift's pre-built workflows. Plus, a whole lot more.

Let's get started.

How to Integrate Your Blueshift Account

In the Run Free Platform, Navigate to Settings > Integrations. Select Blueshift from the tabs on the left-hand side of the screen. Toggling the integration 'On' will reveal three key pieces of information you'll need to configure your Blueshift account.

The first two are your Event and User Access Tokens, needed to send customer shopping activity to Blueshift.

The third is your store's Catalog Feed URL which you can (optionally) use to import your store's products directly into Blueshift for customer recommendations.

Keeping this window open makes it easy to access and paste in future steps.

Retrieving your Blueshift Access Tokens

Log in to your Blueshift account. You can obtain the following API keys, based on your role, from the API keys tab of your Account Settings in the Blueshift app.

Copy and paste the Event API Key and User API Key into the fields on your Run Free Integrations page and tap save.

Congratulations! 🥳 Your user and order events will now automatically push to Blueshift.

Setting up the Blueshift Product and Catalog Feeds

Create a product feed in Blueshift in order to use product recommendations in your messaging. Product feeds take in data from your product catalog and customer behavior (e.g., the products they’ve viewed or purchased in the past) and use this information to provide custom product recommendations for your customers and prospects.

To get started, navigate to the catalog page in Blueshift and tap + Catalog to launch a wizard with two select source sections. Select 'Upload via HTTP URL'.

The next step will ask you to name the Catalog Feed. You can enter anything here you like and tap ok.

Next, we'll be configuring the source for the catalog. In the Enter URL field, copy and paste your store's feed URL listed on the Blueshift section of your Run Free Platform Integrations page, then tap Continue.

The next section is for File Settings will auto-fill, analyze your feed and select JSON and the language type. Nothing to do here, just tap Continue.

Next, we'll verify the configuration section of the feed. Blueshift will automatically map the attributes of your feed to their destination attributes. Just below the fields section, you'll see a section called Map Item Category. Select 'Split a Field' from the two radio options. Then be sure the Category is chosen from the Item Category Dropdown. With ',' as the Category separator. Ignore the item tags section and tap Continue.

The final section is for scheduling how often the feed is updated from the platform. Check Is it a recurring data import?, and select Daily from the Task Executes dropdown.

Note: Please do not choose a frequency more often than once a day. Doing so will put too much load on the server and could slow down your site.

That's it. Tap Save, and then Launch in the upper right of the screen to complete the catalog setup.

You will now see your feed listed on the Catalogs List page, where you can edit it at any time.

For troubleshooting or more information on setting up workflows or other automation, please refer to Blueshift's Documentation Library.

Did this answer your question?