Integrate VWO with Tealium iQ for Advanced Visitor Targeting

Overview

The VWO-Tealium iQ integration allows VWO to access the data layer variables defined within your Tealium iQ Customer Data Platform (CDP). By enabling this integration, you can utilize these variables to create precise targeting conditions for your VWO A/B tests and personalization campaigns. This setup eliminates the need to manually recreate data layer logic in VWO and ensures a seamless flow of user data between platforms.

Prerequisites

• An active VWO account and a user with the Admin role.
• An active Tealium iQ installation deployed and running on the target website.
• Properly configured Universal Data Object (UDO) variables, for example, utag_data, that are populating correctly on your website.

Configuration and Setup

Enable the VWO-Tealium iQ Integration

You must enable the integration globally in your VWO account before using it in specific campaigns.

To enable the integration in your account:

1. Log in to your VWO account.
2. From the main navigation menu on the left, go to Configurations > Integrations.
3. Search for Tealium iQ in the integrations gallery and select the integration tile.
4. To enable the integration, turn on the toggle switch in the top-right corner of the page.

The Tealium iQ integration is now enabled and active for your account, allowing you to use your Tealium iQ data layer variables as targeting attributes in any VWO campaign.

Verify the Tealium iQ Event Implementation on Your Website

Once the integration is active and enabled, before configuring the target audience using Tealium iQ, ensure your website fires a utag.view (or relevant Tealim iQ event call) with the required event data.

Example:

utag.view({
tealium_event: "add_to_cart",
  product_id: ["SKU500"],
  product_name: ["Dell XPS 13c"],
  product_unit_price: [1299.99],
  currency: "INR",
  productCategory: "Laptopsc"
});

In this example:

• Tealium_event is the key (variable name).
• add_to_cart is the value passed when a user adds a product to the cart

Configure Target Audience in VWO using Tealium iQ

Once the integration is enabled and you have verified the Tealium iQ event implementation, you can use Tealium iQ variables to define the target audience for your campaigns as follows:

1. In your VWO account, from the main navigation menu on the left, go to Testing > A/B (or your preferred product) and select the campaign you want to configure.
2. Navigate to the Configuration tab for the selected campaign, then go to Audience and Traffic.
3. Under the Target Audience section, click Custom Segment.
4. In the Attribute selector dropdown, search for and select Tealium iQ.

5. Enter the Tealim iQ variable name and the value you want to target.

   Note: The variable name entered in VWO must exactly match the key used in your Tealim iQ code.

   

6. Click Save Segment to store the targeting logic for future use, or click Save Changes to apply the targeting logic immediately.

   Note:

   • When you select Tealium iQ as a targeting condition, the Poll Until setting is automatically set to Custom Event. This includes a code snippet that waits up to 5 seconds for the tealium_event to become available.
   • The segmentation condition will not be applied if the key is unavailable within this time frame.
   • You can modify the wait duration within the code snippet, as shown in the following image, to suit your specific requirements.

   

Once you configure the Tealium iQ targeting rule and start your campaign, VWO begins the process of real-time audience evaluation for every visitor who lands on your website. You may notice a slight delay in VWO changes appearing on the page, as it can take a few moments for the Tealim iQ data layer to load the necessary information.

Troubleshooting

FAQs

• Can I use multiple Tealim iQ variables in one segment?
   Yes. You can add multiple conditions using AND/OR logic within the VWO Custom Segment builder to create complex audiences. For example, page_type is checkout AND currency is USD.
   
• Does the VWO-Tealium iQ integration support Tealium AudienceStream?
  This integration is designed only for Tealium iQ (Tag Management) data layer variables.
   
• How long does it take for Tealim iQ data to populate in VWO?
  The data is accessed directly from the client-side data layer. If the data is present in the utag_data object on page load, VWO consumes it immediately.
   
• What happens if the Tealim iQ variable value changes during a session?
  VWO evaluates targeting conditions at the start of the session or on page load. If a Tealim iQ variable changes after the campaign has already triggered (or failed to trigger), the visitor's status in the campaign will not change until the next evaluation cycle (usually the next page load).

Need more help?

For further assistance or more information, contact VWO Support.