Stream Events From GTM to Wingify

This article covers the following:

• Overview
• Install VWO Event Streamer on GTM
• Use the VWO Event Streamer Template
• Supported Event Formats
• Configure Custom Datalayer Variable Name in Google Tag Manager

Overview

VWO Event Streamer is a tag template that you can add from the GTM Template Gallery in order to stream events from GTM to Wingify. This is an effortless approach if you just require fetching custom events from GTM to Wingify. You just need to install the VWO Streamer as a template on GTM and configure the events to be sent to Wingify from GTM.

Let’s say you have created tags in GTM for events such as “Add to Cart”, “Proceed to Checkout”, and “Purchase”, and you use these events in your Google Analytics account. Now, you’re looking to import the same events into Wingify to run a campaign for gauging the sellability of a certain product. Don’t worry; you needn’t get into extensive integration here. You can install the VWO Event Streamer and add it as a custom template to your GTM account. This streams all your custom events from GTM to Wingify just like that.

If you require more capabilities, such as transferring campaign data from Wingify to GTM or targeting visitors in your Wingify campaigns using a GTM data layer variable, you need to integrate your Wingify account with GTM.

NOTE:

• The VWO Event Streamer setup is exclusively applicable to Data360 accounts.
• To send GTM events to Wingify using the GTM event streamer, ensure the Wingify SmartCode is integrated on all pages that trigger GTM events.

Install VWO Event Streamer on GTM

Perform the following steps to install the VWO Event Streamer on GTM from the template gallery:

1. Log in to your GTM account and select the appropriate workspace where you want to install the VWO Event Streamer.
2. From the main menu on the left, go to Templates > Tag Templates > Search Gallery.

3. Search for VWO and then click VWO Event Streamer.
4. Click Add to workspace.

5. Click Add.

Use the VWO Event Streamer Template

Upon successful import, you can use the VWO Event Streamer template to stream the events from GTM to Wingify effortlessly. To do that, perform the following steps:

1. From the main menu on your GTM dashboard, navigate to Tags > New.
2. Name the tag and click the Tag Configuration section.
3. From the list of tags, under the Custom section, select the VWO Event Streamer tag that you just imported.

4. To customize the tag configuration further, you can utilize the following options:
   • Nested JSON Field Mapping: Allows you to import event properties with JSON nested values into Wingify. To do this, click Add Nested Field Mapping and enter the input in the respective fields as follows:
     • Property Name: The name of the property you want to map.
     • JSON Key Path: The path to the key in the JSON object. Example JSON Key Paths: 
       • For an object such as { "user": { "id": 123, "name": "John Doe" } }, if you want to map the user's name, the JSON key path to use is user.name.
       • For an object containing an array, such as { "items": [ { "id": 1, "name": "Item1" }, { "id": 2, "name": "Item2" } ] }, if you want to map the name of the first item in the array, the JSON Key Path to use is items.0.name.
   • Custom Property: Allows you to add custom properties that will be sent with every event. To add a custom property, click Add New Property and enter the input in the respective fields as follows:
     • Property Name: The name of the custom property.
     • Property Value: The value of the custom property.
   • If you need to exclude any event or event property from being forwarded to Wingify, you can use the Exclude following events and the Exclude following properties settings, respectively.

5. Click the Triggering section, and click the + icon at the top-right to create a new trigger.

6. Name the trigger and click the Trigger Configuration section.
7. We recommend using the following trigger settings to stream all the events to Wingify. Configure your trigger settings as follows and click Save:
   1. In the Trigger Type field, select Custom Event.
   2. In the Event name field, enter “.*”.
   3. Select the Use regex matching option.

Now, your website events from GTM will be streaming into the UNREGISTERED EVENTS section under Events in your Wingify Data360 module. You can use these events to set up your campaign triggers, create metrics, and target the visitors for your campaigns.

Supported Event Formats

The VWO Event Streamer only supports events that are directly pushed into the dataLayer or triggered through gtag. Therefore, ensure that your events are structured in one of these formats for them to be successfully imported into Wingify:

Pushing Events Directly into dataLayer

dataLayer.push({
"event": "event_name"
});

Triggering Events Through gtag

gtag("event", "event_name");

Configure Custom Datalayer Variable Name in Google Tag Manager

By default, GTM is set up to access events from your datalayer variable if it's named 'dataLayer.' If you use a different datalayer variable name, follow these steps to specify your dataLayer variable name in GTM. This allows GTM to recognize and stream your events:

1. From your GTM dashboard, access Templates > Tag Templates > VWO Event Streamer > Code.

2. In the code, replace “dataLayer”, corresponding to const DATALAYER_VARIABLE_NAME, with your custom datalayer variable name and click Save.

3. Go to Permissions > Accesses global variables > Add key.
4. In the Key field, enter the name of your custom datalayer variable, select Read, and click Add.

3. Click Save.

Need more help?

For further assistance or more information, contact Wingify Support.