.png%3Falt%3Dmedia%26token%3D6deff902-b475-4b95-bffc-b313f43260b5)
.png%3Falt%3Dmedia%26token%3D6deff902-b475-4b95-bffc-b313f43260b5)
Google Analytics Widget Events
The Visual UGC Google Analytics Plugin allows for customers to easily track key events / interactions with their Visual UGC Content and Map Widgets within their Google Analytics instance. These events are stored as behaviours within the Analytics tool, however can be used to help build out Segments which identify the impact of the Widgets on Users and their respective Sessions across the Digital Properties.
The Google Analytics Plugin has been built to track thirteen key events / interactions across the Visual UGC Content and Map Widgets. Each Event that is stored in Google Analytics will have an Event Category and Event Action, with all bar Widget Load and Load More having an Event Label.
Visual UGC, by default, groups Event Categories based upon the Widget and Filter that they have been instigated from. Whilst this can be changed within the plugin, it allows for brands to determine what Widget and Filter is 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:
Event | Description | Event Category | Event Action | Event 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} |
The Visual UGC Google Analytics Plugin comes with a series of configuration options which are designed to allow for organisations to ensure that the reporting data sent from Visual UGC is consistent with the manner in which they like to report in Google 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.
The Tracking ID is where you can add the Google Analytics Universal Analytics (UA) Identifier so the Visual UGC Widget known which Google Analytics Property to send the Event Data to. The UA-ID can be set at a Visual UGC 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.
Google 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.
As defined above, by default, all Events sent by Visual 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 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 Visual UGC under a single Category name (ie. Visual UGC) or on a per Widget basis based upon their reporting needs.
As defined above, by default, all Event Labels sent by Visual 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.
Naturally the Visual UGC Google Analytics Plugin isn't for all of our clients, with some organisations preferring to define how Events are sent to their Google Analytics instance or wanting to send completely custom events to their Analytics instance. Fortunately for those customers, Visual UGC supports both.
The data sent to Google Analytics via the Visual UGC Google 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 organisations 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.
Visual UGC’s Global Widgets API empowers users to feed their favourite Analytics tools with useful interaction information from their Visual UGC Widgets based upon common user behaviour.
These common events relate to items such as Expanding a Tile, Loading more Content or Clicking on a Shopspot link, and are based upon 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 onto Google Analytics, we recommend following this guide.
Last modified 2mo ago