Analytics

Event Types

These are the various events which are triggered from within the SDK. Each event is a member of the UserActivity.EventType enumeration. Please see the StorytellerListViewDelegate page for details on how to bind to these events.

In the below discussion "completing" a page refers to allowing the timer to expire - so this would correspond to watching all of an image page for the duration set for it (default 15s) or watching all of a video.

Story Events

Opened Story

This event is recorded in the following scenarios:

• When a user taps on a row item to open a story
• When a story is loaded because the previous story finished
• When a story is loaded because the user tapped to skip the last page of the previous story
• When a user swipes left on a story to go to the next story
• When a user swipes right on a story to go to the previous story
• When a user is sent directly to a story via a deeplink

Opened Page

This event is recorded when as soon as a user sees content for a page

Dismissed Story

This event is recorded in the following scenarios:

• When a user taps the close button to dismiss the story
• When a user swipes down to dismiss the story
• When a user taps back on their device UI to dismiss the story (Android only)
• When a user taps to skip the last page of the final story - this dismisses the story and exits the Story View
• When a user swipes left on the final story to dismiss the story
• When a user swipes right on the first story to dismiss the story
• When a user completes the final page of the final story and the story view is dismissed

Skipped Story

This event is recorded when:

• a user swipes left to go to the next story
• a user skips the last page of a story to go to the next story

Skipped Page

This event is recorded when a user taps to go to the next page before completing the current page

Completed Story

This event is recorded at the same time as OpenedPage for the final page in a story.

Completed Page

This event is recorded when a user watches a page to completion (i.e. the timer for that page finishes)

Swiped Up

This event is recorded in the following scenarios:

• When a user swipes up on a page to open a link
• When a user taps on the swipe up element of a page to open a link

Share Button Tapped

This event is recorded when a user taps the share button on a page

Previous Story

This 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 fired instead)
• a user taps back on the first page in a story (and this is not the first page is the first story)

Previous Page

This event is recorded when a user taps back to go to a previous page in the story

Share Success

This event is recorded when a user:

• selects a sharing method from the system dialog.

Voted Poll

This event is recorded when user votes in a poll.

Trivia Quiz Question Answered

This event is recorded when a user answers a question in a trivia quiz.

Trivia Quiz Completed

This event is recorded when a user completes a trivia quiz.

Ad Events

Opened Ad

This event is recorded when:

• an ad is loaded because the previous story finished
• a user swipes left on a story to go to the next story and an ad appears
• a user swipes right on a story to go to the previous story and an ad appears

Dismissed Ad

This event is recorded when a user:

• taps close to dismiss the ad
• swipes down to dismiss the ad
• taps back on their device UI to dismiss the ad (Android only)
• taps to skip the ad if the ad is the last page in the current set of stories
• swipes left on the ad to skip it if the ad is the last page in the current set of stories
• completes the ad if the ad is the last page in the current set of stories

Skipped Ad

This event is recorded when a user:

• swipes left to go to the next story before completing the current ad
• taps to go to the next page on an ad before completing the current ad

Swiped Up On Ad

This event is recorded when a user:

• swipes up on an ad to open a link
• taps on the swipe up element of an ad to open a link

Previous Ad

This event is recorded when a user:

• swipes right to go to the previous story when viewing an ad
• taps back to go to the previous page when viewing an ad

Finished Ad

This event is recorded at the same time as Dismissed Ad, Skipped Ad, Previous Ad and Viewed Ad Page Complete and gives an easier way to determine when an ad finishes for any reason.

Paused Ad Page

This event is recorded when a user pauses a page within an ad by pressing and holding on the page

Resumed Ad Page

This event is recorded when a user resumes playing a page within an ad by releasing their long press which paused the ad

Viewed Ad Page First Quartile

This event is recorded when a user reaches 1/4 of the way through the duration of a page which is within an ad

Viewed Ad Page Midpoint

This event is recorded when a user reaches halfway through the duration of a page which is within an ad

Viewed Ad Page Third Quartile

This event is recorded when a user reaches 3/4 of the way through the duration of a page which is within an ad

Viewed Ad Page Complete

This event is recorded when a user reaches the end of the duration for a page which is within an ad

Playback Events

Ready to Play

This event is called once per video page at the point when the video player has been loaded

Media Started

This event is called once per video page at the point when the video starts to play for the first time

Buffering Started

This event is called on video pages whenever the video starts to buffer

Buffering Ended

This event is called on video pages whenever the video finishes buffering

Note: There should be at most one Ready to Play event and one Media Started event for every page. There may be multiple Buffering Started/Buffering Ended pairs of events for an individual page. There may not always be a Buffering Ended event for every Buffering Started event as the user may choose to exit the page during buffering.

Event Data

For each event, data is returned with details about the story and page involved as well as some extra properties with more information about what the user has done. The data is returned as a UserActivityData class with the following properties:

• storyId: String? - the ID of the story for which the event occurred

• storyTitle: String? - the title of the story for which the event occurred

• storyIndex: Int? - 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 is only included on OpenedStory events. Note: this value is 1-based

• storyPageCount: Int? - the number of pages in the story

• storyReadStatus: String? - whether the story was read or unread at the point the story was opened - this is only included on OpenedStory events. Note this will either be read or unread.

• pageId: String? - the ID of the page for which the event occurred

• pageIndex: Int? - the index of the page in the story for which the event occurred. Note: this value is 1-based

• pageType: String? - the type of the page associated with the event. This can have the value image, video or poll

• storyPlaybackMode - included for all events. The string show if the story was opened using the list or in the single story mode (Storyteller static method). Valid values are list and singleStory

• pageHasSwipeUp: Bool? - whether the page associated with the event contains a swipe up link

• pageSwipeUpText: String? - if the page associated with the event has a swipe up link, the text call to action associated with that link

• pageSwipeUpUrl: String? - if the page associated with the event has a swipe up link, the URL which is linked to from the swipe up

• openedReason: String? - only included on OpenedStory events. Possible values are storyRowTap (the user tapped the story in the story row to open the story); deepLink (openStory or openPage was called to open the story); swipe (the user swiped left or right to change the current story); automaticPlayback (the user completed the previous page - that is, the timer for that page completes); tap (the user tapped on the previous page to navigate to this page)

• dismissedReason: String? - only included on DismissedStory events - possible values are closeButtonTapped (the user tapped close to dismiss the story); swipedDown (the user swiped down to dismiss the story); swipedFirstStory (the user swiped the first story to dismiss it); swipedFinalStory (the user swiped the final story to dismiss it); skippedFinalPage (the user tapped to skip the final page of the final story); completedFinalPage (the user completed the final page of the final story); backTapped (the user tapped their device back button to dismiss the story view (Android only))

• durationViewed: Float? - In milliseconds, the duration the user viewed the story view for (measured from the most recent OpenedStory event with an Opened Reason of storyRowTap or deepLink). This timer is reset after any DismissedStory events

• pagesViewedCount: Int? - the total number of pages a user has viewed since the most recent OpenedStory event with an Opened Reason of storyRowTap or deepLink. This count is reset after any DismissedStory events

• advertiserName - the name of the advertiser for a particular ad. This is only included for ad events

• adId: String? - if the event is associated with an ad, then the ID of that ad

• shareMethod: String? - component name of the app which user has selected for sharing

• adView - the view in which the ad is rendered in. This is only included for OpenedAd and FinishedAd events.

• isInitialBuffering - returned if the buffering happens at the start of playback for that page. This is only included for BufferingStarted and BufferingEnded events

• timeSinceBufferingBegan - in milliseconds, the duration which the current buffering lasted for. This is only included for BufferingEnded events

• categories - only included on OpenedStory events. List of categories assigned to the story for which the event occurred.

• pollAnswerId - only included on VotedPoll events. The id of the answer which was selected by the user when voting.

• triviaQuizId - only included on TriviaQuizQuestionAnswered and TriviaQuizCompleted events. The id of the trivia quiz which was completed or answered.

• triviaQuizTitle - only included on TriviaQuizQuestionAnswered and TriviaQuizCompleted events. The title of the trivia quiz which was completed or answered.

• triviaQuizScore - only included on TriviaQuizCompleted events. The score of the trivia quiz which was completed.

• triviaQuizQuestionId - only included on TriviaQuizQuestionAnswered events. The id of the trivia quiz question which was answered.

• triviaQuizAnswerId - only included on TriviaQuizQuestionAnswered events. The id of the selected trivia quiz answer.