Using Google Analytics with FL-Islandora
|FL-Islandora Guides (FIG)|
|Permissions and users|
|Collection Creation and Management|
|Creating Content Objects|
|Suppressing Objects From View|
|Fl-Islandora and Mango|
|Workflow: From Spreadsheet to Islandora|
|Using Google Analytics with FL-Islandora|
|Collection Information Menu|
|A-I. FL-Islandora Glossary|
|A-II. Field Inventory|
Overview of statistics in FLVC's Islandora
last updated 5/22/2018
FLVC collects statistics in 4 ways:
1) Log files 2) Islandora Usage Stats module 3) Google Analytics 4) Object counts in the Report tab
FLVC keeps server log files for the Islandora sites. As of Fall 2017, FLVC is not performing analysis on these nor releasing reports. However, the information is available and in theory allows much more detailed reporting than the other methods of collection. For example, server logs show access to files, such as download of PDFs, which Google Analytics is not able to do. Server logs keep a date stamp on each activity, which the Islandora Usage Stats module does not do. Server logs also allow reporting of PALMM materials across the institutional site and the PALMM Islandora site, which is not available through any other method.
Islandora Usage Stats module
Since July 1, 2016 (or launch date of your site if your site was opened to the public more recently), all FLVC Islandora production sites have collected statistics using the Islandora Usage Stats module. This collects and stores the usage information directly through Islandora by recording a view or download and storing that information in a database within Islandora. A major advantage to Islandora Usage Stats is that it both tracks downloads of files, such as PDF downloads, which Google Analytics is not able to do, and it makes recorded information directly available to libraries without needing to request a report from FLVC.
FLVC has installed Google Analytics on each site, and statistics have been collected since site launch. You can email to firstname.lastname@example.org and request anyone on your site be set up with access to pull reports. You can request specific IP addresses be excluded from having information collected, which you might want to do if you have a specific computer with a static IP which is used for working on the Islandora site. Once you have access to Google Analyticss a major strength of the product is the wide variety of reports you can pull, and the ability to pull usage information by date range which is not supported by Islandora Usage Stats. FLVC also makes available several custom reports for common needs such as tracking searches run within a collection, usage of all items by collection, etc.
Object counts in the Report tab
Since May of 2018, the "Report" tab, to the right of the "Manage" tab is available to authenticated users and provides the ability to produce viewable and downloadable .csv object counts that meet selection criteria. You can obtain counts, by Content Model and Collection, of all objects in your repository, or of all objects in a specific collection. While the "Report" tab has been available from the start, prior to May 2018 the counts reported were of "parent" objects (e.g., books, serials, compound objects), but that functionality has been expanded to provide counts of both "parent" and "child" objects (e.g., books and book pages, etc.). This provides the ability to report on the actual number of files contained in a given site, broken down by Content Model, along with a total of all objects and files in the repository.
Using Google Analytics with FL-Islandora
Get Access to your Islandora site's analytics
FLVC pre-installs Google Analytics on all Islandora sites. If you already have a site, it has been collecting statistics since launch, and those statistics are ready for you to view and analyze.
To access statistics for a site you must have a personal Google Analytics account. If you do not have a user account sign up here: http://analytics.google.com
Once you have a user account contact email@example.com requesting access to Google Analytics for your site. Be sure to include the email address you use to log in to Google Analytics and the URL for your Islandora site.
Using this guide: Google Analytics has set terminology in how they measure web traffic. Please consult this glossary to better interpret your GA data: https://analyticsacademy.withgoogle.com/course02/assets/html/GoogleAnalyticsAcademy-PlatformPrinciples-Glossary.html
Comparison of key terms: https://support.google.com/analytics/answer/1257084?hl=en#visits_vs_visitors
- Pageview :
- An instance of a page being loaded (or reloaded) in a browser.
- The amount of times visitors arrive on individual pages of your Website. If a user reloads a page, that action will be counted as an additional Pageview. If a visitor navigates to a different page and then returns to the original page, a second Pageview will be recorded as well. Pageviews allow you to see which pages on your site are the most popular
- A Pageview represents an HTML or PHP page loaded in a Web browser window. Multiple views of the same Web page are counted in this metric.
- Pageviews measure traffic volume over time at the page-level, whereas Visits measure traffic at the Visit- or session-level. You can use Pageviews to measure aggregate traffic for groups of Web pages and subsites.
- The period of time a user is active on your site or app. By default, if a user is inactive for 30 minutes or more, any future activity is attributed to a new session. Users that leave your site and return within 30 minutes are counted as part of the original session. See: https://support.google.com/analytics/answer/2956047
- A single-pixel image request that is used to send data to Google Analytics.
- A subset of a Google Analytics account property that can have its own unique configuration settings. You can create multiple views for a single property and modify what data shows in each view.
FLVC Custom Reports
Overview of Custom Reports
FLVC has created custom reports to assist in filtering and interpreting your site’s traffic. After you have created a Google Analytics account, and gotten setup to view analytics for your site, you can click the link for one of these reports and install that report on top of your site's statistics. Installation instructions are further down the page.
Links for Downloading Custom Reports
- Note: On July 1, 2016, FLVC phased out custom variables from Google Analytics. This changed how the info was collected. Therefore, different custom reports are needed to view info from before that date versus after that date.
FL-Islandora Rpt 1: Object Pageviews:
June 30, 2016 and earlier report: https://www.google.com/analytics/web/template?uid=sNar_r6hSpyAXE5-RqxmhA
July 1, 2016 to present report: https://analytics.google.com/analytics/web/template?uid=-6l8T-YXTyGR6ejWLXbfPg
A basic breakdown of all Islandora objects with pageviews and their pageview count.
FL-Islandora Rpt 2: Object pageviews - excluding collection objects:
June 30, 2016 and earlier report: https://www.google.com/analytics/web/template?uid=SMZSwCCwTZ6TcFcQGjaAYQ
July 1, 2016 to present report: https://analytics.google.com/analytics/web/template?uid=SWrOzXRcQWCiAdr3gx2R7g
This report displays a list of all Islandora objects and their pageview counts excluding collection objects and their pageview counts. This report is good for if you want a total of pageviews on unique items in your digital library without including pageviews for the unique collection objects.
FL-Islandora Rpt 3: Pageviews by collection:
June 30, 2016 and earlier report: https://www.google.com/analytics/web/template?uid=z3UelNbqSlmwnvsZh42bIg
July 1, 2016 to present report: https://analytics.google.com/analytics/web/template?uid=N3wJZWdeSn6APi23mo3a5g
This report aggregates pageviews by collection. The first level, Custom Variable (Value 01), identifies collection PIDs along with sum of pageviews of all children of each collection and the pageviews of the collection object. The second level breaks down each collection object. Selecting a collection object PID lists the PIDs of child objects within each collection including the PID of the collection object and the pageview count of each. The total pageviews presented in this second level should match the pageview count of the collection object selected in the previous level.
FL-Islandora Rpt 4: Searches by collection:
June 30, 2016 and earlier report: https://www.google.com/analytics/web/template?uid=o6jPDJTuR_Ck8tofaKEQ8g
July 1, 2016 to present report: https://analytics.google.com/analytics/web/template?uid=SqmysH2XRa-a5Q6YRuJTmQ
This report counts queries made from within a collection. The first level identifies collection PIDs along with the sum of each search query that took place from within that collection object. The second level describes the query made and number of times it was made from this collection. This report does not describe the source of all traffic to your digital library items. Queries made from external sources such as search engines and catalogs are not included in this report.
FL-Islandora Rpt 5: Pageviews by content model:
June 30, 2016 and earlier report: https://www.google.com/analytics/web/template?uid=t7HcskewR42j8ME2aE_eCA
July 1, 2016 to present report: https://analytics.google.com/analytics/web/template?uid=_tgc0Xr0T2y_dPlnixAaYw
List of content models and total pageview count for all objects using the corresponding content model. The second level breaks down objects in corresponding content model into a list of PIDs and each of the objects pageviews.
FL-Islandora Rpt 6: Pageviews by collection and by content model:
June 30, 2016 and earlier report: https://www.google.com/analytics/web/template?uid=j2EQZuklTX-hqhFHt4aw4w
July 1, 2016 to present report: https://analytics.google.com/analytics/web/template?uid=srEYEIarRKO65UrSsPehww
This report is a combination of the views by collection report and the content model report. The first level, Custom Variable (Value 01), identifies collection PIDs along with sum of pageviews of all children of each collection and the pageviews of the collection object. Selecting one of these collection PIDs will take you to the second level. The second level breaks down a collection by content models used by objects in that collection. Each row will contain a content model along with the sum of pageviews of all objects using that content model within the previously selected collection. Selecting a content model breaks down into a list of objects using this content model. The third level contains a list of PIDs using the content model and the pageview count for each of these objects.
Instructions for Installing an FLVC Custom Report
1) In the section above, click the link to the report you would like to install. That link with take you to your Google Analytics account showing the message "A Custom Report configuration was shared with you."
2) Select a view from the dropdown. You should have only one option for Islandora Production. If you track other websites with your GA account you may see these listed as well.
3) Once you've selected the view (ie. Islandora site), click "Create".
4) After creating the report you will be taken automatically to the report page.
5) Next time you log in to Google Analytics, here's how you get back to this page: From your analytics.google.com home screen, browse to your Islandora site. Then look at tabs along the top of the screen, and click the tab labeled “Customization”. Then look at the “Custom Reports” links in the lefthand sidebar, and click the report you'd like to view.
Using Google Analytics: Common Tasks
There are many online resources covering Google Analytics. You can run searches in Google to find instructions or answers to questions and tutorials on this software. Below are some basic tasks in the software to get you started.
Date Range: View statistics by date range
The default range of traffic for a report is set to the last 30 days of activity. To view an extended range of data navigate to the upper-right hand section of a report and select the dropdown arrow of the date range field. Use the calendar or the text fields to set the desired range you would like to view. Select apply and wait for the report to regenerate.
Search Terms: See what searches visitors run on your site
1) Log in to analytics.google.com and browse to statistics for your Islandora site.
2) Along the left of the page, click the link for "Behavior".
3) Under "Behavior", click on "Site Search".
4) Under "Site Search", click on "Search Terms".
5) In the following page you will see a table of queries made within your Islandora site along with associated data. To learn more about a particular search term, such as the terms destination page, select the term from this list.
Locate Page Data
To see a list of all pages with traffic data on your Islandora site navigate to the Reporting tab and select Behavior from the left sidebar. From the list of options select "Site Content" -> "All Pages". This section features an interactive table of your site’s pages.
To change the available items from paths to more readable Page Titles, locate the small menu above the table named "Primary Dimension". Change this option from "Page" to "Page Title". Please note that these Titles are not unique entries. All pages with matching titles are aggregated under each of these labels. For example, the Page Title “Edit datastream” represents the “edit datastream” page of every datastream that has been edited in Islandora. This may be thousands of unique “pages”.
To find a particular page or Islandora object you can use the search field found at the top right of the table. If you are searching for a PID or a query leave the Primary Dimension setting as “Page”. You cannot simultaneously search both URLs and Page Titles from this search field.
Your pageviews can be more easily broken down by type by using the Content Drilldown feature. Navigate to Behavior > Site Content > Content Drilldown. On this page you’ll see a list of paths in your Islandora site tracked by GA. They are broken down by “subdirectory” along the URL path. Selecting an item from this list will generate a list of “subdirectories” available of the item you have just clicked. You can drill down to the level of an object in Islandora by looking how the URL of that object is constructed. For example: This object’s PID can be located in Content Drill down by navigating down through "Islandora" -> "object". All object “pages” in Islandora will be located within this level. Understanding the level hierarchy used by GA is vital to creating your own custom reports.
Export Data to Excel
Google Analytics allows the export of any viewable report into a number of formats. From the report toolbar select Export and choose the format for your exported report. The detail and layout of the exported report will depend on what report you are accessing.
Google Analytics defines certain user interactions with elements of a site as “Events”. This may be anything that is not tracked as a typical Pageview. To access this data navigate to the "Reporting" tab and select "Behavior" from the left sidebar. From the list of submenus select "Events" -> "Overview".
One the overview page you’ll see a list of Event Categories and a count of “events” that have taken place in each. Select "View Full Report" from this table or select "Top Events".
From the Top Events page you can select a category to drill down to see the event “action” to see more detail of the type of interaction a user had with the page. Select the action label to drill down and see a list of URLs that defined each of these hits. For example, if you want to see a list of PDFs downloaded from your site select "Behavior" -> "Events" -> "Top Events" -> "Downloads" -> "PDF".
Traffic Sources: See how people found your site
To find information on how users are getting to your site select the "Reporting" tab and locate "Acquisition" from the left sidebar. Expand the "All Traffic" submenu to reveal your traffic options.
Google Analytics automatically sorts traffic sources into common groups, or Channels. These breakdown as follows:
- Direct/(none): Visitors enter a URL within your site directly into their browser
- Organic: Traffic from search engines such as Google, Bing, etc.
- Referrals: Visitors navigate to your site via a link on a 3rd party website. For example, a link on your library website.
- Social: Visitors navigate to your site via a social networking platform such as Facebook, Twitter, etc. This is similar to referrals but ‘Social’ traffic comes from 3rd party sources GA recognizes as a Social networking site.
- Email: Traffic originating from email.
There are additional channels such as those resulting from paid sources or advertising.
To see additional data on any of these channels click on them to drill down. "Direct" will provided a list of landing pages. "Organic Search" will provide a list of keywords search in search engines. To sort by search engine select "Source" as the Primary Dimension. Select "Landing Page" as "Primary Dimension" to see where on your Islandora site a user entered. "Referrals" will provide a list of websites linked to Islandora that visitors have used. Social will provide a list of social networks linked to Islandora that visitors have used.
This report will list an aggregation of all traffic broken down by source (typically the 2nd level dimension of the channels above) and the medium (one of the channels). In the example here the number one source of traffic is Google (source) searches -with traffic from searches being organic (medium). The number two source of traffic is listed as (direct)/(none), meaning the user typed the desired URL right into their browser -therefore providing no defining external source of the traffic.
You can see lists of these dimensions sorted separately by selecting "Source" or "Medium" from Primary Dimension.
This report provides a more detailed list of referrals, including referrals from “Social” traffic. This list is helpful when you do not wish to separate your social networking traffic from your other 3rd party links, and if you’d like to see what traffic sources are linked to what objects. To see a list of objects each source is linked to just select an item from the list of sources.
Google Analytics provides a number of packaged reports on user data. These can be found by going to the Reporting tab and selecting Audience from the left sidebar. To see a quick breakdown of this information select "Overview".
To get a detailed list of the languages used by browsers that are accessing your Islandora site, expand the Geo submenu from within Audience and select Language. The list provided will not explicitly state the language, only a language code adapted from ISO 639 and 3166 standards.
The location report will detail the traffic of your Islandora site by country, city, continent, of origin, and so on. Select an item from the list to drill down sub-regional data. For example, selecting United States will break down traffic by state. Selecting state will allow you to drill down into city or metro region and so on. Each level will provide a geographic overlay of the data because Google is fancy.
Schedule E-Mail Reports
A window will appear where you can configure the details of your report email.
The report can be emailed in any format available for export.
You may adjust the frequency of the email to daily, weekly, monthly, quarterly, or just once. Changing the frequency will generate additional options to refine the email schedule.
You must provide text in the body of your email in order to be able to send it. The email will appear to be sent from the account you have registered in analytics.
Select Advanced Options to select how the length of time you’d like the report email to be active. This can be scheduled up to a maximum of 12 months. This can be extended later.
In order to cancel or create an extension for "Scheduled Emails" you must be able to access the "View" -> "Personal Tools & Assets" section of Google Analytics FL-Islandora Property. Select the "Admin" option from the header menu and locate "Scheduled Emails" in the "View" column.This link will generate a searchable and sortable list of Scheduled Emails. You will be able to "Delete" and "Extend" the length of your emails from within this page.
You can gain greater control over data comparison with the use of segments. Like reports, segments will allow you to sort and display your analytics data. Unlike reports, segments allow you to compare session or user data within reports and easily maintain these comparisons while moving between separate reports.
To add a new segment to a report you are viewing select "+ Add Segment" from the upper area of your report.
From here you can either add a preset Segment or create a custom segment. Custom segments can be shared much in the same way Reports can be shared. The custom Segment configuration provides more granular options for manipulating data which may not be valuable in analyzing Islandora statistics. Below you’ll find a simple custom segment to filter all session traffic referred from catalog sources. When designing a segment a live preview of the data will appear on the right.
Once you’ve added segments to a report you’ll be able to quickly compare data between your defined groups. Below is report of total pageviews with segments illustrating referrals from Google and library catalogs. The segments will be applied to each row of data in your report. In the case below this is each islandora object available in the report.
Download and View Counts Displays in Islandora: Islandora Usage Stats module
Islandora Usage Stats collects information on all views and downloads and stores the information directly in Islandora.
Islandora Usage Stats has been turned on for all FLVC Islandora sites starting on July 1, 2016 or for sites that opened to the public since then, this module was turned on when the site opened to the public. Information collected by the module is NOT broken out by date. When you retrieve information or when Islandora displays it to the public, the views and download counts are cummulative and there is no way to scope by fiscal year or by other reporting period.
What is being collected
Islandora Usage Stats collects each view of the object, where a person browses to the web interface for the object, and each download of a file associated with that object. Islandora does not provide a download button for all objects. For example, the "Download" button is not available for Videos and so download counts will not be collected nor displayed for a Video object.
When a download or a view is recorded, this information is added to information about the object. All that Islandora does is to add 1 to a view count or download count. There isn't any IP information nor any information about the date and time. Therefor, it is not possible to pull a report by fiscal year or to scope statistics.
You can exclude collection of statistics for hits and downloads from a list of IPs. This might be useful if you have a specific computer with a static IP which is used for digital library work. It is not possible to exclude a range of IP addresses.
To request an IP be excluded, email firstname.lastname@example.org . FLVC does not keep on file any history of IP exclusions, so if you implement an exclusion, we will not keep on file any record of when that exclusion is implemented or lifted.
Public display of Islandora Usage Stats
Statistics are displayed to the public on the "Full Description" tab of each object. For items where a "Download" button is available in Islandora, both "views" and "downloads" will display. For items where no "Download" button is available in Islandora, only "views" will display.
To see a display, click to the "Full Description" tab for any item and look in the top right corner of the object.
Logged in display of Islandora Usage Stats
When logged in to Islandora as Site Admin, Collection Manager, or Supervisor one can see a dashboard of statistics for items in that Collection. It only goes one level deep. So, if you have a Collection with Collections in it and then those child Collections hold items in them, then when you look at the dashboard for that top level Collection, you are only going to see the views for the immediate child Collections. You will not see views for all the items all the way down. On FLVC sites, this dashboard is set up to show 100 items at a time, then you have to click a pager to get the next 10 and so on. You can email email@example.com to get a view of more items. There is no maximum limit to how many items per page can show on the dashboard.
Below is a screenshot of the statistics view for logged in users:
What is Altmetrics
Altmetrics defined: “In scholarly and scientific publishing, altmetrics are non-traditional metrics proposed as an alternative to more traditional citation impact metrics, such as impact factor and h-index. The term altmetrics was proposed in 2010, as a generalization of article level metrics, and has its roots in the #altmetrics hashtag. Although altmetrics are often thought of as metrics about articles, they can be applied to people, journals, books, data sets, presentations, videos, source code repositories, web pages, etc.” - Wikipedia
Goal = Speed: Traditional metrics, like citations take years to accrue. Citation analysis is possible only after grant cycles have ended, tenure decisions have been made, and the state of research has moved on. Altmetrics includes uses and mentions that happen much sooner, and can predict long term value. Altmetrics is about scholarly research, not cultural heritage materials. Not applicable to everything in a digital library. Some kinds of altmetrics = viewed, discussed, saved, cited
Altmetrics display is only available for the Citation content model and the PDF content model
The altmetrics display in Islandora depends on a DOI to show up. Almetrics is also more oriented around scholarly content and publications - altmetrics is a bit like citation analysis but with faster feedback. For these reasons, the display is only implemented in the Citation content model (a content model specific to institutional repository development) and in the PDF content model. These are most likely to hold scholarly publications which have a DOI issued.
FLVC will only pull altmetrics from altmetric.com
Several vendors provide altmetrics including Plum Analytics, Altmetric.com , and ImpactStory. FLVC is pulling from the public free-of-charge API for Altmetric.com . As of Fall 2017, there are no plans to implement any other altmetrics displays in Islandora.
What the Altmetrics display looks like in Islandora
Here's an example: http://diginole.lib.fsu.edu/islandora/object/fsu%3A368803 . In the "Full Description" tab, the colored band from almetric.com's free-of-charge API will show up under the download and view counts for the item. (FSU's site has social media icons, which is a custom display change just for the FSU site. These social media icons are not part of the altmetrics display, so you shouldn't see them on your site, unless social media icons is addressed by the ISG at some point in the future.)
How to implement altmetrics on your site
The altmetrics display pulls from <identifier type="doi"> (or <identifier type="DOI"> ). This is in keeping with Library of Congress's user guide on MODS identifiers. See https://www.loc.gov/standards/mods/userguide/identifier.html .
If the object has MODS with a DOI in the <identifier type="doi"> field and that DOI is formatted like 10.1038/srep16860 ( software won't recognize it when it's formatted like a URL), then Islandora will hit altmetric.com's free-of-charge API. If altmetric.com shows no use, then the colored band won't show up. If altmetric.com shows some use, then the colored band will show up.
Object counts in the Report tab
Who can get to the "Report" tab:
The "Report" tab is available to these roles:
The "Report" tab is NOT available to: site_submitter .
What information is in the "Report" tab:
The "Report" tab gives a total count of collection contents. It counts all objects, including individual Book Pages, Newspaper Pages, Newspaper Issues, and Serial PDFs. Those objects are often hidden from counts, because each is a component of something bigger. For example, a Book is more visible and most other searches and reports will give information about the Book but no information about individual pages.
The best way to use the "Report" tab is to count objects that don't show up when you download a .csv file of site content. For example, the "Report" tab is the only way to count Newspaper Issues (see "Report" tab column labeled "newspaper issue") and total number of PDFs in a Serial (see "Report" tab column labeled "serial pdf"). This can be useful when you have digitized a large newspaper. In an annual report, you can say "digitized 1 newspaper, with 689 issues and 5798 pages". That gives a better sense of the scale than does "digitized 1 newspaper".
How to use the "Report" tab:
1. Click to the Collection you want to find info about. (The Report tab is only available from a Collection; The Report tab is not available from title-level objects such as newspaper or serial titles.) You can run the report from you home collection, and you will get a breakdown of every collection on your entire site.
2. Look along the top of the collection for the "Report" tab and click it.
3. Leave all the search fields blank. If you would like a .csv file of the report, then check the box to "Download a csv file". Click the button at the bottom of the page to "Generate Report".
4. This takes you to a screen showing total counts of each kind of object in Islandora.
Info about columns in the Report:
- The "serial" counts are counts of serial title records. "Serial component" counts are counts of all serial hierarchy tree "branches". "Serial PDF" are all article and issue-level PDFs associated with serial records.
- The last column on the right provides total counts of all objects by collection.
- The last row in the report provides total by Content Model for all collections listed.
- The last cell in the bottom right of the report provides a total count of all objects.
- Note that the counts provided include counts of Islandora objects that have no content files of their own, e.g., book, serial, newspaper, compound objects, as well as counts of objects that have associated content files, e.g., basic image, large image, book page, PDF, thesis, video, audio, etc.
- Note that all objects are counted, whether they appear to be public or not. Objects subject to XACML policies are included in the counts.
When you run the report, you can limit results by: (1) date the object was uploaded to Islandora, or (2) search of a specific Solr field.
Date the object was uploaded will allow you to show growth in a specific period of time. For example, you can show how much was uploaded in a specific fiscal year, or quarter.
Solr field search is not as immediately useful. If you would like to search by Solr field, contact firstname.lastname@example.org for assistance.
- Enter any search criteria such as dates objects were created. By typing "fgs.ownerid" and the name of an Islandora user in the "Optional - search Solr field" box you can limit the search to objects created by a specific user.
- To obtain a complete count of all objects in your repository leave all fields blank.
- To obtain a downloadable CSV file that can be opened and manipulated in Excel, check the "Download a csv file" box.
- The click on GENERATE REPORT