Integrate Wingify with mParticle

This article covers the following:

• Overview
• Before You Begin
• Create an mParticle Connection in Wingify
  • Send Campaign Data to mParticle
    • Specifications of Wingify Campaign Data Sent to mParticle
  • Import Audience Lists from mParticle
  • Target a Campaign Using mParticle Audience Lists
• Verify the Integration Setup
• Create an Audience in mParticle Using Wingify Data

Overview

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.

The Wingify–mParticle integration supports two use cases:

• Sending Wingify campaign and variation data to mParticle for analytics and reporting.
• Importing mParticle audience lists into Wingify for visitor targeting.

Before You Begin

• You have an active mParticle account.
• The Wingify SmartCode is installed on your website.
• The mParticle SDK or analytics code is implemented on your website.

Create an mParticle Connection in Wingify

Wingify supports the following mParticle connection types:

• Send campaign data to mParticle (Push based): Allows you to send Wingify campaign and variation data to mParticle for analytics and reporting.
• Import Audience Lists from mParticle (Targeting): Allows you to target visitors in Wingify using audience lists created in mParticle.

To create an mParticle connection in your Wingify account:

1. Log in to your Wingify account.
2. Navigate to Configurations > Integrations.
3. Click the mParticle integration tile and click Create Connection.
4. Select the connection type you want to configure.
5. Click Create Connection.

All configured connections appear under the Config > Active Connections section on the mParticle integration page.

Send Campaign Data to mParticle

Use this connection type to send Wingify campaign participation data to mParticle.

To configure the connection:

1. Click Create Connection and select Send campaign data to mParticle.
2. Enter a name in the Connection Name field.
3. Configure how you want Wingify campaign data to be sent to mParticle. You can choose one of the following options:
   • Custom Event: Sends Wingify campaign data as custom events to mParticle.
   • User Attribute: Sends Wingify campaign data as user attributes to mParticle.
   • Both: Sends Wingify campaign data as both custom events and user attributes.
4. Click Create Connection.

Specifications of Wingify Campaign Data Sent to mParticle

Wingify sends campaign data to mParticle using the following event payload:

Event name: wingify

Event properties:

{
 campaign_id: {CAMPAIGN_ID},
 variation_id: {VARIATION_ID},
 campaign_name: {CAMPAIGN_NAME},
 variation_name: {VARIATION_NAME},
 user_id: {USER_ID},
 target_id: {TRIGGER_ID},
 target_name: {TARGET_NAME},
}

Import Audience Lists from mParticle

Feature Availability: Available on Pro and higher plans.

Use this connection type to import audience lists from mParticle and target visitors in Wingify.

To configure the connection:

1. Click Create Connection and select Import Audience Lists from mParticle.
2. Enter a connection name.
3. Click Create Connection.
4. Under the active connection, click Add Audience Lists.
5. Select the audience lists you want to import from mParticle.
6. Save your changes.

The selected audience lists are synced and become available for targeting within Wingify.

Target a Campaign Using mParticle Audience Lists

Once you have imported audience lists from your mParticle account into Wingify, you can use them to target visitors who belong to those audiences.

To target a campaign using an mParticle audience list:

1. Log in to your Wingify account.
2. Go to Web Experimentation and select your campaign.
3. On the Configuration page, go to Targeting. Under Segments, select Custom Segment.
4. Create a segment using the mParticle segment condition. You can use this to fetch the smart lists that you have synced in Wingify from your mParticle account.
5. To add multiple conditions, click Add another condition. You can also define the logical relationship between conditions using the and/or operators and use brackets to organize the segment condition.
6. Once done, click Save Segment. In the popup that appears, enter a segment name, optionally add a description, and click Save.
7. Click Apply to apply the segment to the campaign.

Verify 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 Wingify 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 and locate the custom event with the following details:

           Event name: wingify

           Event properties:

• campaign_id
• campaign_name
• variation_id
• variation_name

• user_id

  You may also see the following properties when using the Personalize Holdback feature:

• target_id
• target_name

6. Verify that the property values match the Wingify campaign and variation currently being served to the visitor.

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

Create an Audience in mParticle Using Wingify Data

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

Additionally, you can create audiences in mParticle using your Wingify campaign data and use them in other third-party applications for further processing.

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

1. Go to AUDIENCES > Realtime and click on the New Audience button.
2. In the New Audience pop-up 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 Add Criteria, then select Events.
4. From the Choose event type dropdown, select Other. In the adjacent dropdown that appears, select wingify (Other) and click on the Add Attribute option.
5. In the Attributes section that appears, select the Wingify campaign and the corresponding variation for which you want to view the report and create a criterion.
6. Click Done.

Need more help?

For further assistance or more information, contact Wingify Support.