Integrating VWO With RudderStack (Via RudderStack)

RudderStack is an open-source, warehouse-first customer data platform (CDP) that builds your CDP on your data warehouse for you. It provides a powerful transformation framework to process your event data on the fly.

RudderStack supports integration with VWO that allows you to send relevant campaign information from VWO to RudderStack, from where it can be used by other destinations that are configured to the same source as VWO. The integration also allows streaming RudderStack events and user attributes to VWO Data360.

Let’s look at the step-by-step guide to integrate RudderStack with VWO for efficient A/B testing.

Configuring VWO as a Destination in RudderStack

RudderStack supports only JavaScript as a source while adding VWO as a destination in RudderStack.

To know more about how a Device mode destination in RudderStack works, read this.

Once you have confirmed that the platform is supported, perform this:

Procedure

1. From your RudderStack dashboard, add the JavaScript source.
2. From the navigation pane on the left, go to Collect > Connections > Destinations > New Destination, and select VWO.
   
   
   Perform the steps mentioned here to add VWO as a destination in RudderStack.
3. After creating the VWO destination in Rudderstack, you need to name it to identify your destination and click Continue.
   
4. On the Connect Sources screen, select the appropriate JavaScript source that you want to link to the VWO destination and click Continue.
   
5. On the Connection Settings screen, perform the configuration steps as specified here and click Continue to complete creating the destination.
   

Sending “Experiment Viewed” From VWO

When one of the variations from an experiment is loaded for a visitor, RudderStack sends a track call with Experiment Viewed as the event name, along with the experiment (campaign) and variation details as the associated properties.

A sample code snippet for this activity is shown below:

rudderanalytics.track("Experiment Viewed", {
 experimentId: 1,
 variationName: "Variation-1"
});

This track event can be used in other destinations, such as Google Analytics and Mixpanel for analyzing the campaign results on different platforms. You can also set campaign-related data as user traits in RudderStack so that the other destinations have knowledge of the variations a visitor has seen.

Tracking Revenue Goals

Websites that have already configured their revenue conversion tracking event (Order Completed) in RudderStack can use the same to allow VWO to track the revenue conversions. This obviates the need to implement the revenue conversion code while setting up a revenue tracking goal in VWO.

NOTE: This feature is applicable to the accounts that are not enabled with the Data360 module.

To receive the revenue conversions from RudderStack in your VWO account, configure the code snippet for the track call as shown:

// We use revenue or amount from the properties
rudderanalytics.track('Order Completed', {
revenue: <revenue amount or variable>
});

Importing Events and Attributes From RudderStack into VWO

Upon configuring the VWO destination in RudderStack, the event and attribute data from RudderStack will start streaming into your VWO account. These events and attributes will appear in the Unregistered section, respectively. 

The events and attributes imported from RudderStack can be identified by the name tagged to them. They appear in the format - rudder.<name of the event/attribute>. For example, rudder.HeatmapAllClicksSelect.

ATTENTION: VWO does not fetch events directly from RudderStack. It fetches from the web pages from where the triggered events are being captured by RudderStack. To achieve this, you need to have at least one active VWO campaign running on any page of your website, with the prerequisite that the VWO SmartCode is installed on the respective page.

In order to use these events and attributes in your campaigns, you need to save them to your VWO account. The procedure to save an unregistered event or an attribute is the same and is as follows:

1. Under the UNREGISTERED EVENTS / UNREGISTERED ATTRIBUTES section, click on the imported event/attribute.
2. Click on the Register Event / Register Attribute button to save the event/attribute to your VWO account.

3. Once done, the event/attribute gets transferred to the MY EVENTS / MY ATTRIBUTES section.

Now, you can use the event/attribute to construct a metric to track conversions or a custom visitor segment to target your campaign or filter your campaign reports.