Skip to content

Story Events#

This page lists the Story events that the SDK sends to onUserActivityOccurred, when each one is recorded, and its properties. The Storyteller Web Showcase handles these events in its onUserActivityOccurred handler.

Caption state and events#

Story and Page activity callbacks that identify a Story or Page include a captionsEnabled boolean. The value records the caption choice when the event occurs. Stories and Clips share that choice. The SDK saves it in the browser when functional storage is allowed. With functional storage disabled, the choice lasts until the page reloads.

The player emits enabledStoryCaptions for an enabled choice or disabledStoryCaptions for a disabled choice. Each toggle event includes the resulting captionsEnabled value, plus the active Story and Page identifiers, titles, one-based indexes, category information, and Page action fields.

Event property Value in a Story caption toggle event
captionsEnabled true or false for the resulting choice.
categories Names of the categories assigned to the Story.
categoryDetails A list of objects with name, id, type, and optional externalId and string placement.
currentCategory An object with title, optional id, and optional string placement.
storyId, storyTitle, storyDisplayTitle, storyIndex, storyPageCount The active Story and its one-based index.
pageId, pageTitle, pageType, pageIndex The active Page and its one-based index.
pageHasAction, pageActionText, pageActionUrl Action details for the active Page.

Opened Story (openedStory)#

The openedStory event is recorded when:

  • A user taps on a row item to open a Story
  • A Story is loaded because the previous Story finished
  • A Story is loaded because the user skipped the last Page of the previous Story
  • A user swipes left to the next Story
  • A user swipes right to the previous Story
  • A user is sent directly to a Story by a deep link

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Opened Reason openedReason The action which the user took to open the Story. OpenedReason
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Read Status storyReadStatus Whether the Story was read or unread at the point it was opened. read, unread
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Dismissed Story (dismissedStory)#

The dismissedStory event is recorded when:

  • A user taps close to dismiss the Story
  • A user taps to skip the last Page of the final Story to dismiss the Story and go back to the page they were on previously
  • A user swipes left on the final Story to dismiss the Story
  • A user swipes right on the first Story to dismiss the Story
  • A user completes the final Page of the final Story and the Story view is dismissed
  • The player closes for another DismissedReason, such as the browser back button or the Esc key

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Dismissed Reason dismissedReason The reason the Story was dismissed. DismissedReason
Duration Viewed durationViewed In milliseconds, how long the user viewed Stories, measured from the most recent openedStory event with an openedReason of storyListTap or deepLink. The timer resets after each dismissedStory event. 1200, 1312, 29
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Pages Viewed pagesViewed The total number of Pages the user has viewed since the most recent openedStory event with an openedReason of storyListTap or deepLink. The count resets after each dismissedStory event. 1, 2, 3, 4
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Skipped Story (skippedStory)#

The skippedStory event is recorded when:

  • A user swipes left to the next Story before completing the current Story
  • A user skips the last Page of a Story

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Completed Story (completedStory)#

The completedStory event is recorded when the final Page in a Story is opened. The openedPage event is recorded at the same time.

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Opened Page (openedPage)#

The openedPage event is recorded when a user first opens a Page.

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Content Length contentLength In seconds, the total duration of the Page content. 15, 41, 32
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Opened Reason openedReason The action which the user took to open the Page. OpenedReason
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Action Button Tapped (actionButtonTapped)#

The actionButtonTapped event is recorded when:

  • A user swipes up on a Page to open a link
  • A user taps on the swipe up element of a Page to open a link

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Share Button Tapped (shareButtonTapped)#

The shareButtonTapped event is recorded when a user taps the share button on a Page.

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Share Success (shareSuccess)#

The shareSuccess event is recorded when a user finishes sharing a Page. This happens when the promise returned by your onShareButtonTapped callback resolves, when the browser share sheet completes, or when the Page media finishes downloading.

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Share Method shareMethod How the Page was shared: as a link (shareLink) or as its media (shareMedia or share). shareLink, shareMedia, share
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Previous Page (previousPage)#

The previousPage event is recorded when a user taps back to go to a previous Page in the Story.

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Previous Story (previousStory)#

The previousStory event is recorded when:

  • A user swipes right to go to the previous Story (unless this is the first Story, in which case dismissedStory is recorded instead)
  • A user taps back on the first Page in a Story (and this is not the first Page in the first Story)

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Completed Page (completedPage)#

The completedPage event is recorded when a Page finishes and the player moves on to the next Page or Story automatically. The event describes the Page that finished.

ActivityType lists this event as deprecated, but the SDK still sends it. Avoid building new reports on it.

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Content Length contentLength In seconds, the total duration of the Page content. 15, 41, 32
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”

Skipped Page (skippedPage)#

The skippedPage event is recorded when a user taps or swipes forward to leave a Page before it finishes. The event describes the Page the user left.

ActivityType lists this event as deprecated, but the SDK still sends it. Avoid building new reports on it.

This event contains the following properties:

Event Property Property Name Description Sample values
Captions Enabled captionsEnabled Whether captions were on when the event occurred. true, false
Categories categories A list of the category names assigned to the Story for which the event occurred. ["Top Stories", "Europe", "Recap"]
Category Details categoryDetails A list of Category Detail objects assigned to the Story for which the event occurred. [{ name: 'Greens v Blues, 10/06/2022', id: '0012200025', externalId: 'game-0012200025', type: 'game', placement: 'Game Screen' }]
Current Category currentCategory The Category for the Story with which the user is interacting. This event property includes the Category's name (title), external ID (id), and placement. { title: 'Greens v Blues, 10/06/2022', id: 'game-0012200025', placement: 'Game Screen' }
Page Action Text pageActionText If the Page associated with the event has an Action, this property captures its associated ‘Call To Action’ text. “Swipe Up”, “Get Started”
Page Action URL pageActionUrl If the Page associated with the event has an Action, the URL to which the Action links. https://example.com/action
Page Has Action pageHasAction Whether the Page associated with the event contains an Action. true, false
Page ID pageId The ID of the Page for which the event occurred. cce4f2c3-c6f2-4a0a-9d8c-b52e4080e658
Page Index pageIndex The index of the Page in the Story for which the event occurred. Ads do not affect this index. This property uses 1-based indexing. 1, 2, 3, …
Page Title pageTitle The title of the Page for which the event occurred. “Stats page”, “Best Fit”
Page Type pageType The type of Page associated with the event. image, video, poll, triviaQuiz
Story ID storyId The ID of the Story for which the event occurred. 3241dbc1-ae7b-4b55-a236-1294f18e2584
Story Index storyIndex The index of the Story for which the event occurred in the row from which it was opened, at the point it was opened. This property uses 1-based indexing. 1, 2, 3, …
Story Page Count storyPageCount The number of Pages in the Story. 1, 2, 3, …
Story Playback Mode storyPlaybackMode Whether the Story was opened with a Storyteller.sharedInstance.open* method or its URL (singleStory), or by the user tapping it in a row or grid (list). list, singleStory
Story Title storyTitle The title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”
Story Display Title storyDisplayTitle The long display title of the Story for which the event occurred. “Tonight’s Movies”, “Quote of the Day”