Login

Learning & Support

Documentation

Analytics Events Overview

Twixl Support Team Updated: - Created :

    The Twixl platform gathers anonymized information about how users/readers interact with your app and the Twixl platform. In Twixl Publisher 16, we introduced vastly improved event tracking. 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:

    This feature requires an app built with Twixl Publisher 16.x or higher. You'll also 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 (NEW)

    This event is logged every time a user performs a login or logout via entitlements.

    1.4. Notification opened event

    notification-open (NEW)

    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 (NEW)

    This event is logged every time a user purchases a specific content item (PDF) or collection.

    purchase-restore (NEW)

    This event is logged every time a user performs a restore of the previous purchases.

    purchase-subscription (NEW)

    This event is logged every time a user purchases a subscription.

    iOS and Android only.

    1.6. Search event

    search (NEW)

    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.8. Social sharing

    social-share (NEW)

    This event is logged every time a user successfully shares a content item on social media.

    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 (NEW)

    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 (NEW)

    This event is logged every time a user ends up on the paywall.

    iOS and Android only.

    view-settings (NEW)

    This event is logged every time a user opens the settings window.

    iOS and Android only.

    view-weblink (NEW)

    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 (NEW)

    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 (NEW)

    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 (NEW)

    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 (NEW)

    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 (NEW)

    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 (NEW)

    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 (NEW)

    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 (NEW)

    This event is logged when a user creates a new app on the Twixl platform.

    app-delete (NEW)

    This event is logged when a user deletes an app from the Twixl platform.

    collection-create (NEW)

    This event is sent when a user creates a collection on the Twixl platform.

    collection-delete (NEW)

    This event is sent when a user deletes a collection on the Twixl platform.

    content-item-create (NEW)

    This event is sent when a user creates a content item on the Twixl platform.

    content-item-delete (NEW)

    This event is sent when a user deletes a content item on the Twixl platform.

    notification-send (NEW)

    This event is triggered after a notification for a specific app has been sent.

    Was this article helpful?

    1 out of 1 found this helpful