Modular App Tracking - DWA2 - GA4

2024-10-15 08:40:06 UTC

Our Desktop Web App 2 (DWA2) has also been aligned with our new standard events on Google Analytics 4. You can read more about our Modular App Tracking on apps here: https://support.visiolink.com/hc/en-us/articles/21445515663762-Guide-Modular-App-Tracking-GA4


The DWA2 does some things a bit different compared to our apps. For example, the DWA2 doesn't make any downloads, which means that there is no download event here. 


Standard Events in Google Analytics 4 for the DWA2 aligned with our Modular App:
1. vl_event_publication
2. vl_event_page
3. vl_event_article
4. vl_event_media
5. vl_event_search
6. vl_event_interstital
7. vl_event_hotspot
8. vl_event_module_interaction


This article is split into 2 sections:
1) User Parameters
2) Events

 

Section 1 - User Parameters

User Parameters are applied to all events are generally parameters that don't change often. The DWA2 differs from the apps by not having any push tokens. This is due to the DWA2 not being compatible with push messages.

Dimension Name

Description

Parameter (Code)

Example value(s)

App_id

Name of the app/bundle id/application id

vl_value_app_id

com.visiolink.vlqa

Client

Platform: iOS, Android, Desktop, Desktop Web App, Fallback

vl_value_client

Desktop, Desktop Web App, Fallback

Client_id

Unique hashed id

vl_value_client_id

8AA0F2E5-1234-5678-ABCD-E7EEDEE7AA49

User_id

Unique id that can be connected through the SSO or just be a hashed id

user_id

8AA0F2E5-1234-5678-ABCD-E7EEDEE7AA49

User_id_source

Takes the values: Custom, Server or Client - Depends on how the user id is created.

vl_value_user_id_source

Custom, Server, Client

Version

Generic platform version

vl_value_version

1.0.0

Orientation

Device Orientation: Landscape or Portrait

vl_value_orientation

Landscape, Portrait

 

Section 2 - Events

Publication event

Trigger: When a user opens a publication
Event name: vl_event_publication

Parameter Name

Description

Parameter (Code)

Example value(s)

Info

Contains prefix, folder id, and publication id. Return as a string separated by a slash "/" (prefix/folder id/publication id).

vl_value_info

visiolink/100/1000

Publication_title

Contains the publication title as see in the HUB.

vl_value_publication_title

Visiolink Title - 01/02/2024

Publication_date

Contains the publication date as see in the HUB.

vl_value_publication_date

2024-02-01

Source

Contains the source of the publication opening. "Where was the publication opened from"

vl_value_source

Newest Publication, Archive, Deeplink, Downloads

Section_number

Number from the section value

vl_value_section_number

1, 2, 3 …

Section_name

Name from the section value

vl_value_section_name

Section 1, Section 2, Section 3 …

 

Page event

Trigger: When a user is shown a page
Event name: vl_event_page

Parameter Name

Description

Parameter (Code)

Example value(s)

Info

Contains prefix, folder id, and publication id. Return as a string separated by a slash "/" (prefix/folder id/publication id).

vl_value_info

visiolink/100/1000

Publication_title

Contains the publication title as see in the HUB.

vl_value_publication_title

Visiolink Title - 01/02/2024

Publication_date

Contains the publication date as see in the HUB.

vl_value_publication_date

2024-02-01

Page_number

Contains the page number

vl_value_page_number

1, 2, 3 …

Section_number

Number from the section value

vl_value_section_number

1, 2, 3 …

Section_name

Name from the section value

vl_value_section_name

Section 1, Section 2, Section 3 …

 

For the page event we also send an event metric*:

Parameter Name

Description

Parameter (Code)

Example value(s)

Duration

Time spent in seconds

vl_value_duration

3, 4, 5 …

*If the user has spent more than 2 seconds on the page

 

Article event

Trigger: When a user reads an article by clicking on the article or by zooming or panning on the article. The article event stops if the user zooms out, closes the article, closes the app, or is inactive for more than 2 minutes
Event name: vl_event_article

Parameter Name

Description

Parameter (Code)

Example value(s)

Info

Contains prefix, folder id, and publication id. Return as a string separated by a slash "/" (prefix/folder id/publication id).

vl_value_info

visiolink/100/1000

Publication_title

Contains the publication title as see in the HUB.

vl_value_publication_title

Visiolink Title - 01/02/2024

Publication_date

Contains the publication date as see in the HUB.

vl_value_publication_date

2024-02-01

Page_number

Contains the page number

vl_value_page_number

1, 2, 3 …

Section_number

Number from the section value

vl_value_section_number

1, 2, 3 …

Section_name

Name from the section value

vl_value_section_name

Section 1, Section 2, Section 3 …

Title

Article Title from XML

vl_value_title

Lorem Ipsum

Category

Article Category from XML

vl_value_category

Local News, Regional News, Sport, Politics

ID

Article ID from XML

vl_value_id

4129799

Source

Contains the source of the article event. "Where was the article event triggered from"

vl_value_source

Article View, PDF, Search, Article Module, Bookmark, Deeplink

Method

Contains the method used to trigger the article event. "How was the article event triggered"

vl_value_method

Zoom, Click, Swipe

Length

Article character count

vl_value_length

500, 1000, 1500 …

Author

Article author from XML

vl_value_author

Lars Larsen

 

For the article event we also send an event metric*:

Parameter Name

Description

Parameter (Code)

Example value(s)

Duration

Time spent in seconds

vl_value_duration

3, 4, 5 …

*Starts after 2 seconds to avoid unwanted triggering.

 

Media event

Trigger: When a user triggers an audio article or a podcast
Event name: vl_event_media

Parameter Name

Description

Parameter (Code)

Example value(s)

Info

Contains prefix, folder id, and publication id. Return as a string separated by a slash "/" (prefix/folder id/publication id).

vl_value_info

visiolink/100/1000

Publication_title

Contains the publication title as see in the HUB.

vl_value_publication_title

Visiolink Title - 01/02/2024

Publication_date

Contains the publication date as see in the HUB.

vl_value_publication_date

2024-02-01

Page_number

Contains the page number.

vl_value_page_number

1, 2, 3 …

Section_number

Number from the section value.

vl_value_section_number

1, 2, 3 …

Section_name

Name from the section value.

vl_value_section_name

Section 1, Section 2, Section 3 …

Title

Article Title from XML for Audio Articles.

vl_value_title

Lorem Ipsum

Category

Article Category from XML for Audio Articles.

vl_value_category

Local News, Regional News, Sport, Politics

ID

Article ID from XML for Audio Articles.

vl_value_id

4129799

Source

Contains the source of the media event. "Where was the media event triggered from"

vl_value_source

Article View, PDF, Search, Frontpage, Bookmark

Method

Contains the media method. "What kind of audio is played"

vl_value_method

TTS, Narrated

Length

Audio Length

vl_value_length

500, 1000, 1500 …

Author

Article author from XML.

vl_value_author

Lars Larsen

 

For the media event we also send an event metric*:

Parameter Name

Description

Parameter (Code)

Example value(s)

Duration

Time spent in seconds

vl_value_duration

3, 4, 5 …

*Duration stops if the user pauses, closes the player, closes the audio article, closes the app, or if the audio article ends

 

Search event

Trigger: When a user submits a search
Event name: vl_event_search

Parameter Name

Description

Parameter (Code)

Example value(s)

Search

Contains the search word

vl_value_search

Lorem Ipsum

Source

Contains the source for the search. "Where was the search made from"

vl_value_source

Archive, Current

 

Interstitial event

Trigger: When a user sees or clicks an interstitial
Event name: vl_event_interstitial

Parameter Name

Description

Parameter (Code)

Example value(s)

Info

Contains prefix, folder id, and publication id. Return as a string separated by a slash "/" (prefix/folder id/publication id).

vl_value_info

visiolink/100/1000

Publication_title

Contains the publication title as see in the HUB

vl_value_publication_title

Visiolink Title - 01/02/2024

Publication_date

Contains the publication date as see in the HUB

vl_value_publication_date

2024-02-01

Section_number

Number from the section value

vl_value_section_number

1, 2, 3 …

Section_name

Name from the section value

vl_value_section_name

Section 1, Section 2, Section 3 …

ID

Contains the Interstitial name

vl_value_id

Interstitial_1

Click

True / False whether the interstitial was clicked

vl_value_click

True, False

 

Hotspot (Clickable ad) event

Trigger: When a user sees or clicks a hotspot (clickable ad)
Event name: vl_event_hotspot

Parameter Name

Description

Parameter (Code)

Example value(s)

Info

Contains prefix, folder id, and publication id. Return as a string separated by a slash "/" (prefix/folder id/publication id).

vl_value_info

visiolink/100/1000

Publication_title

Contains the publication title as see in the HUB

vl_value_publication_title

Visiolink Title - 01/02/2024

Publication_date

Contains the publication date as see in the HUB

vl_value_publication_date

2024-02-01

Section_number

Number from the section value

vl_value_section_number

1, 2, 3 …

Section_name

Name from the section value

vl_value_section_name

Section 1, Section 2, Section 3 …

ID

Contains the hotspot (clickable ad) name

vl_value_id

Interstitial_1

Click

True / False whether the hotspot (clickable ad) was clicked

vl_value_click

True, False

Page_number

Contains the page number

vl_value_page_number

1, 2, 3 …

 

Module event

Trigger: When a user clicks a module
Event name: vl_event_module_interaction

Parameter Name

Description

Parameter (Code)

Example value(s)

Info

Contains the module name

vl_value_info

Newest Publication, Previous Publications, Current Articles

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

Comments