Visiolink's 12 Standard events in GA4

2023-01-13 08:12:56 UTC

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:

  1. vl_event_download
  2. vl_event_publication
  3. vl_event_page
  4. vl_event_article_end
  5. vl_event_search
  6. vl_event_interstital_impression
  7. vl_event_interstital_click
  8. vl_event_hotspot_impression
  9. vl_event_hotspot_click
  10. vl_event_audio_end
  11. vl_event_podcast_end
  12. 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.

 

 

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_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 View, My 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.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments