Особенности COUNTER в «Знаниум»
Стандарт библиотечной статистики COUNTER R5 используется для обеспечения единообразия, сравнимости и сопоставимости статистики различных агрегаторов контента, в том числе электронных библиотечных систем.
Достоверность данных обеспечивается независимым аудитом. Метрики ЭБС, прошедших аудит на соответствие COUNTER, можно сравнивать и складывать при формировании итоговой отчетности, в том числе автоматически, что позволяет SUSHI API, входящий в стандарт.
Особенности сбора данных
Данные в стандарте COUNTER ЭБС Znanium собирает с января 2021 года.
В качестве хранилища выбрана отечественная колоночная СУБД Yandex ClickHouse, которая обеспечивает высокую скорость запросов к большим объемам данных.
Показатели Unique и Total требуют использования сессий, для этой задачи используются стандартные php-сессии с временем жизни 24 минуты.
Описанная в стандарте необходимость отслеживания и исключения из подсчетов повторных кликов, созданных с интервалом менее 30 секунд, потребовала реализации дополнительных мини-сессий, из которых складываются цепочки хитов. На этапе формирования отчетов цепочки сортируются, лишние клики отбрасываются.
(исключением является поиск).
Стоит также отметить, что сбор данных осуществляется только для авторизованных пользователей, а статистика интернет-роботов и краулеров игнорируется.
Особенности метрик COUNTER
Request — запрос полнотекстового документа, то есть чтение документа в ридере при наличии полного доступа.
Investigation — исследование документа, в нашем случае это посещение страницы полной карточки документа. Особенностью данного показателя является то, что в него включаются Request, что есть чтение — это тоже исследование. Вторая особенность в том, что к Investigation относятся переходы в ридер как в случае полного доступа к документу, так и в случае ограниченного доступа к документу.
Unique_Item_Request — посещение ридера пользователем в рамках одной сессии, другими словами это книговыдача. В случае повторного посещения тем же пользователем того же документа в рамках другой сессии фиксируется новый Unique_Item_Request.
Unique_Item_Requests — количество книговыдач за отчетный период.
Total_Item_Requests — общее количество посещений ридера пользователями за отчетный период, за исключением повторных заходов в течение 30 секунд (Double_Clicks).
Unique_Item_Investigations — в один уникальный Investigation нужно включать все варианты страниц, отнесенных к типу Investigations, на которые заходил пользователь (если за сессию просмотрели карточку документа и зашли в ридер, это один уникальный Investigation).
Total_Item_Investigations — в Total Investigation нужно суммировать все варианты страниц, отнесенных к типу Investigations, на которые заходил пользователь (если за сессию просмотрели карточку документа и зашли в ридер, будут засчитаны два Total_Item_Investigations).
Searches_Regular — поиск по каталогу с отображением поисковой выдачи.
Дополнительно к Searches_Regular относятся запросы страниц рубрик классификаторов, которые содержат списки кратких карточек документов. На первый взгляд, список документов в рубрике классификатора необходимо относить к понятию Investigation, однако консультанты COUNTER в ответе на наш запрос отнесли эти посещения к Searches_Regular.
Посещение детальной страницы журнала (с перечнем выпусков) тоже относим к Searches_Regular.
Кроме того, на сбор статистики поиска не распространяется правило игнорирования Double-Clicks, цепочек событий с интервалом не более 30 секунд. То есть в поиске учитываются все повторные клики.
Searches_Federated - количество запросов, когда поиск выполняется удаленно через API (все наши поисковые запросы по API, в том числе поиск из EBSCO).
Title — документ того или иного типа. (Examples of titles are journals and books.) В ЭБС Znanium Title — это выпуск журнала, книга или отдельно существующая статья.
Item — это термин для составных частей документов, примеры Item: статья журнала, глава или раздел книги, мультимедийный файл. (Examples of items are articles, book chapters, and multimedia files.)
В ридере ЭБС Znanium документы не разделяются на составные части, к которым можно было бы обратиться отдельно (разбиение на страницы не в счет).
Таким образом, для ЭБС Znanium Item и Title - одно и то же.
Section_Type — тип составной части документа (Article, Book, Chapter, Other). Считаем, что в ЭБС Znanium только один Section_Type — Book.
Access Denied — отсутствие доступа, которое обусловлено или отсутствием лицензии или исчерпанным лимитом:
No_License фиксируется, когда пользователь не может получить доступ к уникальному элементу контента, потому что его учебное заведение не имеет лицензии на контент — это наши отказы.
Limit_Exceeded (превышен лимит) учитывается, когда пользователь не может получить доступ к документу, потому что лимит на количество одновременных пользователей был превышен. В контексте ЭБС Znanium, как и в других продуктах с предварительной авторизацией, такие запросы подсчитать невозможно, т.к. количество пользователей ограничивается не в момент запроса к документу, а во время создания подписки и проверяется в момент авторизации пользователя.
Platform — это ЭБС Znanium.
Databases — на первом этапе внедрения COUNTER представлена одна Database, которая содержит документы из каталога ЭБС.
Отчеты COUNTER
Интерфейс
Отчеты собраны в кабинете библиотекаря учебного заведения — клиента ЭБС Znanium, таким образом каждый отчет представляет собой данные по активности зарегистрированных и анонимных пользователей данного учебного заведения.
В мастер-отчетах (Master Reports) могут быть использованы фильтры, предусмотренные стандартом.
Наиболее информативные сочетания фильтров (стандартные представления, Standart Views) оформляются в виде отдельных отчетов.
Форматы отчетов
В соответствии со стандартом, каждый отчет обязан быть представлен в виде Excel-файла или файла в формате .tsv (tab-separated-value file) или обоих вариантов.
Филиалы
В соответствии с принятыми в ЭБС Znanium правилами формирования отчетности для филиалов учебных заведений, отчеты COUNTER предоставляются для головных подразделений, для отдельных филиалов, а также для филиалов в сумме с головным подразделением.
Дискретность по времени
Детализация отчетов подразумевает минимальный отчетный период в один месяц. Мастер-отчеты могут покрывать более крупные периоды с дискретностью в месяц.
Журналы в отчетах
В стандартных представлениях отчета TR под Journal понимаем не выпуски журналов, а наименования.
Перечень отчетов
ЭБС Znanium соответствуют следующим типам платформ стандарта COUNTER: Aggregated Full Content, eBook, eJournal. Отчеты, которые стандарт требует реализовать для данных типов платформ:
- Platform Master Report
- Platform Usage
- Database Master Report
- Database Search and Item Usage
- Database Access Denied
- Title Master Report
- Book Requests (Excluding OA_Gold)
- Book Access Denied
- Book Usage by Access Type
- Journal Requests (Excluding OA_Gold)
- Journal Access Denied
- Journal Usage by Access Type
- Journal Requests by YOP (Excluding OA_Gold)
COUNTER SUSHI
COUNTER_SUSHI — это RESTful-интерфейс, возвращающий отчеты COUNTER 5 в формате JSON, позволяющий получать сведения об использовании ЭБС Znanium в других приложениях. URL-адрес SUSHI состоит из четырех основных разделов:
- базовый URL-адрес SUSHI-сервера
- конкретный запрашиваемый отчет
- учетные данные аутентификации
- параметры отчета, такие как диапазон дат, список метрик, и т.д.
Обязательные параметры для всех запросов выдаются службой поддержки Znanium:
- customer_id - идентификатор клиента ЭБС
- api_key - ключ api-аутентификации
Ниже представлен перечень ресурсов и параметров, необходимых для успешной выгрузки отчетов COUNTER_SUSHI.
https://znanium.ru/counter-sushi/status
Возвращает текущий статус службы отчетов, поддерживаемых API.
https://znanium.ru/counter-sushi/reports
Возвращает детальный список поддерживаемых отчетов. С подробным описанием и прямой ссылкой на его выгрузку.
Необязательные параметры:
search - поисковая фраза, позволяющая отфильтровать отчеты по названию.
https://znanium.ru/counter-sushi/reports/<report_name>
Возвращает json-отчет COUNTER 5 по заданным параметрам. Вместо <report_name> указывается наименование отчета.
Полный перечень поддерживаемых отчетов: pr, pr_p1, dr, dr_d1, dr_d2, tr, tr_b1, tr_b2, tr_b3, tr_j1, tr_j2, tr_j3, tr_j4.
Обязательные параметры:
begin_date - дата начала отчетного периода.
end_date - дата окончания отчетного периода.
Даты указываются в формате гггг-мм-дд или гггг-мм.
Статистика предоставляется кратно месяцу, поэтому даты, не относящиеся к концу или началу месяца будут преобразованы соответствующим образом.
Важно отметить, что необязательные параметры применимы только к Master-отчетам pr, dr, tr, в то время как остальные являются их стандартными представлениями с фиксированным набором метрик и фильтров.
Множественные значения параметров указываются в виде перечня, разделенного символом "|". Если параметр не указан, будет использован полный перечень для текущего отчета.
Необязательные параметры:
metric_type - перечень возвращаемых метрик отчета.
Пример: Total_Item_Investigations|Unique_Item_Investigations|Unique_Item_Requests|Unique_Title_Requests|No_License|Limit_Exceeded
data_type - перечень используемых в отчете типов данных.
Пример: Platform|Book|Journal|Article
access_method - перечень методов доступа, используемых в отчете.
Пример: Regular|TDM
access_type - перечень методов доступа, используемых в отчете.
Данный параметр применим только для отчетов TR.
Пример: Controlled|OA_Gold
yop - год публикации изданий, представленных в отчете.
Данный параметр применим только для отчетов TR.
Пример: 2001|2006
granularity - степень детализации отчета. По умолчанию используется значние "month" (помесячная статистика), альтернативой является "totals" - за весь выбранный период.
Более подробную информацию можно найти в официальной документации по COUNTER 5.