Contents

Installing the Google Analytics Tracking Code

In order to use Google Analytics (hereinafter called GA), the user should first install the GA tracking code on the pages generated by the reader application. By default, the code is embedded in the templates of the pages of the reader application, but the so-called tracking identifier should be given. The identifier is available in the Google Analytics administration panel, in the “Service > Tracking information > Tracking code” section, and it has the following form: UA-<number sequence>-<number sequence>, for example:

Once the code has been copied from Google Analytics pages, it should be placed in the  ................ configuration file as the ................ configuration parameter value. The tracking code should be embedded correctly after the changes have been saved in the configuration file and after the reader application has been restarted. As a result, the tracking code will be visible in the HTML code of the web pages of the reader application, and data will be reported to GA.

Advanced Google Analytics Configuration

Apart from the installation of the tracking code, configuring advanced Google Analytics functions is also recommended. The most important advanced settings are described below.

Removing the Unnecessary Parameters from Website Addresses

A removal of unnecessary, in a given context, parameters from web addresses can be configured in the administrative options of GA, in the “View” section, in the “View settings” option, in the “Exclude URL query parameters” – value “navref,ref” should be entered there.

Configuring the Search Tracking inside the Digital Library

Search tracking inside the digital library can be configured in the administrative options of Google Analytics, in the “View” section, in the “View settings” option. The user should enable “Site search tracking” option and the “Search categories” there and enter:

• the “q,search_value1,q,search_value2,q,search_value3,q,search_value4” sequence in the “Parameter” field– as a result, simple and advanced queries (the first four constituents) will be tracked; and
• the “qf1,qf2,qf3,qf4,qf5” sequence in the “Parameter” field – as a result, up to five search filters used by users will be tracked at once.

Site search reports can be found in the analytical part of GA, in the “Behavior > Search terms”

Configuring Goals

In GA, goals are for tracking the number of user sessions in which a particular action – which is important from our point of view – is undertaken. In the case of an online store, the action could be adding a product to the cart, making a purchase, or sending a contact form. For a digital library, we suggest defining a series of goals described below.

The goals are defined in the administrative part of GA, in the “View > Goals" section. Once the goals have been defined, the data necessary for displaying statistics related to goals are collected in GA. The first effects of that can be checked in the analytical part of GA, in the “Conversions > Goals > Overview” section, after a day or two.

The User Has Used the Simple Search during the Session

Goal settings as in the screenshot below. The value of the regular expression: /dlibra/results\?q\=.+\&action=SimpleSearchAction\&.+

The User Has Used the Advanced Search during the Session

Goal settings as in the screenshot below. The values of particular fields:

• the value in the “Begins with” field: /dlibra/results?action=AdvancedSearchAction
• the “Path” switch: ON
• the value in the “Step 1” section:
  • name: advanced search form
  • screen/page: /dlibra/advsearch
  • required: YES

The User Has Used Search Result Filtering during the Session

Goal settings as in the screenshot below. The value of the regular expression:  /dlibra/results\?.+\&qf1=.+

The User Has Used Search Result Sorting during the Session

Goal settings as in the screenshot below. The value of the regular expression: /dlibra/results\?.+\&sf=.+

The User Has Browsed Metadata Value Indexes during the Session

Goal settings as in the screenshot below. The value in the “Begins with” field: /dlibra/indexsearch

The User Has Displayed the Content of a Digital Object during the Session

Goal settings as in the screenshot below. The value of the regular expression: /dlibra/publication/[0-9]+/edition/[0-9]+/content.*

The User Has Remained for at Least Five Minutes on the Page with the Content of a Digital Object

Goal settings as in the screenshot below. The values of particular fields:

• category: reading
• action: heartbeat
• label: remains empty
• value: remains empty
• Use the action value as the goal value during conversion: YES

The time spent on a page with the content of a digital object is tracked by dedicated reporting scripts built into the code of the dLibra system, in the page on which the content of the object is presented. When the page is open, an event is sent to GA every 5 minutes (it is described as [category: reading, action: heartbeat]), so the period of time during which the user interacts with the content of the object (for example, browses a PDF file) can be tracked. Without additional support on the part of the system of the digital library, such an interaction is not caught by the GA tracking scripts, which results in significant underestimation of user session times.

The User Has Downloaded a Digital Object in the Form of a ZIP Archive during the Session

Goal settings as in the screenshot below. The value of the regular expression: /Content/[0-9]+/zip/

The User Has Spent at Least Five Minutes in Total on a Page of the Digital Library during the Session

Goal settings as in the screenshot below.

Data Analysis Samples

Below, examples of data analysis concerning user traffic in a digital library are shown. Those examples are by no means exhaustive, but they have been selected with the view to highlighting selected GA possibilities which are interesting in the context of digital libraries.

Popularność obiektów - liczba wyświetleń strony z metadanymi i wyświetleń on-line

1. Wybrać raport: ZACHOWANIE / Analiza treści
2. W tabeli, w kolumnie "Poziom 1 ścieżki strony" kliknąć /dlibra/
3. W tabeli, w kolumnie "Poziom 2 ścieżki strony" kliknąć /publication/
4. Widoczna jest tabela z identyfikatorami publikacji, posortowana domyślnie wg liczby odsłon, malejąco. Odsłona to w tym kontekście to:
   1. Dla publikacji z treścią: wyświetlenie strony z metadanymi lub wyświetlenie treści on-line.
   2. Dla publikacji bez treści (np. wyższego rzędu elementów publikacji grupowych - np. całe czasopismo): wyświetlenie strony z opisem/strukturą danego elementu publikacji grupowej.
5. Kliknięcie w identyfikator publikacji w kolumnie "Poziom 3 ścieżki strony" powoduje wyświetlenie tabeli dotyczącej sposobu interakcji z daną publikacją. W tabeli dla publikacji z treścią powinny znajdować się dwa wiersze:
   1. /zip/ - oznacza pobranie publikacji jako archiwum ZIP
   2. /<nazwa pliku głównego> - oznacza wyświetlenie publikacji on-line
6. Na kroku (3) powyżej można wprowadzić dodatkowe filtrowanie aby wyświetlić tylko pobrania. W tym celu należy:
   1. Dodać "Wymiar dodatkowy" (przycisk nad tabelą) o nazwie "Poziom 3 ścieżki strony"
   2. Włączyć zaawansowane filtrowanie wierszy tabeli (link "zaawansowane" po prawej stronie nad tabelą) i wybrać:

Popularność obiektów - liczba wyświetleń on-line i pobrań jako archiwum ZIP

1. Wybrać raport: ZACHOWANIE / Analiza treści
2. W tabeli, w kolumnie "Poziom 1 ścieżki strony" kliknąć /Content/
3. Widoczna jest tabela z identyfikatorami publikacji, posortowana domyślnie wg liczby odsłon, malejąco. Odsłona to w tym kontekście liczba wyświetleń on-line i pobrań jako archiwum ZIP.
4. Kliknięcie w identyfikator publikacji w kolumnie "Poziom 2 ścieżki strony" powoduje wyświetlenie tabeli dotyczącej sposobu interakcji z daną publikacją. W tabeli powinny znajdować się dwa wiersze:
   1. /zip/ - oznacza pobranie publikacji jako archiwum ZIP
   2. /<nazwa pliku głównego> - oznacza wyświetlenie publikacji on-line
5. Na kroku (3) powyżej można wprowadzić dodatkowe filtrowanie aby wyświetlić tylko pobrania. W tym celu należy:
   1. Dodać "Wymiar dodatkowy" (przycisk nad tabelą) o nazwie "Poziom 3 ścieżki strony"
   2. Włączyć zaawansowane filtrowanie wierszy tabeli (link "zaawansowane" po prawej stronie nad tabelą) i wybrać:

Zainteresowanie obiektami - czas spędzany na stronach z treścią obiektów

1. Wybrać raport ZACHOWANIE / Zdarzenia / Najczęstsze zdarzenia.
2. W tabeli ze zdarzeniami kliknąć w "reading" (w kolumnie Kategoria zdarzenia).
3. W tabeli ze zdarzeniami kliknąć w "heartbeat" (w kolumnie Akcja zdarzenia).
4. Widoczna tabela przedstawia w kolumnie "Etykieta zdarzenia" listę identyfikatorów wydań, przy treści których użytkownicy spędzili najwięcej czasu. Każda z etykiet ma następującą strukturę: edition-<numeryczny identyfikator wydania>-format-<numeryczny identyfikator formatu>, przy czym ostatni element jest wypełniany tylko w przypadku obiektów wieloformatowych.
   
5. Interpretacja poszczególnych kolumn jest następująca:
   1. Całkowita liczba zdarzeń - łączna liczba pięciominutowych interwałów spędzonych przez użytkowników nad treścią danego wydania
   2. Unikalne zdarzenia - liczba unikalnych sesji użytkowników, w których użytkownik spędził nad treścią danego wydania przynajmniej pięć minut
   3. Wartość zdarzenia - łączna liczba minut spędzona przez użytkowników nad treścią danego wydania
6. Dla ułatwienia analizy danych można dodać wymiar dodatkowy do tabeli (przycisk tuż nad tabelą). Sugerowane wymiary to:
   1. Strona - spowoduje dodanie kolumny z linkami do poszczególnych obiektów
   2. Tytuł strony - spowoduje dodanie kolumny z tytułami poszczególnych obiektów