This article only covers our tracking for News Modules apps and not Modular Apps.
You can read our Modular App Tracking documentation for apps here:
https://support.visiolink.com/hc/en-us/articles/21445515663762-Modular-App-Tracking-Apps-GA4
At Visiolink we have defined 12 standard events that is key data for your e-paper application. These standard events are custom event that Visiolink have set up and sends to Google Analytics 4. You will receive the same data from Visiolink in GA4 as in GA3. However, the structure and naming are different. This article will go through each of Visiolink's standard events and which additional parameters that follow each event in GA4.
The structure in GA4 consist of event name, parameters, and user properties. The event name is the naming of each of Visiolink's 12 standard events. Parameters and user properties is additional information that follows the event name. The difference between parameters and user properties is that parameters can change values throughout a session where user properties would stay the same and is the same across all events in a session.
The custom user properties that follow all 12 events are:
|
Dimension Name |
Code |
Description |
|
App_id |
vl_value_app_id |
Name of the app/bundle id/application id |
|
Client |
vl_value_client |
Platform: iOS, Android, Desktop, Desktop Web App, Fallback |
|
Client_id |
vl_value_client_id |
Unique hashed id |
|
User_id |
vl_value_user_id |
Unique id that can be connected through the SSO or just be a hashed id |
|
User_id_source |
vl_value_user_id_source |
Takes the values: Custom, Server or Client - Depends on how the user id is created. |
|
Version |
vl_value_version |
Generic platform version |
|
Push_token |
vl_value_push_token |
Unique id for each device/app downloads (only on apps) |
*You can read more about the user_id format here.
Standard Events and Parameters
Visiolink 12 standard events in GA4:
- vl_event_download
- vl_event_publication
- vl_event_page
- vl_event_article_end
- vl_event_search
- vl_event_interstital_impression
- vl_event_interstital_click
- vl_event_hotspot_impression
- vl_event_hotspot_click
- vl_event_audio_end
- vl_event_podcast_end
- vl_event_feed
Below you can read about the induvidual events and which paramters that follows each event.
- Download:
The Download event is triggered the first time a user downloads a publication.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_download |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder Id from Visiolink hub |
|
|
Publication_ID |
199 |
Unique id for the publication |
|
|
Publication_date |
2022-11-23 |
Publication date |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title – date |
|
|
Orientation |
Landscape |
Landscape or Portrait |
|
|
Login_type |
subscription |
How did the customer get access |
- Publication:
The Publication event is triggering every time a user opens a publication. Therefore, this event will trigger together with the download event the first time the user opens a publication, but also the next times the user opens the same publication.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_publication |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder Id from Visiolink hub |
|
|
Publication_ID |
199 |
Unique id for the publication |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Publication_source |
Newest Issue |
Archive, Downloads, Publication etc. |
|
|
Orientation |
Landscape |
Landscape or Portrait |
|
|
Section_number |
1 |
1,2,3 |
*Publication_source describes from where in the app the user opens a publication from. Therefore, the source values are very different from customer to customer related to the different possibilities from where in the app a publication can be opened from. You can read more about the publication_source here.
- Page:
The Page event is triggered every time a user swipes through an edition and is shown a page.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_page |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder Id from Visiolink hub |
|
|
Publication_ID |
199 |
Unique id for the publication |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Section_number |
1 |
1,2,3 |
|
|
Section_name |
1. section |
Can be named through the xml |
|
|
Orientation |
Portrait |
Landscape or Portrait |
|
|
Duration |
13 |
Secs spend on each page |
|
|
Page_number |
4 |
Page Number |
*Duration – The page duration will only send a duration if the user has spent more than 2 secs on the page. You can read more about the technical specification of page duration here.
- Search:
The search event is triggered every time a user do a search, either from an edition or from the search menu.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_search |
|
|
|
Parameters: |
Search_query |
Sun |
Search word |
|
|
Search_place |
Current |
Current (in a publication), Archive |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Orientation |
Portrait |
Landscape or Portrait |
- Interstitial impressions:
The interstitial impression event is triggered every time the interstitial is showed in a publication.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_interstitial_impression |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder id from Visiolink hub |
|
|
Publication_id |
199 |
Unique id for the publication |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Interstitial_name |
Sport 2022 |
Name of the interstitial from Visiolink hub |
|
|
Orientation |
Portrait |
Landscape or Portrait |
- Interstitial click:
The interstitial click event is triggered every time a user clicks on the interstitial.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_interstitial_click |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder id from Visiolink hub |
|
|
Publication_id |
199 |
Unique id for the publication |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Interstitial_name |
Sport 2022 |
Name of the interstitial from Visiolink hub |
|
|
Orientation |
Portrait |
Landscape or Portrait |
- Hotspot impression (clickable ads):
The hotspot impression event is triggered every time a user is on a page where a hotspot is present. Therefore, if a page has multiple hotspots an impression will be triggered for each hotspot.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_hotspot_impression |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder id from Visiolink hub |
|
|
Publication_id |
199 |
Unique id for the publication |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Hotspot_url |
https://visiolink.com |
URL of the hotspot |
|
|
Page_number |
12 |
Page of the hotspot |
|
|
Orientation |
Portrait |
Landscape or Portrait |
|
|
Section_number |
1 |
1,2,3,4 |
- Hotspot Click (clickable ads):
The hotspot click event is triggered every time a user clicks on a hotspot.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_hotspot_click |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder id from Visiolink hub |
|
|
Publication_id |
199 |
Unique id for the publication |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Hotspot_url |
https://visiolink.com |
URL of the hotspot |
|
|
Page_number |
12 |
Page of the hotspot |
|
|
Orientation |
Landscape |
Landscape or Portrait |
|
|
Section_number |
2 |
1,2,3,4,5 |
- Article:
The article event is triggered every time a user reads an article, either by clicking on the article or by zooming, double clicking, panning, etc. on the article. All these methods will active an article event. Then article events stops if a user zooms out closes the article or the app or is inactive (does not touch the screen) for more than 2 min.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_article_end |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder id from Visiolink hub |
|
|
Publication_id |
199 |
Unique id for the publication |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Article_Page_number |
12 |
Page of the hotspot |
|
|
Article_title |
Visiolink in Action |
From the xml |
|
|
Article_category |
Local |
From the xml |
|
|
Article_id |
96739201 |
From the xml |
|
|
Article_author |
Hans Hansen |
From the xml |
|
|
Article_characters |
4184 |
From the xml |
|
|
Article_source |
Article View |
Frontpage, Article List, Article View, Bookmark |
|
|
Article_method |
Click |
Click, Pan, Pinch, Double Click |
|
|
Orientation |
Landscape |
Landscape or Portrait |
|
|
Section_number |
2 |
1,2,3,4,5 |
|
|
Duration |
45 |
Secs spend on the article |
*You can read more about how the article event works here.
- Audio Article:
The Audio Article event is triggered every time a user plays an Audio Article.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_audio_end |
|
|
|
Parameters: |
Publication_customer |
Visiolink |
Prefix |
|
|
Publication_folder_id |
2945 |
Folder Id from Visiolink hub |
|
|
Publication_ID |
199 |
Unique id for the publication |
|
|
Publication_title |
Visiolink Magazine – 2022-11-23 |
Publication title + date |
|
|
Article_page_number |
12 |
Page of the article |
|
|
Article_title |
Visiolink in Action |
From the xml |
|
|
Article_category |
Local |
From the xml |
|
|
Article_id |
96739201 |
From the xml |
|
|
Article_author |
Hans Hansen |
From the xml |
|
|
Article_characters |
4184 |
From the xml |
|
|
Audio_source |
Frontpage, Article View, My Audio |
Where was the audio event triggered from |
|
|
Audio_type |
TTS, Narrated |
Describes the type of audio |
|
|
Orientation |
Landscape |
Landscape or Portrait |
|
|
Section_number |
2 |
1,2,3,4,5 |
|
|
Duration |
45 |
Secs spend hearing the audio article |
*Duration stops if the user pauses, close the player, close the audio article, close the app or the audio article ends.
- Podcast:
The Podcast event is triggered every time a user plays a Podcast.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_podcast_end |
|
|
|
Parameters: |
Podcast_title |
Visiolink News |
|
|
|
Podcast_channel |
Visiolink Podcast |
|
|
|
Podcast_length |
340 |
Seconds |
|
|
Podcast_author |
Hans Hansen |
|
|
|
Podcast_source |
Podcast |
Frontpage, My Audio, Podcast (menu) |
|
|
Duration |
340 |
Seconds listened to a podcast |
*Duration stops if the user pauses, close the player, close the app or the podcast ends.
- Live Feed:
The Live feed event is triggered every time a live feed article is read.
|
|
|
Example |
Description |
|
Event Name: |
vl_event_feed |
|
|
|
Parameters: |
Feed_title |
Visiolink News |
*This event is only available for customers who have a live feed environment in their app.
Comments