Integrating VWO With mParticle

About mParticle

mParticle is a customer data platform (CDP) that centralizes and manages data from various sources, simplifying data collection, integration, and transformation. It enables businesses to create audience segments, maintain data quality, and use real-time data for marketing and analytics. mParticle is especially valuable for digital businesses looking to optimize customer experiences and marketing efforts.

By integrating VWO with mParticle, you will be able to export your VWO campaign data to your mParticle account to maintain a unified record of your customer data. 

Enabling the mParticle Integration for Your VWO Account

To enable the VWO-mParticle integration in your VWO account, the following prerequisites must be met:

• You should possess an active mParticle account.
• The VWO SmartCode and mParticle analytics code should be implemented on your webpage.

Procedure

1. Log in to your VWO account.
2. From the left panel of your VWO dashboard, go to Configurations > Integrations page, which provides integrations to be enabled at the account level. 
3. Click on the mParticle integration tile, and click on Enable Now.  By doing so, you can use this integration in your test campaigns. Once done, the mParticle screen within the Integrations page looks like this:
   
   
   

Post enabling the integration, you need to configure the data to be sent and received from mParticle.

Configuring the Integration Setup

Once you have enabled the mParticle integration, you will be able to configure how your VWO data should be transmitted to mParticle. The Config tab in the mParticle integration page will display the Enable Sending VWO Campaign Data to mParticle option.

Once you select it, you will be able to configure how to send your VWO campaign data (as visitor attributes or custom events or both) to your mParticle account. Select one of the following options:

• Custom Event - By selecting this option, you can receive your VWO campaign data as custom events in your mParticle account. This option delivers information to mParticle at the event-level in the following format:

mParticle.logEvent(
   'VWO',
    window.mParticle.EventType.Other,
    { "VWO-<campaign ID>" : "<variation ID>-<variation name>"}
);

• User Attribute - By selecting this option, you can receive your VWO campaign data as user attributes in your mParticle account. This delivers the data to mParticle at the user level in the following format:

var currentUser = mParticle.Identity.getCurrentUser();
currentUser.setUserAttribute("VWO-<campaign ID>", "<variation ID>-<variation name>");

• Both - By selecting this option, you can receive your VWO campaign data as custom events and user attributes individually in your mParticle account.

After configuring the outbound setup, the mParticle integration is auto-applied to your new campaigns. To enable it for the pre-existing ones, you can select the mParticle integration checkbox in your respective VWO campaign in order to pass the campaign data from VWO to mParticle. To do so, select the campaign, go to Configuration > Integrations, and select  mParticle.

Verifying the Integration Setup

You can check if the integration setup is complete or troubleshoot the setup by verifying the network calls to identify the data pushed from VWO to mParticle by performing the following steps in your browser:

1. Right-click on the page where your test campaign is running and select Inspect Element.
2. Under the Network tab, search for “mParticle” to filter the network calls for mParticle.
3. The network calls get populated as the page loads. You may reload the page to view the network calls.
4. Select a network call to view further details.
5. Go to the Payload tab, where you can find the data being pushed in the following format:
   • event_name: "VWO"
   • custom_attributes:{VWO-<campaign ID>: "<variation ID>-<variation name>"}

These indicate that the values are being pushed by VWO to mParticle.

Alternatively, you can verify the same from your mParticle account by navigating to DATA MASTER > Live Stream.

Creating Report in mParticle Using VWO Data

mParticle serves to act as a connector for multiple other third-party applications that have their own unique features, eliminating the necessity to integrate individually with them. You can integrate your VWO account with mParticle to transfer your VWO campaign data to any other platform that is connected to mParticle. 

Additionally, you can also create audiences in mParticle with your VWO campaign data and use these audiences in other third-party applications for further processing.

To create mParticle audience using VWO campaign data, perform the following steps:

1. Go to AUDIENCES > Realtime and click on the New Audience button.
2. In the New Audience popup that appears, supply a name for the audience and click Create.
   
3. Now, you can configure the audience by adding the filter criteria. In the BUILD tab of the newly created audience, click on Add Criteria and select Events.
4. From the Choose event type dropdown, select Other. In the adjacent dropdown that appears, select VWO (Other) and click on the Add Attribute option.
5. In the Attributes section that appears, select the VWO campaign and the corresponding variation for which you want to view the report and create a criterion as shown below:
   

Click Done.