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

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

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:

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

CUSTOMER
​email
firstname
lastname
address
address_city
address_state
address_postal_code
phone_number

ORDER
​event // purchase, cancel etc
email
order_id
total
discount
coupon_code
products // array of line items
sku // product id
price
quantity
discount
subtotal
shipping
tax
timestamp
store_id
source // Run Free
title
brand
image
web_link
size
width
color
price
category

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.

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.

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.

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.