Purpose

Provides student-level detail on Bookshelf usage by Item, includes session details, page views, pages printed, highlights, notes, and bookmarks.

Report Notes

  • The access filter will automatically filter the report to only show products that distributed the content, and this filter will only show available values.
  • This report provides a limited display of engagement events which includes the the current year to-date and previous two years. For example, if today is 02-Dec-2024, then all engagement events are included for 2024 up through 02-Dec-2024 at 00:00:00 UTC and all engagement events for 2023 and 2022.
  • Engagement metrics (page views, prints, etc.) pertain only to engagement within the filtered date range unless otherwise noted.
  • Engagement metrics (page views, prints, etc.) are cumulative counts (i.e., not unique) For example, a user views 10 pages. They re-review those same 10 pages five times. The total page views for the user would be 50.
  • Engagement events are only from within Bookshelf. Publisher courseware activity is not included as we do not have access to the publisher’s activity data.

Definition of filters

Filter Name Description Usage Notes
Date Range Date range for when engagement took place

Defaulted to “Last 7 Days”

Use to set a date range, relative date (e.g., “last month”), or specific dates.

Distributor Name of the company that distributed the content Filter to a specific distributor
Asset Item ID Unique identifier for the item, typically an ISBN or VBID.

Use to search for a specific asset or for many assets.

You can easily copy/paste multiple values. This can be completed through copying a column of ISBNs or VBIDs from an excel-like document or copying ISBNs or VBIDs separated by commas.

🔵 Multi-search can support up to 16,000 values

⚠️ Copying ISBNs or VBIDs separated by semi-colon does not work.

Asset Item Name Name of the content accessed Use to search for a specific asset
Publisher Name of the publisher related to the distributed content Narrow results based on the content publisher
Course Name Name of the course the engagement is associated with (if available) Use to search for a specific course
Instructor Name of instructor with related safe-email for distinction Use to search for a specific instructor
User First and Surname of user with related safe-email for distinction Use to search for a specific user
Device Format of the device used to access the content Narrow results based on the device used
Platform Online platform used to access the content Narrow results based on the platform used Course Name

 

Definition of fields

Field Name Description
Distributor Name of the company that distributed the content
User Name of the student/user
User Email Email address of the user (safe email)
User Reference ID Reference associated with the user set by the Distributor
Course Name LMS course title from Launch
Course Label LMS course label from Launch
LMS Course ID in Launch LMS Course ID stored in Launch
Asset Item Name Name of the content accessed
Asset Item ID

Unique identifier for the item, typically an ISBN or VBID. Derived based on the following:

  • Asset ISBN-13, else
  • eISBN, else
  • VBID
Related Print ISBN Related print ISBN of the content
Item Format Format in which the content is delivered
Author(s) Name of the author(s) who wrote the content
Publisher Name of the publisher related to the distributed content (Manage Company name)
Imprint Publisher’s imprint for the item
Last Access Date (Overall)

Most recent date the user accessed the material

📄 This date may fall after the filtered date range.

All engagement metrics pertain only to engagement within the filtered date range. The Last Access Datefields always reflect the most recent date the user engaged with the item, which may or may not be within the filtered date range.

Last Access Date (Online)

Most recent date the user accessed the material from Bookshelf Online

📄 This date may fall after the filtered date range.

All engagement metrics pertain only to engagement within the filtered date range. The Last Access Datefields always reflect the most recent date the user engaged with the item, which may or may not be within the filtered date range.

Last Access Date (Download)

Most recent date the user accessed the material from Bookshelf Native

📄 This date may fall after the filtered date range.

All engagement metrics pertain only to engagement within the filtered date range. The Last Access Datefields always reflect the most recent date the user engaged with the item, which may or may not be within the filtered date range.

Sessions (Overall)

Total number of unique sessions

🔵 Sessions are groups of engagement events. These events are determined by calculating the time for each engagement, i.e., when a user starts interacting with content, a session begins; the session ends when there is a 30-minute gap in activity. A new session would begin if that users interacts with the content again after that.

📄 Users often interact with content across multiple devices simultaneously. Sessions that span multiple devices are only counted once under Sessions (Overall), but will be counted as '1' session under each respective device the user used. Therefore, the sum of Sessions (Online), Sessions (Desktop - Mac), Sessions (Desktop - PC), Sessions (Mobile - iOS), and Sessions (Mobile - Android) are generally not expected to align with Sessions (Overall).

For Example:

User A engaged with item ABC from their Desktop - Mac, Online, and through their Mobile - iOS between 9AM - 11AM EST on 02-Dec-2024.

Sessions (Overall) - 1

Sessions (Online) - 1

Sessions (Desktop - Mac) - 1

Sessions (Mobile - iOS) - 1

In other words, Sessions (Overall) is not the total of all session events.

Sessions (Online) Total number of unique sessions from Bookshelf online
Sessions (Desktop - Mac) Total number of unique sessions from a Mac Desktop App
Sessions (Desktop - PC) Total number of unique sessions from a PC Desktop App
Sessions (Mobile - iOS) Total number of unique sessions from an iOS Mobile App
Sessions (Mobile - Android) Total number of unique sessions from a Android Mobile App
Page Views (Overall) Total number of pages viewed
Page Views (Online) Total number of pages viewed on Bookshelf online
Page Views (Desktop - Mac) Total number of pages viewed from a Mac Desktop App
Page Views (Desktop - PC) Total number of pages viewed from a PC Desktop App
Page Views (Mobile - iOS) Total number of pages viewed from an iOS Mobile App
Page Views (Mobile - Android) Total number of pages viewed from a Android Mobile App
Pages Printed (Overall) Total account of pages printed
Pages Printed (Online) Total account of pages printed from Bookshelf online
Pages Printed (Desktop - Mac) Total account of pages printed from a Mac Desktop App
Pages Printed (Desktop - PC) Total account of pages printed from a PC Desktop App
Pages Printed (Mobile - iOS) Total account of pages printed from an iOS Mobile App
Pages Printed (Mobile - Android) Total account of pages printed from a Android Mobile App
Notes (Overall) Total number of notes created
Notes (Online) Total number of notes created from within Bookshelf online
Notes (Desktop - Mac) Total number of notes created from a Mac Desktop App
Notes (Desktop - PC) Total number of notes created from a PC Desktop App
Notes (Mobile - iOS) Total number of notes created from an iOS Mobile App
Notes (Mobile - Android) Total number of notes created from a Android Mobile App
Highlights (Overall) Total number of highlights created
Highlights (Online) Total number of highlights created from within Bookshelf online
Highlights (Desktop - Mac) Total number of highlights created from a Mac Desktop App
Highlights (Desktop - PC) Total number of highlights created from a PC Desktop App
Highlights (Mobile - iOS) Total number of highlights created from an iOS Mobile App
Highlights (Mobile - Android) Total number of highlights created from a Android Mobile App
Bookmarks (Overall) Total number of bookmarks created
Bookmarks (Online) Total number of bookmarks created from within Bookshelf online
Bookmarks (Desktop - Mac) Total number of bookmarks created from a Mac Desktop App
Bookmarks (Desktop - PC) Total number of bookmarks created from a PC Desktop App
Bookmarks (Mobile - iOS) Total number of bookmarks created from an iOS Mobile App
Bookmarks (Mobile - Android) Total number of bookmarks created from a Android Mobile App
Avg Session Length (Overall) Average time the user engaged with the content
Avg Session Length (Online) Average time the user engaged with the content thru Bookshelf online
Avg Session Length (Desktop - Mac) Average time the user engaged with the content thru the Mac Desktop App
Avg Session Length (Desktop - PC) Average time the user engaged with the content thru the PC Desktop App
Avg Session Length (Mobile - iOS) Average time the user engaged with the content thru the iOS Mobile App
Avg Session Length (Mobile - Android) Average time the user engaged with the content thru the Android Mobile App

 

Was this article helpful?