Back to Knowledge Base
What do all the columns mean in the User Activity Report data?

 

In the Reports Tab, you can export the User Activity Log to CSV file and get a more detailed report on the user's activity and session information. Below is a table that lists the columns included in the exported CSV file, along with a description of what data could appear in each column. At the bottom of this page is a listing of all the types of activity that can appear in the "Type" column.

 

Details in Exported report:

Column Names Description
ActivityDate Date and time of the transaction in UTC time zone
IsSuccess

Was the transaction successful? Did the user gain access to content, print, or login to the user portal successfully? (TRUE/FALSE)

Description NOT USED and will be removed in time.
DocId Internal record ID of the content. Unique value per content record. GUID format.
VersionId

Internal record ID of the content version. Unique per version.

If you subscribe to Vitrium Security Enterprise and use the Version feature, this will differ for each version uploaded. GUID format.

VersionName This is a string that usually will have "Version: 1" and, if you subscribe to Vitrium Security Enterprise and use the Version feature, subsequent version uploads will increment that value by 1 each time, so "Version: 2", "Version:3", etc. During upload or using API calls, you'll have the option of changing these values.
DocCode Internal DocCode of the content. Unique for each content.
Filename (or 'Content Title' in column view) Unless using APIs this will be the resulting PDF minus the ".pdf" file extension. Same for video, audio, images. The extensions are removed. The column "ContentType" will define the type of content.
DocTitle NOT USED and will be removed in time.
SessionId Only appears for VersionUnique Protected PDFs (a feature only available to Vitrium Security Enterprise customers). This will be the DocId of that PDF.
RemoteUnlockCode Will contain the remote unlock code used to allow a remote PDF user to unlock a protected PDF.
ReaderId Internal record ID of the User record. Unique value per content record. GUID format. If you are a Vitrium Security Enterprise customer that uses an External Service, this will be most likely be the users' ID from your external system as you're responsible for providing this value.
ReaderName Username as seen in the User record.
GroupNames
(or 'Groups' in column view)
At the time this file was being exported, this lists any Groups that the user might belong to. This DOES NOT list Groups that the user might have been linked to at the time of the transaction! Nor does it have anything to do with DRM enforcement.
IpAddress The IP that the user was linked to at the time of the transaction.
CountryCode Using GeoIP database info, this is the ISO country code based on the IpAddress. For the USA and Canada IPs, this will also include the State and Province codes.
ComputerId
(or 'Tracking ID' in column view)
This code is how Vitrium manages device limits. For a Web Viewer, this is stored in the user's cookie. For a Protected PDF, this is stored via Adobe or PDF-XChange. If users are in incognito or private browsing OR if they use ad blockers or other such browser extensions/addons that kill cookies, this can change each time they access content or log in. For the most part, this should be a static value for each type of browser that a user uses on a given device. This should also be static for Protected PDFs on a given computer where they use the same O/S user credentials to log in to that PC or MacBook.
ServerUrl For Web Viewer, this logs the URL that initiated the transaction. For Protected PDFs, this is the server that Adobe pinged.
Message (or 'Error' in column view) If there's an error or denial to block the user from gaining access, the error code will be logged here. If you're a Vitrium Security Enterprise customer with an External Service that provides custom error messages, this will also contain those messages.
ServerUrl These are the endpoints that the Web Viewer or Protected PDF communicated with.
OfflineDays Will contain the DRM policy offline days if there is one defined, for this transaction.
OfflineDaysDescription Contains the string equivalent of OfflineDays.
WatermarkContent Contains the watermark formula based on either the content setting or, if you're a Vitrium Security Enterprise customer and using the VersionUnique API, it would list any overrides that you utilized.
IsIgnored

If you cleared usage for this transaction, it will report TRUE. IsIgnored=TRUE records are no longer referenced when enforcing DRM policies and no longer count towards device limits.

AnalyticsSessionId NOT USED and will be removed in time.
CustomField NOT USED and will be removed in time.
Type (or 'Method' in the column view) Type of transaction (see table below)
ClientAppName (or 'App' in column view) Name of the browser or PDF viewing app that the user tried to access content with. 
ClientAppVersion
(or 'Version' in column view)
Version of browser or PDF viewing app that the user accessed content from.
ClientLanguage Language of the browser or PDF viewing app that the user accessed content from.
ClientOperatingSystem (or 'OS' in column view) Name of the operating system that the user accessed content from.
ClientDeviceName Type of device the user accessed content from.
ContentType

Type of content (see FileName). Values will be: aud (audio), doc (PDF),

img (image), and vid (video).

 

Description of activities listed under the 'Method' column (or 'Type' in exported report):  

Method / Type  Description
ChangePasswordWithToken User was forced to change their password. When a user manually changes a password, those are not logged.
DeactivatedContentAccess When a user tries to access content that was disabled, the attempt will be logged.
DownloadSourceFile Indicates the user has downloaded the original source file. 
PdfUnlockAutoDevice The PDF has been unlocked automatically by SSO, which remembers the username/password combo. 
PdfUnlockAutoTrueSso VersionUnique API was used to deliver a Protected PDF, including Download To Print documents.
PdfUnlockManual The PDF has been unlocked by entering username/password.
PdfUnlockOffline If the user has offline access and they opened the Protected PDF while offline, this is logged once they go back online.
PortalUnlock User Portal login attempt.
Print Protected PDF was printed.
PrintScreen The user attempted to take a screen print when the content setting indicates to disable Web Viewer screen captures.
RemoteUnlock When a user was provided a remote unlock code for a Protected PDF.
RequestPrintDoc The user has downloaded a hi-res PDF for printing. There should be a matching Print event once they actually print.
Social Protected PDF content that is using a social DRM content setting was unlocked.
UniqueDownload Tokenized VersionUnique download was used to deliver a Protected PDF.
WebPrint Web Viewer content was printed.
WebSocial Web Viewer content that is using a social DRM content setting was unlocked.
WebUnlockAuto The Web Viewer has been unlocked automatically using info from the browser's cookie.
WebUnlockAutoTrueSso oAuth or External Service was used to authenticate the user.
WebUnlockManual The Web Viewer has been unlocked by entering Username/Password into a login form.
Does Vitrium track analytics data for a document when a person goes offline?

Yes, Vitrium does track analytics data when a user accesses a document in offline mode. Vitrium will track all the usual analytics - pages visited, time spent on each page, read-through-rate, etc. - and then process it the next time that user comes back online and opens the same document in the same browser. This condition needs to be met for that analytics data to reach Vitrium’s servers. Once it does, the data enters the queue and may take some time to process but it will eventually show up in the detailed analytics reports.

How can I customize the web viewer login form?

You can add your logo, a text description, and change the banner color of the login page in the Web Viewer Settings in your Vitrium Security account.

Further details on how to make these changes can be found in the Vitrium Security Admin Manual: https://view.protectedpdf.com/NpcYTE#bookmark=web%20viewer%20settings