---
title: Integrating SiteSpect and Oracle BlueKai
description: SiteSpect integrates with various data management platforms to launch more personalized experiments and use externally defined audiences or segments in data analysis. In addition, SiteSpect allows you
---
[Skip to content](https://doc.sitespect.com/knowledge/integrating-sitespect-and-oracle-bluekai#main-content)
English
Show submenu for translations
- [A/B Testing](https://www.sitespect.com/testing-and-experimentation/)
- [Personalization](https://www.sitespect.com/personalization-targeting/)
- [Recommendations](https://www.sitespect.com/recommendations/)
Open main navigation
Close main navigation
- [A/B Testing](https://www.sitespect.com/testing-and-experimentation/)
- [Personalization](https://www.sitespect.com/personalization-targeting/)
- [Recommendations](https://www.sitespect.com/recommendations/)
- English
Show submenu for translations
How can we help you?
- There are no suggestions because the search field is empty.
1. [Knowledge Base](https://doc.sitespect.com/knowledge?hsLang=en)
2. [Third-Party Integration](https://doc.sitespect.com/knowledge/third-party-integration?hsLang=en)
# Integrating SiteSpect and Oracle BlueKai
SiteSpect integrates with various data management platforms to launch more personalized experiments and use externally defined audiences or segments in data analysis. In addition, SiteSpect allows you to push SiteSpect data to these platforms to improve their visitor profiles and help them discover SiteSpect audiences.
The steps described here tell you how to integrate SiteSpect with Oracle BlueKai. These instructions are intended for a user who has some experience with BlueKai and who has the sufficient permissions to implement code changes on your website.
### Overview
[Oracle BlueKai](https://www.oracle.com/marketingcloud/products/data-management-platform/index.html) is a data management platform that allows marketers to augment customer’s proprietary data, organize customer and audience data, and launch personalized experiences across channels. Integrating BlueKai with SiteSpect allows you to use visitor data stored in BlueKai to build targeted or personalized experiments in SiteSpect and analyze reports with these external segments.
There are multiple ways that SiteSpect can access BlueKai data. Sometimes, this data is put together at the origin and exposed on the page as a dataLayer. With this setup, SiteSpect makes targeting decisions based on regular expressions that evaluate the page source. If BlueKai data is presented as a cookie or a header, SiteSpect Campaigns can personalize by evaluating HTTP headers and cookies.
BlueKai can also make beacon calls to the origin based on its cookies, which includes the visitor information needed for SiteSpect personalization Campaigns. SiteSpect sees these requests and can capture the data in a Custom Variable so that you can use this visitor data for targeting, personalization, and data segmentation.
### Using BlueKai Data in a SiteSpect Campaign
To integrate SiteSpect and BlueKai, you’ll need to take the following steps. Each of these is described in more detail in later sections of this document:
- [Set up BlueKai](https://doc.sitespect.com/knowledge/integrating-sitespect-and-oracle-bluekai#setting-up-bluekai) to pass visitor data to SiteSpect.
- [Set up a Custom Variable](https://doc.sitespect.com/knowledge/integrating-sitespect-and-oracle-bluekai#setting-up-a-custom-variable) in SiteSpect to store the visitor’s favorite category.
- [Build a SiteSpect Campaign](https://doc.sitespect.com/knowledge/integrating-sitespect-and-oracle-bluekai#building-a-sitespect-campaign) to personalize the experience based on BlueKai data.
### Setting Up BlueKai to pass visitor data to SiteSpect
If the visitor data gathered by BlueKai is not available in the HTML request (meaning it has not been added to a header, cookie, or dataLayer by the origin serving the HTML page), then the browser requests it from the BlueKai servers when the page loads. The request to BlueKai passes the BlueKai cookie that identifies the visitor; the response from BlueKai contains visitor information, like gender or favorite category, collected from various websites.
You must pass the visitor data that comes back from BlueKai to SiteSpect. You can set this up using a pixel request or an EventTrack call where query parameters contain the visitor data and SiteSpect listens for them using a Custom Variable which stores the visitor data in SiteSpect.
This request to SiteSpect can be configured by the origin, setup as a SiteSpect Site Variation (so that you can collect visitor data from BlueKai outside of specific SiteSpect Campaigns), or it can come from a normal Variation in a SiteSpect Campaign that injects JavaScript code on the page to execute the call.
By replacing the source code of the page, SiteSpect’s regular expression engine allows you to inject JavaScript code to deliver a changed experience. For example, you can track a string value of the category with EventTrack. In order for this to work, you must insert the EventTrack library (core.js) on the page. Once inserted, you can use an EventTrack method like SS.EventTrack.rp("category","shoes") to send the visitors favorite category name to SiteSpect. That code makes the following Ajax request to SiteSpect: [https://www.example.com/\_\_ssobj/track?event=category&value=shoes](https://www.example.com/__ssobj/track?event=category&value=shoes).
### Setting Up a Custom Variable in SiteSpect
Now that you are sending visitor data to SiteSpect, you want to store it with a SiteSpect Custom Variable. This document assumes that the request to SiteSpect is made with EventTrack and it is sending visitor’s favorite category.
For example: If the BlueKai request shows that the visitor’s favorite category is shoes, EventTrack makes an Ajax request to URL as follows:
[https://www.example.com/\_\_ssobj/track?event=category&value=shoes](https://www.example.com/__ssobj/track?event=category&value=shoes)
To capture this visitor data in a SiteSpect Custom Variable, setup a Metric to listen for this data:
1. Select **New**, **Metric. **Name the Metric, for example, Top Category.
2. In the **When to Measure (Triggers)** area, select **EventTrack** from the drop-down and enter **category** in the **Parameter value** field.
3. Select the check box **Capture value for this EventTrack**.
4. Click **Edit EventTrack Triggers** to expand the Triggers area. Notice that SiteSpect autofills the following fields:
- URL
- Parameter
- Capture From
5. In the Capture a Custom Value area, select **Custom Variable** as the **Value Type**.
6. **Scope **is set to **Visit Level** by default, so leave this as is.
7. When you are done creating the Custom Variable, the page looks similar to image below.
1. Finally, in the Settings area of the page, select **Use this Metric for Personalization** so that you can use this Metric for advanced targeting.
The Metric is now setup to store the visitor’s favorite category in SiteSpect when the EventTrack call fires.
### Building a SiteSpect Campaign
Now that the Custom Variable is setup to capture BlueKai visitor data, specifically favorite category, we can use this information as a condition of a change being applied on the page. Triggers dictate when to make the change; one of the options for Triggers is Visitor Behavior where you can find your Custom Variable.
A Variation Group can contain multiple Variations, each with its own Triggers. This means that you can deliver a promotion for suits to visitors whose favorite category is suits and a promotion for shoes to visitors that are looking for shoes. Take a look at the image below to see how it is different under **What to Change** based on visitor data under **When to Change**:
Make sure to add the Custom Variable created in the previous step so that it can start collecting data from BlueKai for the visitors favorite category.
### Use Reports to Check Results
Use SiteSpect reports to see if a category-specific promotion increases KPIs. For deeper analysis, create a Segment that matches on any category stored in the Custom Variable to try to figure out if certain categories result in better lift to key KPIs.
To create a Segment to use in your reports:
1. Select **New** and then **Report Segment**.
2. Give the **Segment** a name and complete the basic fields at the top of the page.
3. Select **Custom Variables** from the **Segment Filters** drop-down. Then choose the name of the **Custom Variable** that you created above (**Top Category** or your name).
4. Select **Contains** and then enter the category you want to Segment on. The example below shows **shoes** as the **Category**.
5. Save the Segment and then use it in SiteSpect reports to learn the effects of promoting that specific Category.
### Creating Audiences for Targeting and Personalization
Audiences allow you to target groups for inclusion or exclusion in a Campaign. You can use a Custom Variable to target only certain visitors for Campaign assignment. For example, you can run a follow up Campaign to target visitors who have a specific favorite category in a Campaign that tests a change in that category.
To create an Audience for targeting and personalization:
1. Select **New**, **Audience**.
2. Click **Create** at the right end of the row for **Custom Variable**.
3. Select the **Custom Variable** and enter a category name for the value, for example **shoes**, so that you can target visitors whose favorite category is shoes.
4. Include this Audience in a Campaign to target that group.
- [Get Started](https://doc.sitespect.com/knowledge/get-started?hsLang=en#main-content)
- [SiteSpect Support](https://doc.sitespect.com/knowledge/get-started?hsLang=en#sitespect-support)
- [Overview Information](https://doc.sitespect.com/knowledge/get-started?hsLang=en#overview-information)
- [Intro to SiteSpect](https://doc.sitespect.com/knowledge/get-started?hsLang=en#intro-to-sitespect)
- [Account Setup](https://doc.sitespect.com/knowledge/get-started?hsLang=en#account-setup)
- [Artificial Intelligence](https://doc.sitespect.com/knowledge/get-started?hsLang=en#artificial-intelligence)
- [Dashboard](https://doc.sitespect.com/knowledge/dashboard?hsLang=en)
- [Build](https://doc.sitespect.com/knowledge/build?hsLang=en#main-content)
- [Setting Up a Campaign](https://doc.sitespect.com/knowledge/build?hsLang=en#setting-up-a-campaign)
- [Create a Client-Side Campaign](https://doc.sitespect.com/knowledge/build?hsLang=en#create-a-client-side-campaign)
- [Create a Server-Side Campaign](https://doc.sitespect.com/knowledge/build?hsLang=en#create-a-server-side-campaign)
- [Metrics](https://doc.sitespect.com/knowledge/build?hsLang=en#metrics)
- [Audiences](https://doc.sitespect.com/knowledge/build?hsLang=en#audiences)
- [Triggers](https://doc.sitespect.com/knowledge/build?hsLang=en#triggers)
- [Variations](https://doc.sitespect.com/knowledge/build?hsLang=en#variations)
- [Traffic Management](https://doc.sitespect.com/knowledge/build?hsLang=en#traffic-management)
- [Preview](https://doc.sitespect.com/knowledge/build?hsLang=en#preview)
- [Factors](https://doc.sitespect.com/knowledge/build?hsLang=en#factors)
- [Advanced Settings](https://doc.sitespect.com/knowledge/build?hsLang=en#advanced-settings)
- [Omnichannel](https://doc.sitespect.com/knowledge/build?hsLang=en#omnichannel)
- [Regular Expressions (Regex)](https://doc.sitespect.com/knowledge/build?hsLang=en#regular-expressions-regex)
- [WATTS](https://doc.sitespect.com/knowledge/build?hsLang=en#watts)
- [Recommendations](https://doc.sitespect.com/knowledge/build?hsLang=en#recommendations)
- [Monitor](https://doc.sitespect.com/knowledge/monitor?hsLang=en)
- [Analyze](https://doc.sitespect.com/knowledge/analyze?hsLang=en#main-content)
- [Data Export and Integration](https://doc.sitespect.com/knowledge/analyze?hsLang=en#data-export-and-integration)
- [SiteSpect Reports](https://doc.sitespect.com/knowledge/analyze?hsLang=en#sitespect-reports)
- [Site](https://doc.sitespect.com/knowledge/site?hsLang=en#main-content)
- [Tools](https://doc.sitespect.com/knowledge/site?hsLang=en#tools)
- [Configuration](https://doc.sitespect.com/knowledge/site?hsLang=en#configuration)
- [Developers](https://doc.sitespect.com/knowledge/developers?hsLang=en#main-content)
- [API Reference](https://doc.sitespect.com/knowledge/developers?hsLang=en#api-reference)
- [Code Samples](https://doc.sitespect.com/knowledge/developers?hsLang=en#code-samples)
- [Tips & Tricks](https://doc.sitespect.com/knowledge/developers?hsLang=en#tips-tricks)
- [Mobile](https://doc.sitespect.com/knowledge/mobile?hsLang=en)
- [Implementation, Deployment, and Security](https://doc.sitespect.com/knowledge/implementation-deployment-and-security?hsLang=en#main-content)
- [How does SiteSpect work with CDNs?](https://doc.sitespect.com/knowledge/implementation-deployment-and-security?hsLang=en#how-does-sitespect-work-with-cdns)
- [Single Tenant Implementations](https://doc.sitespect.com/knowledge/implementation-deployment-and-security?hsLang=en#single-tenant-implementations)
- [Security Features](https://doc.sitespect.com/knowledge/implementation-deployment-and-security?hsLang=en#security-features)
- [Deployment and Implementation Overview](https://doc.sitespect.com/knowledge/implementation-deployment-and-security?hsLang=en#deployment-and-implementation-overview)
- [SiteSpect Engine & Admin API](https://doc.sitespect.com/knowledge/implementation-deployment-and-security?hsLang=en#sitespect-engine-admin-api)
- [Third-Party Integration](https://doc.sitespect.com/knowledge/third-party-integration?hsLang=en#main-content)
- [Google](https://doc.sitespect.com/knowledge/third-party-integration?hsLang=en#google)
- [Zuko](https://doc.sitespect.com/knowledge/third-party-integration?hsLang=en#zuko)
- [Troubleshooting](https://doc.sitespect.com/knowledge/troubleshooting?hsLang=en)
- [Releases](https://doc.sitespect.com/knowledge/releases?hsLang=en#main-content)
- [Superfresh](https://doc.sitespect.com/knowledge/releases?hsLang=en#superfresh)
- [Feedback](https://doc.sitespect.com/knowledge/feedback?hsLang=en)
- [A/B Testing](https://www.sitespect.com/testing-and-experimentation/)
- [Personalization](https://www.sitespect.com/personalization-targeting/)
- [Recommendations](https://www.sitespect.com/recommendations/)
[](http://monetate.com)
[mailto:email@email.com](mailto:email@email.com)
Copyright © 2026, Monetate