--- title: Integrating SiteSpect and Tealium AudienceStream description: SiteSpect integrates with various third-party audience and data management platforms to launch more personalized experiments and to allow you to use externally defined audiences or segments in data an --- [Skip to content](https://doc.sitespect.com/knowledge/integrating-sitespect-and-tealium-audiencestream#main-content) English Show submenu for translations ![Monetate-Logo-Full-Color-1](https://doc.sitespect.com/hs-fs/hubfs/Monetate-Logo-Full-Color-1.png?width=340&height=49&name=Monetate-Logo-Full-Color-1.png) - [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 Tealium AudienceStream SiteSpect integrates with various third-party audience and data management platforms to launch more personalized experiments and to allow you to use externally defined audiences or segments in data analysis. In addition, SiteSpect also 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 Tealium AudienceStream. These instructions are intended for a user who has some experience with AudienceStream and who has sufficient permissions to implement code changes on your website. The instructions are meant to provide a high-level framework through which you can design your own integration strategy. ### Overview [Tealium AudienceStream](https://tealium.com/products/audiencestream/) is a customer data platform with powerful audience management and data enrichment capabilities. It provides unified custom profiles for personalization. Integrating AudienceStream with SiteSpect allows you to use audiences created in AudienceStream to build targeted or personalized experiments in SiteSpect and to analyze data in SiteSpect reports using its external segments. Through personalization, your website learns what your visitors like and don’t like based on how often they view certain categories of products or content. For example, SiteSpect can leverage AudienceStream data to lookup a visitor’s favorite category and change the experience as part of a personalization Campaign. In this way, a SiteSpect Campaign can promote a visitor’s favorite category to the top of the category listing page in order to see how this promotion affects business KPIs. In addition, SiteSpect can pull AudienceStream data on the visitor’s favorite category and store it as a Custom Variable and use that for data segmentation. As such, you can show that the promotion of only certain favorite categories has a positive result. Although you can use SiteSpect to implement AudienceStream on a website, this document assumes that you’ve already set it up and that AudienceStream data is accessible from localStorage where the visitor’s favorite category is stored. ### Using AudienceStream Data in a SiteSpect Campaign SiteSpect’s regular expression engine allows you to not only replace the source code of the page but also to inject JavaScript code to deliver a changed experience. JavaScript code has access to the browser’s localStorage where it can retrieve visitor data from AudienceStream. To integrate SiteSpect and Tealium AudienceStream, you’ll need to take these steps. Each of these is described in more detail in later sections of this document: 1. Set up Tealium AudienceStream to store the visitor’s favorite category in localStorage. Check the AudienceStream documentation for further instruction. 2. [Set up a Custom Variable in SiteSpect](https://doc.sitespect.com/knowledge/integrating-sitespect-and-tealium-audiencestream#setting-up-a-custom-variable-in-sitespect) to store the visitor’s favorite category. 3. [Build a SiteSpect Campaign](https://doc.sitespect.com/knowledge/integrating-sitespect-and-tealium-audiencestream#building-a-sitespect-campaign) to inject JavaScript code onto the page. That code uses EventTrack to store the visitor's favorite category, if there is one, in the Custom Variable. If there is a favorite category, the Campaign moves that category to the top of the page. 4. [Use Reports to Check Your Results](https://doc.sitespect.com/knowledge/integrating-sitespect-and-tealium-audiencestream#use-reports-to-check-results) ### Setting Up a Custom Variable in SiteSpect The SiteSpect Custom Variable stores the visitor’s favorite category. 1. Select **New**, **Custom Variable**. The **Create New Metric** page opens. 2. Name the **Metric**, for example, **Top Category**. 3. In the **When to Measure (Triggers)** area, select **EventTrack** from the drop-down and enter **category** in the **Parameter value** field. 4. Select the check box **Capture value for this EventTrack**. 5. Click **Edit EventTrack Triggers** to expand the Triggers area. Notice that SiteSpect autofills the following fields: - URL - Parameter - Capture From 6. In the **Capture a Custom Value** area, select **Custom Variable** as the **Value Type**. 7. **Scope **is set to **Visit Level** by default, so leave this as is. 8. When you are done creating the Custom Variable, the page looks similar to image below. 9. Finally, in the **Settings** area of the page, select **Use this Metric for Personalization** so that you can use this Metric for advanced targeting. ![Integrating SiteSpect and Tealium AudienceStream - Setting Up a Custom Variable in SiteSpect](https://doc.sitespect.com/hs-fs/hubfs/Kbase%20Images/Integrating%20SiteSpect%20and%20Tealium%20AudienceStream%20-%20Setting%20Up%20a%20Custom%20Variable%20in%20SiteSpect.png?width=688&name=Integrating%20SiteSpect%20and%20Tealium%20AudienceStream%20-%20Setting%20Up%20a%20Custom%20Variable%20in%20SiteSpect.png) The Metric is now setup to store the visitor’s favorite category in SiteSpect when the EventTrack call fires. For example, the JavaScript code injected by the Campaign may find that a visitor’s favorite category is **shoes**. As such, the EventTrack call sends an Ajax request with the URL [https://www.example.com/\_\_ssobj/track?event=category&value=shoes](https://www.example.com/__ssobj/track?event=category&value=shoes) which matches the regex logic specified in the **Triggers** area and the **Capture From** field. ### Building a SiteSpect Campaign Build a SiteSpect Campaign to capture the visitor’s favorite category in a Custom Variable and to promote that category to the top of the category listing page. In addition, you can use that Custom Variable for segmentation (Segments in SiteSpect reports) and personalization (Targeting Campaigns). To execute JavaScript code on the page, the SiteSpect find and replace Campaign finds an HTML tag and replaces it with the same HTML tag and in addition adds a new \ tag, which contains JavaScript code. This JavaScript code looks into localStorage to find the visitor’s favorite category and then: - Uses [EventTrack](https://doc.sitespect.com/knowledge/using-eventtrack-for-advanced-visitor-tracking?hsLang=en) to send the favorite category to SiteSpect, which SiteSpect stores in the Custom Variable. - Tracks a string value of the category with EventTrack. The EventTrack library (core.js) must be on the page. The code should look similar to this: SS.EventTrack.rp("category",”shoes”), which 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). - Moves the favorite category to the top of the page. To build the find and replace Campaign: 1. Select **New**, **A/B Campaign**. 2. Complete the **General** section and select **Standard** from the **Type** drop-down. 3. In the **Variations** section of the page, rename **Variation Group 1** to **Favorite Category**. 4. For Variation 1, select **URL** from the **Type** drop-down and enter /category/ in the **Contains** field. 5. In the **Find This** field, enter \. 6. In the **Replace With This** field you’ll enter something like the following example and replace the JavaScript comment with your own code: ``` ``` ``` ``` 7. Finish by selecting **Metrics** you want to track and any **Audiences** you want to target. 8. Click **Save** at the bottom of the page. ![Integrating SiteSpect and Tealium AudienceStream - Building a SiteSpect Campaign](https://doc.sitespect.com/hs-fs/hubfs/Kbase%20Images/Integrating%20SiteSpect%20and%20Tealium%20AudienceStream%20-%20Building%20a%20SiteSpect%20Campaign.png?width=688&name=Integrating%20SiteSpect%20and%20Tealium%20AudienceStream%20-%20Building%20a%20SiteSpect%20Campaign.png) ### Use Reports to Check Results Use SiteSpect reports to see if promoting the favorite category 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**, **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.![Integrating SiteSpect and Tealium AudienceStream - Use Reports to Check Results](https://doc.sitespect.com/hs-fs/hubfs/Kbase%20Images/Integrating%20SiteSpect%20and%20Tealium%20AudienceStream%20-%20Use%20Reports%20to%20Check%20Results.png?width=603&name=Integrating%20SiteSpect%20and%20Tealium%20AudienceStream%20-%20Use%20Reports%20to%20Check%20Results.png) 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 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/) [![Monetate-Logo-Full-Color-1](https://doc.sitespect.com/hs-fs/hubfs/Monetate-Logo-Full-Color-1.png?width=200&height=29&name=Monetate-Logo-Full-Color-1.png "Monetate-Logo-Full-Color-1")](http://monetate.com) [mailto:email@email.com](mailto:email@email.com) Copyright © 2026, Monetate