Feature availability: Import Amplitude Cohorts into Wingify for Campaign Targeting is not supported in the EU region. All other Wingify-Amplitude integration capabilities, including pushing Wingify data to Amplitude and enabling analytics-driven experimentation, are fully supported across all regions.
This article covers the following:
Overview
Amplitude is a product analytics platform that uses collaborative analytics to help organizations track visitor behaviour. The platform employs behavioural reporting to better understand how users interact with products and deliver real-time insights to speed up work in real-time. It helps businesses grow by using conversion and retention metrics.
Before You Begin
- You have an active Amplitude account.
- The Wingify SmartCode is installed on your website.
- The Amplitude JS/Web SDK is implemented on your webpage.
Note: These steps are exclusive to Amplitude JS/Web SDK. If you're using an Amplitude JS/Web SDK node package manager, you must use the Wingify Amplitude integration plugin to implement this integration. Remember that the integration performed via the node package manager does not allow you to choose the campaign data to be sent from your Wingify account to Amplitude. It streams all of the active campaign data from Wingify to Amplitude.
Create an Amplitude Connection in Wingify
Wingify supports the following Amplitude connection types:
- Send campaign data to Amplitude: Sends Wingify campaign and variation data to Amplitude for reporting and analysis.
- Send survey data to Amplitude: Allows you to analyze and report on Wingify survey responses in Amplitude.
- Import Cohorts from Amplitude : Allows you to target visitors in Wingify using Amplitude Cohorts. For more information, refer to Import Amplitude Cohorts into Wingify for Campaign Targeting .
To create an Amplitude connection in your Wingify account:
- Log in to your Wingify account.
- From the left panel, navigate to Configurations > Integrations.
- Click the Amplitude integration tile and click Create Connection.
- Select the type of connection you want to configure.
All configured connections appear under the Config > Active Connections section on the Amplitude integration page.
Send Campaign Data to Amplitude
Use this connection type to send Wingify campaign and variation data to Amplitude for reporting and analysis.
To configure the connection:
- Click Create Connection and select Send campaign data to Amplitude.
- Enter a name in the Connection Name field and click Create Connection.
After creating the connection, Wingify campaign data is automatically sent to Amplitude for new campaigns. To enable it for existing campaigns, go to Web Experimentation, select your campaign, go to Configuration > Integrations, and select Amplitude.
The campaign visitor data is shared via the campaign ID, while the variation-level visitor data is shared via the variation ID.
Specifications of Wingify Experiment Data Sent to Amplitude
When a visitor becomes part of a Wingify campaign, Wingify sends the following events to Amplitude:
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}"
}Note: The target_id and target_name properties are optional. These values are available only when using the Personalize Holdback feature and may not be present for all campaigns.
Event name: wingify (identify)
User properties
Test: {CAMPAIGN_NAME} ({CAMPAIGN_ID})
Variation: {VARIATION_NAME} ({VARIATION_ID})Viewing Reports in Amplitude
To view reports in your Amplitude dashboard, you first need to create an event. Here’s how you can create one:
Note: If you want to view the report for an existing event, you can go to My Workspace > Saved Content and select the chart for which you want to view the report.
- Log in to your Amplitude account. The Amplitude dashboard appears.
- From the top panel, click Create to create a new chart and click Chart > Segmentation.
- From the events section, click on Select event... and select Wingify under Uncategorized.
- Use the following event properties to filter or break down your report:
- campaign_name
- campaign_id
- variation_name
- variation_id
- target_name
- target_id
5. After this, the report is displayed at the bottom of the page. To save your chart, click Save on the top right.
Note: If a visitor's event property or custom user property is counted under None or shows an unexpected value, refer to this article.
Find Your Wingify Test Campaign ID
You can find the campaign ID directly in the Web Experimentation dashboard. The ID column displays the campaign ID for each campaign in the list.
Alternatively, to find your campaign ID at the campaign level, go to Review, scroll down to the Other Information section and check the Campaign ID.
Send Survey Data to Amplitude
Use this connection type to send Wingify survey responses to Amplitude for analysis.
To configure the connection:
- Click Create Connection and select Send survey data to Amplitude.
- Enter a name in the Connection Name field.
- Click Create Connection.
Once this connection is configured, you can choose to send Wingify survey data to Amplitude at the campaign level. By default, the Amplitude integration is enabled for new Wingify surveys campaigns.
To enable the Amplitude integration for campaigns:
- Go to Pulse > Surveys.
- Select the Surveys campaign, go to Settings > Advanced Options > Others, and select Amplitude under Integrate with third-party products.
Access Wingify Surveys Data in Amplitude
Wingify starts sending your Wingify Surveys data to Amplitude as soon as a visitor attends your survey. This data is received in Amplitude as events. You can use these events to create several reports in Amplitude. For example, you can use the Wingify-survey-answer-submitted event to create a report as follows:
- Log in to your Amplitude dashboard.
- Click Create > Chart > Data Table.
- Click the Add Event or Metric button and select Wingify-survey-answer-submitted. This creates a data table featuring the overall number of survey answers submitted.
- To view the number of answers question-wise, click Select property in the Overall cell and select QuestionText.
- Furthermore, you can view the breakdown of the number answer-wise by grouping each question by Answer.
Additionally, you can add survey activities such as Survey started and Survey completed to build funnels based on these events to enhance visitor engagement further.
Import Cohorts from Amplitude
Use this connection type to import Amplitude cohorts into Wingify and use them for campaign targeting.
To configure the connection:
- Click Create Connection and select Import Cohorts from Amplitude.
- Enter a name in the Connection Name field.
- Click Create Connection.
After the connection is created, Wingify generates an API key for the connection. To view the key, click the corresponding three-dot menu (⋮) and select Edit.
Use this API key when configuring the Wingify destination in Amplitude. If you have multiple Amplitude connections, ensure that you use the API key associated with the correct connection.
For detailed setup instructions, refer to Import Amplitude Cohorts into Wingify for Campaign Targeting.
Need more help?
For further assistance or more information, contact Wingify Support.