Widget Events

The Nosto's UGC Google Universal Analytics Plugin allows customers to easily track key events/interactions with their UGC Content and Map Widgets within their Google Universal Analytics instance. These events are stored as behaviors within the Analytics tool, however, can be used to help build out Segments that identify the impact of the Widgets on Users and their respective Sessions across the Digital Properties.

Events

The Google Universal Analytics Plugin has been built to track thirteen key events/interactions across the UGC Content and Map Widgets. Each Event that is stored in Google Universal Analytics will have an Event Category and Event Action, with all bar Widget Load and Load More having an Event Label.

Nosto's UGC, by default, groups Event Categories based on the Widget and Filter that they have been instigated from. Whilst this can be changed within the plugin, it allows brands to determine what Widget and Filter are driving interactions. Event Actions are the specific action that has been performed by the user / Widget, whilst Event Label contains more granular detail such as Tile ID.

Full details of each of the Event is listed below:

EventDescriptionEvent CategoryEvent ActionEvent Label

Widget Load

Triggered after the widget has been loaded

Widget {WidgetID}, Filter {FilterID}

Load

Load More

Triggered after the more tiles have been loaded

Widget {WidgetID}, Filter {FilterID}

Load more

Impressions

Triggered for each Tile that is loaded on a page

Widget {WidgetID}, Filter {FilterID}

Impression

tile_id: {TileID}, source: {Network}, media: {MediaType}, user: {Userhandle}, url: {OriginalURL}

Tile Expand

Triggered after the Tile opens

Widget {WidgetID}, Filter {FilterID}

Tile expand

tile_id: {TileID}, source: {Network}, media: {MediaType}

Share Click

Triggered after the click of sharing buttons

Widget {WidgetID}, Filter {FilterID}

Share click

tile_id: {TileID}, source: {Network}, media: {MediaType}, share_network: {Network}

Username / User Handle Click

Triggered after the click of the user links

Widget {WidgetID}, Filter {FilterID}

Username or Handle click

tile_id: {TileID}, source: {Network}, media: {MediaType}

Map Pin Click

Pin click

Widget {WidgetID}, Filter {FilterID}

Pin click

latitude: {Latitude}, longitude: {Longitude}

Shopspot Flyout

Triggered after the Shopspot Flyout opens

Widget {WidgetID}, Filter {FilterID}

Shopspot flyout

tile_id: {TileID}, source: {Network}, media: {MediaType}, product_tag_id: {TagID}, ext_id: {ExternalProductID}

Shopspot Button Click

Triggered after the Shopspot CTA button has been clicked

Widget {WidgetID}, Filter {FilterID}

Shopspot action click

tile_id: {TileID}, source: {Network}, media: {MediaType}, product_tag_id: {TagID}, ext_id: {ExternalProductID}

Product Button Click

Triggered after the Product CTA button has been clicked

Widget {WidgetID}, Filter {FilterID}

Product action click

tile_id: {TileID}, source: {Network}, media: {MediaType}, product_tag_id: {TagID}, ext_id: {ExternalProductID}

Likes

Triggered after the Like button has been clicked

Widget {WidgetID}, Filter {FilterID}

Like

tile_id: {TileID}, source: {Network}, media: {MediaType}, user: {Userhandle}, url: {OriginalURL}

Dislikes

Triggered after the Dislike button has been clicked

Widget {WidgetID}, Filter {FilterID}

Dislike

tile_id: {TileID}, source: {Network}, media: {MediaType}, user: {Userhandle}, url: {OriginalURL}

Votes

Triggered after the Vote button has been clicked

Widget {WidgetID}, Filter {FilterID}

Vote

tile_id: {TileID}, source: {Network}, media: {MediaType}, user: {Userhandle}, url: {OriginalURL}

Configurations

The Nosto's UGC Google Universal Analytics Plugin comes with a series of configuration options which are designed to allow for organisations to ensure that the reporting data sent from Nosto's UGC is consistent with the manner in which they like to report in Google Universal Analytics.

The configurations, which can be customised at both a Stack level or per Widget level, include:

  • Tracking ID

  • Non-Interaction

  • Custom Event Category Name

  • Store Event Labels as Original URLs

Details on each of these is available under their respective headings below.

Tracking ID

The Tracking ID is where you can add the Google Universal Analytics (UA) Identifier so the UGC Widget known which Google Analytics Property to send the Event Data to. The UA-ID can be set at a stack level via the Google Analytics Plugin on your Stack, or on a per Widget level under the Google Analytics tab, allowing brands to send different event data to different properties.

Non-Interaction

Google Universal Analytics, by default, considers whenever a user visits a page and triggers an event that they are not a bounce. This is regardless of whether the user has previously visited any other page in their session or goes on to perform another action.

The parameter, nonInteraction, changes this behaviour so a bounce will still be recorded even if an Event is triggered.

This parameter can be set on an event to event basis.

Custom Event Category Name

As defined above, by default, all Events sent by Nosto's UGC contain both the Widget ID and Filter ID in the Event Category name (Widget {WidgetID}, Filter {FilterID}). As such, whenever a user goes to view the Events within their Google Universal Analytics account, under the Category page these will be separated based upon the number of different Widgets and Filters being used on the property.

The Custom Event Category Name allows for organisations to either group all Events from UGC under a single Category name (ie. Visual UGC) or on a per Widget basis based upon their reporting needs.

Store Event Labels as Original URLs

As defined above, by default, all Event Labels sent by Nosto's UGC include granular details such as Tile ID, Source and Media Type. This configuration, if enabled, will send the associated UGC Tile's Media URL versus the previous data.

Custom Events

Naturally, the Nosto's UGC Google Universal Analytics Plugin isn't for all of our clients, with some organizations preferring to define how Events are sent to their Google Universal Analytics instance or wanting to send completely custom events to their Analytics instance. Fortunately for those customers, Nosto's UGC supports both.

Send Events via Custom Javascript

The data sent to Google Universal Analytics via the Nosto's UGC Google Universal Analytics Plugin is naturally pre-set and configuration is limited to choosing which Widgets you want to track and the specific interactions you want to track on them. For those organizations who would rather track data relating to Visual UGC Javascript Events which are currently not supported by the Plugin, or for those who wish to change what data is sent, we recommend following this guide.

Bind and Create Custom Events

Nosto's UGC Global Widgets API empowers users to feed their favorite Analytics tools with useful interaction information from their UGC Widgets based on common user behavior.

These common events relate to items such as Expanding a Tile, Loading more Content, or Clicking on a Shopspot link, and are based on the areas our users have wanted to track the most.

Now whilst these ‘Events’ cover the most common areas a client may wish to track, there are always scenarios where you need to track the less common areas and thus need to be able to create your own events.

To help customers bind these 'Events' and send them to Google Universal Analytics, we recommend following this guide.

Return to Top