VWO Event Streamer is a custom tag template that you can import into your GTM account in order to stream custom events from GTM to VWO. This is an effortless approach if you just require fetching custom events from GTM to VWO. You just need to install the VWO streamer as a template on GTM and configure the events to be sent to VWO 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 VWO 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 simply 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 VWO just like that. 

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

Installing VWO Event Streamer on GTM

Download the VWO Event Streamer tag template from here, extract the files and perform the following steps to install the VWO Event Streamer on GTM:

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

3. On the Template Editor page, click on the vertical ellipsis (⋮) and select Import.

4. Browse for template.tpl from the VWO Event Streamer files that you’ve downloaded and select it. The template is uploaded to GTM. 
5. Click Save to complete the import of the VWO Event Streamer template.

Using the VWO Event Streamer Template

Upon successful import, you can use the VWO Event Streamer template to stream the events from GTM to VWO 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 on 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. Should you require excluding any event or event property from being forwarded to VWO, you shall use the Exclude following events and the Exclude following properties settings, respectively.

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

6. Name the trigger and click on the Trigger Configuration section.
7. We recommend using the following trigger settings to stream all the events to VWO. Configure your trigger settings as follows and click on Save:

1. 1. In the Trigger Type field, select Custom Event.
   2. In the Event name field, enter “.*”.
   3. Select the Use regex matching option.

8. Click Save.

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

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

Click Save.