The Twixl platform gathers anonymized information about how users/readers interact with your app and the Twixl platform. While we provide a number of reports based on this data, some of the events are available only through the Twixl Admin API, and can be imported in your own analytics presentations, tables, tools... Below is an overview of all events that are collected. The events are collected on iOS, Android and the browser client (unless specified differently below).
IMPORTANT NOTE:
You need to have the Integration API as part of your subscription if you want to access the raw data using our Admin API.
1. Events in the apps
1.1. App Install event
app-install
This event is logged every time a user launches the app for the very first time on his/her device.
iOS and Android only.
1.2. Download event
download
This event is logged every time a user performs a download of a content item.
1.3. Entitlement login & logout events
entitlement-login
& entitlement-logout
This event is logged every time a user performs a login or logout via entitlements.
1.4. Notification opened event
notification-open
This event is logged every time a user opens a push notification on his device.
iOS and Android only.
1.5. Purchase events
purchase-item
This event is logged every time a user purchases a specific content item (PDF) or collection.
purchase-restore
This event is logged every time a user performs a restore of the previous purchases.
purchase-subscription
This event is logged every time a user purchases a subscription.
iOS and Android only.
1.6. Search event
search
This event is logged every time a user performs a search query.
1.7. Session events
session-start
This event is logged every time a user launches the app or bring the app to the foreground.
When the user logs in via entitlements, this is also considered as a new session.
session-end
This event is logged every time a user stops the app or when the app goes to the background.
When the user logs out from entitlements, this also should be considered as a session end.
iOS and Android only.
1.9. View events
1.9.1. General view events
view-collection
This event is logged every time a user goes to a specific collection, regardless of the view mode (browse or detail). If the user first goes to the browse page and then navigates to the detail page, the event is logged twice.
If the user returns from e.g. a detail view of a collection back to the browse page, these count as separate events.
view-content-item
This event is logged every time a user visits a specific content item page. For each page, we log a separate event.
For PDF content items, every page that is displayed will be logged as well.
This event is only triggered after the content item has been downloaded and one of the pages is visible on the screen.
view-pagelink
This event is logged every time a user taps on a pagelink in a content item. For each page, a separate event will be logged.
view-paywall
This event is logged every time a user ends up on the paywall.
iOS and Android only.
view-settings
This event is logged every time a user opens the settings window.
iOS and Android only.
view-weblink
This event is logged every time a user taps a web link in a content item.
1.9.2. InDesign-specific view events
view-button
This event is logged every time a user taps a button in a Twixl InDesign article. For each page, a separate event will be logged.
view-image-sequence
This event is logged every time a user swipes or taps on an image sequence in a Twixl article. This event will be counted only once for each page view.
As long as the user stays on the same page and swipes multiple times on the image sequence, it counts as a single event.
view-movie
This event is logged every time a user starts the playback of a movie in a Twixl article (that does not autoplay).
If the user plays the movie multiple times during the same "page session", only one event will be logged.
view-scrollable-content
This event is logged every time a user swipes in a scrollable content item in a Twixl article.
This event will be counted only once for each page view. As long as the user stays on the same page and swipes multiple times on the scrollable, it will count as a single event.
view-slideshow-slide
This event is logged every time a user swipes to another slide in a slide show. If the slideshow is set to autoplay, the event will not be logged.
view-sound
This event is logged every time a user taps a sound element in a Twixl article (that does not autoplay).
If the user plays the sound multiple times during the same "page session", only one event will be logged.
view-web-overlay-button
This event is logged every time a user taps on a web overlay button in a Twixl article.
2. Admin events on the Twixl platform
app-create
This event is logged when a user creates a new app on the Twixl platform.
app-delete
This event is logged when a user deletes an app from the Twixl platform.
collection-create
This event is sent when a user creates a collection on the Twixl platform.
collection-delete
This event is sent when a user deletes a collection on the Twixl platform.
content-item-create
This event is sent when a user creates a content item on the Twixl platform.
content-item-delete
This event is sent when a user deletes a content item on the Twixl platform.
notification-send
This event is triggered after a notification for a specific app has been sent.
1.8. Social sharing
social-share
This event is logged every time a user successfully shares a content item on social media.
iOS and Android only.