Integrate Wingify with Piano Analytics

This article covers the following:

• Overview
• Before You Begin
• Create a Piano Connection in Wingify
  • Send Campaign Data to Piano Analytics
    • Specifications of Wingify Campaign Data Sent to Piano Analytics
  • Import Segments from Piano Analytics
    • Use Piano Segments for Visitor Targeting
• Verify the Integration Setup
• Create a Report in Piano Analytics Using Wingify Data

Overview

Piano Analytics, formerly AT Internet, is a platform that helps businesses understand how visitors interact with their brand across various platforms and touchpoints. It does this by collecting and analyzing data on visitor behavior, allowing companies to optimize their digital experiences.

Integrating Wingify with Piano Analytics enables you to send campaign and variation data from Wingify to Piano Analytics. You can use this data to create audience segments, analyze visitor behavior, compare performance across campaign variations, and gain deeper insights using Piano Analytics reporting and analytics capabilities.

Before You Begin

• You have an active Piano Analytics account.
• The Wingify SmartCode and Piano Analytics analytics code are implemented on your webpage.

Create a Piano Connection in Wingify

Wingify supports the following Piano Analytics connection types:

• Send campaign data to Piano (Push based): Send Wingify campaign and variation data to Piano Analytics for reporting and analysis.
• Import Segments from Piano (Targeting): Import Piano segments and use them for visitor targeting in Wingify campaigns.

To create a Piano Analytics connection in your Wingify account:

1. Log in to your Wingify account.
2. Navigate to Configurations > Integrations.
3. Click the Piano Analytics 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 Piano Analytics integration page.

Send Campaign Data to Piano Analytics

Use this connection type to send Wingify campaign and variation data to Piano Analytics for reporting and analysis.

To configure the connection:

1. Click Create Connection and select Send campaign data to Piano Analytics.
2. Enter a value in the Connection Name field.
3. Optionally, enter a value in the Wave field.
4. Click Create Connection.

Specifications of Wingify Campaign Data Sent to Piano Analytics

Wingify sends campaign data to Piano using the following format:

Event name: wingify

Properties:

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

Note: target_id and target_name are available only when using the Personalize Holdback feature.

Import Segments from Piano Analytics

Feature Availability: Available starting with the Wingify Pro plan.

Use this connection type to import Piano segments into Wingify for visitor targeting.

To configure the connection:

1. Click Create Connection and select Import Segments from Piano.
2. In the Create Connection form, enter a name in the Connection Name field.
3. Click Create Connection.

Once the connection is created, you can manage your synced segments from the Active Connections section.

To add Piano segments:

1. Under Active Connections, click the three-dot menu (⋮) next to your connection and select Manage Segments.
2. The segments screen appears, listing all synced segments with their Segment Name, Last Synced On date, and Sync Status. You can click Sync all to trigger a sync for all segments.
3. To add a new segment, click Add segment.
4. In the Add Piano Segment modal, enter the Segment key in the field provided.
5. Click Add.

Use Piano Segments for Visitor Targeting

Once segments are synced, you can use them for visitor targeting while creating campaigns.

To set it up:

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 and create a segment using the imported Piano segment as your targeting condition.

1. To add multiple conditions, click Add another condition. You can define the logical relationship between conditions using the And/Or operators and use brackets to organize the segment condition.
2. Once done, click Save Segment.
3. In the popup that appears, enter a name for the segment, optionally add a description, and click Save.
4. 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 Piano Analytics 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 “event?” to filter the network calls for Piano Analytics.
3. The network calls get populated as the page loads. You may reload the page to view the network calls.

4. 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

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

Create a Report in Piano Analytics Using Wingify Data

Piano Analytics provides you with a plethora of different preset parameters that help you measure almost various events on your website. You can simply import your Wingify data into Piano Analytics and create a custom report using the preset report options in a few easy steps.

Let’s say you’re looking to check if the number of unique visitors, as shown in Wingify, is also reflected in your Piano Analytics account. To do so, perform the following steps:

1. On your Piano Analytics dashboard, click on the four squares icon at the top-right corner and go to Analysis > Data Query.
2. Click on the Date filter and set the required date range.
3. Click on the Segment filter to configure the segmentation criteria.
4. Click on the Visits dropdown and select Events.
5. Click on the ADVANCED MODE button.
6. Open the All properties dropdown, search for MVT, and select the MVT-Test option to fetch the list of Wingify campaigns that are exported to Piano. In the last dropdown, select the required campaign.
7. Click on the Add a property link and repeat the previous step to select the MVT-Variant option and select the appropriate variation.

Need more help?

For further assistance or more information, contact Wingify Support.