article_narrative_start to toc

Trigger mechanism

This event is triggered when an article audio file starts playing in a Prenly reader application. The event is triggered when user hits the play or resume button in the article mode or in the start page's article component and when an article is automatically started within the audio queue.

This event is planned to be introduced in all platforms from Q4- 2024.

Event attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

article_narrative_stop to toc

Trigger mechanism

This event is triggered when an article audio file stops playing in a Prenly reader application. The event is triggered when user hits the pause or stop button in the article mode or in the start page's article component, closes the player and when an article audio is automatically reaching the end.

This event is planned to be introduced in all platforms from Q4- 2024.

Event attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

article_open to toc

Trigger mechanism

This event is triggered when a user opens an article in the article reading mode in a Prenly reader application.

This may occur when:

• an article box is selected in a replica page.
• an article is selected from the search function.
• an article is loaded in the browser with a direct link.
• the user navigates to previous or next article from another article in article reading mode.

Note that the event is triggered as soon as the article is rendered, regardless of whether or not the user is considered having consumed the article content.

Event attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

Deprecated attributes

banner_click to toc

Trigger mechanism

This event is triggered when a user clicks a banner on the start page of a Prenly reader application.

Attributes

Note that contextual data will normally be included when an event is exported.

Example

custom_tab_audio_start to toc

Trigger mechanism

This event is triggered when an audio file displayed in a custom tab of the Prenly reader is launched in Prenly's audio player with the javascript bridge and is triggered when it starts or resumes.

This is a draft and the event is planned to be introduced in all platforms from Q4, 2024.

Attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

custom_tab_audio_stop to toc

Trigger mechanism

This event is triggered when an audio file loaded with the javascript bridge from a custom tab of the Prenly reader is paused or stopped in Prenly's audio player, or when it reaches the end.

This is a draft and the event is planned to be introduced in all platforms from Q4, 2024.

Attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

external_url_clicked (deprecated) to toc

Note that this event is deprecated and will be removed in future versions.

Trigger mechanism

This event is triggered when a user open a link to as web page (http or https) that is hosted on an external web site.

This may occur when:

• a box is clicked in a replica publication page, if the box is associated with a url
• a page component of type “banner” is clicked, if the banner is associated with a link

Dimensions

User related dimensions

These dimensions are sent only if a user is logged-in, and if the end-user requires consent from the end-user and the end-user accepted it. See more about user related dimensions.

They are sent in platform-specific structures or format:

Event related dimensions

Deprecated dimensions

These dimensions are only sent in native apps and will stopped being sent in the future.

More information about event dimensions is found here.

Example

This is an example of event dimensions passed with the external_url_clicked event.

{    "user_id": "e2b884d5-9b83-4f3c-bf38-b03dec180352",    "customer_number": "CK1635",    "url": "https://some.site.com/page?foo=bar"}

favorite_title_add to toc

Trigger mechanism

This event is triggered when a user interacts to add a specific title to its list of personal favorites in a Prenly reader application.

Attributes

Note that contextual data will normally be included when an event is exported.

Example

Deprecated attributes

These attributes will stopped being sent in the future.

favorite_title_remove to toc

Trigger mechanism

This event is triggered when a user interacts to remove a specific title from its list of personal favorites in a Prenly reader application.

Attributes

Note that contextual data will normally be included when an event is exported.

Example

Deprecated attributes

These attributes will stopped being sent in the future.

issue_open (deprecated) to toc

Note that this event is deprecated and will be removed in future versions.

Trigger mechanism

This event is triggered when a user opens a publication (formerly called issue) in a Prenly reader application, regardless of the publication's default reading mode.

This may occur when:

• a publication is selected from start page loading the first page in the publication.
• a publication is selected from a title page.
• a publication page or spread is selected from the search page.
• a publication (and thereby its first page) is loaded in the browser with a direct link (web reader only).

Dimensions

More information about event dimensions is found here.

Example

This is an example of event dimensions passed with the issue_open event.

{   "user_id": "e2b884d5-9b83-4f3c-bf38-b03dec180352",   "customer_number": "CK1635",   "issue_slug": "world-cup-insert",   "issue_id": 45680,   "publication_date": "2019-12-24",   "title_slug": "weekly-news",   "title_id": 2359}

podcast_episode_start to toc

Trigger mechanism

This event is triggered when a podcast episode in a Prenly reader starts playing from the beginning, or when a user resumes playing a paused episode.
The values within parenthesis show the source node from the podcast rss file.

This event is planned to be introduced in all platforms from Q4, 2024.

Attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

podcast_episode_stop to toc

Trigger mechanism

This event is triggered when a podcast episode in a Prenly reader stops playing.
The event will be triggered when a user presses pause, stop or when the episode reaches its end.

The values within parenthesis show the source node from the podcast rss file.

This event is planned to be introduced in all platforms from Q4, 2024.

Attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

prenly_app_open to toc

Trigger mechanism

This event is triggered when a user opens the Prenly native reader application (iOS, Android).

This may occur when:

• the application starts up anew.
• the application is moved into foreground after being placed in the background.

When the application is opened, a consent dialog can be shown if the user has not already given consent. In those cases this event will be triggered after consent has been given.

Attributes

Note that contextual data will normally be included when an event is exported.

Example

Note that many integrations send boolean values as strings ("0" or "true"). Please refer to the documentation for each specific integration.

prenly_push_notification_open to toc

Trigger mechanism

This event is triggered when a user opens a push notification that has been sent from Prenly Workspace.

Attributes

Note that contextual data will normally be included when an event is exported.

Example

publication_open to toc

This event was introduced in the web reader from October 2024, and is available from IOS app version 13.0.0 and Android version 12.3.0 (released October 2024).

Trigger mechanism

This event is triggered when a user opens a publication in a Prenly reader application, regardless of the publication's default reading mode.

This may occur when:

• a publication is selected from start page loading the first page in the publication.
• a publication is selected from a title page.
• a publication page or spread is selected from the search page.
• a publication (and thereby its first page) is loaded in the browser with a direct link (web reader only).
• a publication is opened from within a continuous swipe through section
• a publication is opened from the page overview page

Dimensions

The attributes with the suffix ? are not always available.

More information about event dimensions is found here.

Example

This is an example of event dimensions passed with the publication_open event.

{   "user_id": "e2b884d5-9b83-4f3c-bf38-b03dec180352",   "customer_number": "CK1635",   "publication_slug": "world-cup-insert",   "publication_uid": "45680",   "publication_date": "2019-12-24",   "title_slug": "weekly-news",   "title_uid": "2359",   "limited_access: true}

replica_box_link_click to toc

Trigger mechanism

This event is triggered when a user clicks a box on a replica page in a Prenly reader application, if the box is a link that opens an external url when clicked.

Attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

replica_box_link_view to toc

This event was introduced in the web reader from October 2024, and is available from IOS app version 13.0.0 and Android version 12.3.0 (released October 2024).

Trigger mechanism

This event is triggered when a replica page in a Prenly reader application is displayed, if a box with a clickable link to an external url is included in the page. The purpose of this event is mainly to track the number of ad impressions, but it can also be used to track impressions of other kinds of clickable objects.

Attributes

The attributes with the suffix ? are not always available.

Note that contextual data will normally be included when an event is exported.

Example

replica_page_open to toc

Trigger mechanism

This event is triggered when a user opens a replica page in a Prenly reader application, using the replica reading mode.

This may occur when:

• a publication is selected from start page loading the first page in the publication.
• a publication page or spread is selected from the search page.
• the user navigates to previous or next page in replica reading mode.
• the user navigates to previous or next spread (normally two pages) in replica reading mode.
• a page or a spread is loaded in the browser with a direct link (web reader only).
• a link to the Prenly reader application is opened on an iOS or Android device, for example from an e-mail or on another web page.

When a spread (two or more adjacent pages) is rendered, all pages on the spread will trigger its own replica_page_open event.

Note that the event is triggered as soon as the page is rendered, regardless of whether or not the user is considered having consumed any page content.

Attributes

Note that contextual data will normally be included when an event is exported.

Example

Deprecated attributes

These attributes will stopped being sent in the future.

title_open to toc

Trigger mechanism

This event is triggered when a user opens the title page in a Prenly reader application. This page presents information regarding - and possibly content from - one specific title within the application.

Event attributes

Note that contextual data will normally be included when an event is exported.

Example

Deprecated attributes

These attributes will stopped being sent in the future.

titles_overview_open to toc

Trigger mechanism

This event is triggered when a user opens the titles overview page in a Prenly reader application. This page gives the reader an overview of the titles within the application.

Event attributes

This event do not currently have any event attributes.

Note that contextual data will normally be included when an event is exported.