Integrate Wingify with Eulerian

Overview

This article describes how to integrate Wingify with Eulerian, a marketing performance platform that provides attribution modeling and real-time analytics. This integration allows for a two-way data exchange: 

• Sending Wingify campaign data to Eulerian for unified analysis
• Using audiences defined in Eulerian to target Wingify campaigns

The Wingify-Eulerian integration bridges the gap between website optimization/experimentation (Wingify) and marketing analytics and attribution (Eulerian). Marketers and analysts can see how Wingify campaigns influence broader marketing KPIs tracked in Eulerian and can target Wingify experiences based on detailed user profiles managed by Eulerian.

This feature connects Wingify Web Experimentation, Rollouts, Insights, and Personalize with the Eulerian platform through Wingify Integrations.

Key Benefits

• Unified Analytics: Analyze Wingify campaign performance alongside other marketing data within the Eulerian platform.
• Enhanced Attribution: Incorporate Wingify experiment exposure into Eulerian's attribution models.
• Advanced Audience Targeting: Leverage rich audience segments built in Eulerian to target specific user groups in Web Experimentation or Personalize campaigns.
• Data-Driven Decision Making: Gain deeper insights by combining experimentation results with comprehensive marketing analytics.

Use Cases

• Analyze Campaign Impact in Eulerian: Send Wingify campaign and variation names to Eulerian to segment marketing reports and dashboards based on experiment exposure.
• Attribute Conversions: Include Wingify variation data in Eulerian to understand how experiments contribute to conversions tracked across different marketing channels.
• Target High-Value Segments: Use an Eulerian audience (for example, Frequent Buyers, High Intent Users) to target specific variations or personalized experiences in Wingify.
• Exclude Specific Audiences: Prevent certain Eulerian segments (for example, Existing Employees, Low Engagement Users) from seeing specific Wingify tests.
• Consistent Cross-Platform Experience: Ensure users belonging to specific Eulerian audiences receive consistent messaging or experiences, whether driven by Eulerian or Wingify.

Prerequisites

• Eulerian account: An active Eulerian account with necessary permissions for S2S configuration and audience management.
• Wingify SmartCode: The Wingify SmartCode must be correctly installed on your website.
• Eulerian tracking script: The Eulerian tracking script or tag must be correctly installed and active on your website.
• API key: You need the API Key generated by Wingify after creating the connection. This key is used within the Eulerian S2S configuration.
• Permissions:
  • Wingify: Admin or equivalent permissions are needed to access and manage Integrations. Campaign setup permissions are needed to use audience targeting.
  • Eulerian: Permissions to access and configure S2S Parameters or Partner Connectors.

Configuration and Setup

The setup requires configuration in both Wingify and Eulerian.

Create an Eulerian Connection in Wingify

To create an Eulerian connection in your Wingify account:

1. Log in to your Wingify account.
2. From the left panel, navigate to Configurations > Integrations.
3. Click the Eulerian integration tile and click Create Connection.
4. Select the type of connection you want to configure:
   1. Send campaign data to Eulerian: Allows you to track and analyze Wingify campaign data in Eulerian using campaign and variation details.
   2. Import Segments from Eulerian: Allows you to target visitors in Wingify using Eulerian Segments.

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

Send Campaign Data to Eulerian

To configure the connection:

1. Enter a name in the Connection Name field (for example, Eulerian Push Connector).
2. Click Create Connection.

Once the connection is created, you can enable the integration at the campaign level using the following steps:

1. Navigate to Web Experimentation.
2. Select the campaign and go to Configuration > Integrations.
3. Select Eulerian from the list of available integrations.

Specifications of Wingify Experiment Data Sent to Eulerian

When a visitor becomes part of a Wingify campaign, Wingify sends the following experiment data to Eulerian:

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

Verify Wingify Campaign Data Sent to Eulerian

To verify that Wingify sends campaign data to Eulerian, complete the following steps:

1. Run a Wingify campaign with the integration fully configured.
2. Visit the campaign page so you're assigned to a variation.
3. Check your Eulerian platform (reports, raw data feeds, or partner data sections) for events or properties indicating exposure to the Wingify campaign and variation.

Import Segments from Eulerian

To configure the connection:

1. Enter a name in the Connection Name field (for example, Eulerian Pull Connector).

1. Click Create Connection.
2. After the connection is created, Wingify generates an API Key. Click Copy.
3. Add this API Key to Eulerian as outlined in the Configure S2S Partner Connector in Eulerian section.

Configure S2S Partner Connector in Eulerian

This part configures Eulerian to receive data pushed from Wingify via Server-to-Server (S2S).

1. Log in to your Eulerian platform (for example, lo1.ea.eulerian.com/ea/).
2. Navigate to the Server-to-Server (S2S) configuration area.
3. Click on Add a partner connector.
4. In the Partner choice step, search for the partner Visual Website Optimizer and select it.
5. In the Segment choice step:
   1. Enter a descriptive Connector name (for example, Wingify Integration or Wingify Test Data).
   2. (Optional) Select a Publisher if applicable.
   3. Select the appropriate partner connector definition from the dropdown (this might be pre-configured or specific to your Eulerian setup, for example, Wingify-com - Wingify - MM/DD/YY) and click Add.
6. In the Add a new connector or Settings modal:
   1. Verify the Name.
   2. Paste the API Key that you copied from the Wingify integration settings into the ApiKey field. For more information, see Import Segments from Eulerian.
      
   3. Click Add (or equivalent save button in the modal).
7. Click Next to proceed to the next step.
8. In the Rule choice step:
   1. Search for the rule EA_collector tag trigger.
   2. Select this rule.
   3. Ensure the toggle for this rule is set to yes.
   4. Click Confirm.

9. Once the connector is added, mark it as active in Partner connector attributes and save. 

The Wingify partner connector is now listed and active in your Eulerian S2S parameters, and is configured to receive data using the provided API key.

Use Eulerian Audiences for Wingify Campaign Targeting

To access Eulerian audiences for targeting:

1. Create an Import Segments from Eulerian connection and add its API Key to Eulerian. For more information on generating the API key, see Import Segments from Eulerian.
2. Select your campaign and then select Configuration > Targeting.
3. Under Segments, select Custom Segment.
4. In the segment builder, open the condition dropdown, go to the Integrations tab, and select Eulerian Audience.
5. Select the desired comparison operator, for example, =).
6. From the next dropdown, select the specific audience segment name defined in your Eulerian account (for example, First visit - segment). These names are fetched from your connected Eulerian account.
7. Click Apply.

Verify Wingify Campaign Targeting Using Eulerian Audiences

1. Set up a Wingify campaign targeting a specific Eulerian Audience segment as described in Use Eulerian Audiences for Wingify Campaign Targeting.
2. Ensure you (or a test user) belong to that audience in Eulerian.
3. Visit the page targeted by the Wingify campaign.
4. To verify campaign execution, open the Application tab in your browser's developer tools, check Cookies, and verify that the Wingify cookie (like _wingify_combi) contains your specific campaign and variation IDs. You should also see a visible change or notification if the campaign variation makes one.

Best Practices

• Secure API Key: Treat the API key generated by the Import Segments from Eulerian connection as sensitive information, and store it securely once added to your Eulerian account.
• Use Descriptive Names: Use clear, identifiable names for your Eulerian audiences and Wingify campaigns and variations so they are easily identifiable in both platforms.
• Create only the connections you need: Set up only the Eulerian connection types (Send campaign data, Import segments) that you plan to use.
• Test Thoroughly: Verify both data flow directions after setup by checking for Wingify data in Eulerian and testing Wingify campaign targeting with Eulerian audiences.

FAQs

• Where do I get the API Key from Wingify and how to use it in Eulerian?
  The API Key is generated when you create an Import Segments from Eulerian connection in Wingify (under Configurations > Integrations > Eulerian). Copy this key and add it to your Eulerian account to enable Wingify to fetch your Eulerian audience segments for targeting.

• How frequently does Wingify check if a user is in an Eulerian audience for targeting?
  Audience membership is typically checked in real-time when the Wingify campaign targeting conditions are evaluated as the visitor loads the page. However, there might be slight delays depending on how quickly Eulerian updates its audience data and how Wingify fetches and evaluates it.