Integrate Wingify with Tealium iQ for Advanced Visitor Targeting

Feature Availability: This feature is available with Wingify Testing (Web), Wingify Personalize, Wingify Rollouts, and Wingify Insights on Pro and Enterprise plans.

This article covers the following:

• Overview
• Prerequisites
• Configuration and Setup
  • Enable the Wingify-Tealium iQ Integration
  • Verify the Tealium iQ Event Implementation on Your Website
  • Configure Target Audience in Wingify using Tealium iQ
• Troubleshooting
• FAQs

Overview

The Wingify-Tealium iQ integration allows Wingify 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 Wingify A/B tests and personalization campaigns. This setup eliminates the need to manually recreate data layer logic in Wingify and ensures a seamless flow of user data between platforms.

Prerequisites

• An active Wingify 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 Wingify-Tealium iQ Integration

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

To enable the integration in your account:

1. Log in to your Wingify account.
2. From the left panel of your Wingify dashboard, go to Configurations > Integrations. 
3. Search for Tealium IQ in the search bar.
4. Click the Tealium IQ tile. The connection screen appears.
5. Click Create Connection. A panel appears on the right.
6. In the panel, click Target Tealium Data from Tealium iQ
7. Provide the name of the connection in the Connection Name field (for example, Tealium connector). 
8. Click Create Connection. A connection will be established between Wingify and Tealium.

To enable this integration at the campaign level, use the following steps:

1. Navigate to Web Experimentation or Personalize.
2. Select the desired campaign, and go to Configuration > Integrations.
3. Select the Tealium IQ checkbox from the list of available integrations and click Save Now.

The Tealium iQ integration is now active for your account, allowing you to use your Tealium iQ data layer variables as targeting attributes in any Wingify 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.

Tip: Use the browser console to inspect the utag_data object on your site to confirm the values are present before activating the campaign.

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

Attention: The variable name and value are case-sensitive and must match exactly in Wingify.

Configure Target Audience in Wingify 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 Wingify 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 Tealium iQ variable name and the value you want to target.
   Note: The variable name entered in Wingify 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:
   1. 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.
   2. The segmentation condition will not be applied if the key is unavailable within this time frame.
   3. You can modify the wait duration within the code snippet to meet your specific requirements.

Once you configure the Tealium iQ targeting rule and start your campaign, Wingify begins the process of real-time audience evaluation for every visitor who lands on your website. You may notice a slight delay in Wingify 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 Wingify Custom Segment builder to create complex audiences. For example, page_type is checkout AND currency is USD.
   
• Does the Wingify-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 Wingify?
  The data is accessed directly from the client-side data layer. If the data is present in the utag_data object on page load, Wingify consumes it immediately.
   
• What happens if the Tealim iQ variable value changes during a session?
  Wingify 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 Wingify Support.