Working with Events in Wingify

This article covers the following:

• Overview
• How do Events work?
• Types of Events in Wingify
• Create Events in Wingify
• Install the Custom Event Code
• Manage Events in Wingify
• Use Events in Wingify
  • Target Visitors Using Events in Wingify
  • Segment Reports Using Events in Wingify

Overview

Any action performed by the visitor on the website or any web application is referred to as an Event. This can be a click on an offer banner, making a payment, scrolling down the page, etc. Each event is given a name and a set of properties to add more context to the event. These events are used for targeting visitors for your campaigns and filtering your campaign reports.

For example, To analyze visitors’ shopping behaviour on an eCommerce website, you can create an event to capture the cart additions and associate properties like “product ID”, “cart value”, etc, to capture additional context. Once you have this information, you can use this event to target visitors for your Wingify campaigns and segment visitors to filter your campaign reports.

How do Events work?

• You create an event in Wingify Data360 and also define the event by adding properties.
• This event needs to be linked to your website, web app or mobile application to capture the event whenever it is triggered. It requires a custom code to be installed on your website, applied with the required variables to capture the event and any property associated with it. Once ready, Wingify starts collecting the information corresponding to the event.
• The event can now be used to track visitor behavior and target visitors for your campaigns, as well as to segment your visitors to filter the report data.

Types of Events in Wingify

In Wingify, Events are of the following two types:

• STANDARD EVENTS: These are predefined events on the Wingify platform and can be used in campaigns and metrics, such as Page scroll, Form submit, etc. Wingify provides the following standard events:

• MY EVENTS (Custom Events): These are the ones that you can create and configure based on your specific business needs. For example, a Product Manager at an eCommerce business may want to track all the cart additions and convert them into transactions. To make this possible, they need to attend to those visitors that abandon the cart. In such a scenario, they can create a custom event in the name, "Abandon Cart" and configure it to be used in their campaign to target those visitors to accomplish the purchase.
• UNREGISTERED EVENTS: These are the events that are captured by Wingify from your website but not found registered in Wingify. At times, instead of creating an event on the Wingify platform, you would use the custom code of an event and tweak it to become another to be tracked on your website. Sometimes, such unregistered events may also come into Wingify from a third-party integration. In such cases, you may not be able to use the data of those events for any analysis or segmentation. But Wingify captures such events and brings them to you, so you can choose to have them registered in Wingify. If you’re passing an event to Wingify that you have not created under MY EVENTS, Wingify captures it and displays it under UNREGISTERED EVENTS.

Clicking on these events will reveal the following information:

You can choose to save these events to Wingify by clicking on the Register Event button at the top-right. This will allow you to configure the event properties and save them under MY EVENTS.

Note: In case of passing a new property to an event that is already present under MY EVENTS, Wingify will capture and display them under the Unregistered Properties section in the Properties tab of the corresponding event.

• ARCHIVED EVENTS: If you are no longer using a custom event, you can clear up the space by archiving it. Such events appear under the ARCHIVED EVENTS section. The number of archived events will also be displayed along with the section name in parentheses.

Any existing campaign that has been using these archived events will continue to use them. These archived events will appear in the visitor segmentation section of the existing campaigns with an ‘ARCHIVED’ tag. However, these events will not be available for a new campaign or any existing campaign that hasn’t yet used them. To learn how to archive an event, click here.

• COMPUTED EVENTS: Computed events help you track complex user behaviors by combining multiple events into a single custom event. This makes it easier to define advanced metrics, build funnels, and gain deeper insights into user actions. For more information, refer to computed events.

Create Events in Wingify

Let’s say you want to create an event to capture the failed payments, which might be due to multiple reasons such as declined payment, visitor’s session ended, delayed response of your website’s server, etc. To know about this, you need to create an event capturing the failed payments and set up all the possible reasons as its properties. To do so, from the main menu panel, access Data360 > Events. Click +Create and enter the details in the following fields:

Under the Properties section, enter the details in the following fields that help you track those payment skips:

If you wish to add a description to the event property, use the Description field that can be accessed by clicking on the vertical ellipsis (⋮) > Configure. Once done, click Save.

You can associate multiple properties to an event by using the Create New Property option. NOTE: By default, Wingify anonymizes personal data such as email address, credit card number, passwords, SSN, and IP address. The masked list adds further anonymization, while the unmasked list removes it. Use the unmasked list with caution.

Post configuring, click Create. The created custom event appears in the MY EVENTS section on the left.

Install the Custom Event Code

In order for the event tracking to be enabled, you need to install the custom code snippet on your website or web application. To do this, perform as follows:

• Clicking on a custom event displays the details of the same along with a custom code snippet.
• The code snippet is available for the web version (browser-based) and SDKs [for Feature Management and Experimentation (FME)].
• These code snippets contain the placeholders for the property variables, which need to be applied in the respective places. This ensures that each time the event is triggered, it captures the variable data from your website and stores them in Wingify. These variables differ with the type of code; hence you need to apply the variables correspondingly.
• To create custom events for feature rollouts, testing, or personalization, refer to the implementation steps for the following supported SDKs. Each link guides you through setting up custom events for the respective platform.
  • Node.js
  • Java
  • PHP
  • Python
  • .NET
  • GO
  • Ruby

• Click on the Copy Code icon at the top-right corner of the code snippet box to copy the code.
• After initializing the Wingify SDK and the corresponding variables into your code repository, use this code in your application to enable this custom event for pre-campaign segmentation.

Manage Events in Wingify

Once an event is created, you can modify or clone the same based on your need. To do so, select the custom event that you wish to work on, click on the vertical ellipsis icon at the top-right, and perform the required action as follows:

Note: A custom event, once created, cannot be deleted.

To Edit - Click on the Edit option, make the required changes, and click Save.

Note: The existing inputs in the API Name and the Default Type fields cannot be modified.

• To Clone - Click on the Clone option, enter the Event Name and the API Name, apply the required changes, and click Create. The cloned event appears in the MY EVENTS section on the left.
• To Archive - Click on the Archive option, and in the confirmation popup that appears, click Archive. Now the archived event will be moved from the MY EVENTS section to the ARCHIVED EVENTS section. You can always review the properties of an archived event by clicking on it. An archived event can be edited just like any custom event, cloned into a new custom event, or unarchived to be used again in your campaigns. To unarchive, select the archived event, click on the vertical ellipsis icon that appears at the top-right, and select the Unarchive option. In the confirmation popup that appears, click on the Unarchive button. Now, the custom event will be moved from the ARCHIVED EVENTS section to MY EVENTS.

Use Events in Wingify

Events can be used for targeting visitors in your Wingify campaigns as well as for creating segments for your campaign reports. Having created an event to capture the failed payments. You can now use the same in two different places.

• You can use this event in your campaign to target those visitors who encountered payment failures so as to offer them an alternative payment method or even a special waiver to encourage them to accomplish the purchase.
• After the campaign has been executed, you can view its progress in the campaign reports. Here, you can analyze the success of your campaign by creating a filter to segment the report data corresponding to those visitors who have accomplished the purchase.

Targeting Visitors Using Events in Wingify

To apply events for pre-segmentation purposes in your campaigns, perform the following steps:

1. For Wingify Testing and Wingify Personalize campaigns, once you have set up the campaign URL, access More Options > Enable campaign for a specific visitor group > Custom Segment.
2. Now, create a custom segment where you want to track all the visitors who performed the given action. In the first dropdown, select an event and click + where to define the property. In the dropdown corresponding to where, select an appropriate property, in the next dropdown, set the relation, and enter/select the required value correspondingly in the last field. To add more properties, click + and where.. to define them.
3. Upon request, you can also avail of the ability to configure the events further to fine-tune the targets.

In the dropdown corresponding to any time, you can select one of the following options as required:

• in current session - This allows you to filter the events that are specific to the current session.

• in the last <number> day(s) - You can specify the number of days to filter the events that occurred at any time in those days.

For example, consider that you launched a new product a week ago. Unfortunately, the delivery time is longer than usual. Now, you identify that a considerable number of your visitors have become hesitant to purchase it because of that. To mitigate it, you’re planning to run a campaign that slashes delivery costs to win back their patience. For this, you can target visitors who have attempted to make a purchase but abandoned their cart.

Now, you can actually extend this campaign to the potential population by targeting it using the aggregate function filter, which can be accessed by clicking +fx along the value field. Using this, you can granularize your revenue value to be more precise with the following options:

4. You can add more conditions by clicking Add another condition.
5. Once done, click Save Segment to apply the targeting condition for your campaign.

Segment Reports Using Events in Wingify

To apply events for post-segmentation purposes in your A/B test campaign, click on the Wingify campaign you want to look into and go to Report > All Visitors > Custom Segment. You can follow step 2, mentioned in the Targeting Visitors Using Events in Wingify section to create a segment for your report.

For more information, refer to Working with Metrics in Wingify.

Need more help?

For further assistance or more information, contact Wingify Support.