Using JUSP

  • How do I access JUSP?

    If your institution is a member of the UK Access Management Federation, click on "Access the Portal" or "Portal" on the JUSP website and then login using your Shibboleth or OpenAthens username and password. If you then get a pop-up box enter your institution's JUSP assigned login details. Your institutional contact will have been provided with the login credentials for the pop-up box. In the event that they do not know them, please contact the helpdesk and we will supply you with a working username and password. You can also set up your Shibboleth account to bypass this step entirely. If your organisation has asserted an eduPersonEntitlement then you won't see the pop-up box but will be logged straight into JUSP. Further information on eduPersonEntitlements is available at http://jusp.jisc.ac.uk/entitlements/siterep/.

    If your institution does not use Shibboleth or OpenAthens please select NON-UKFED LOGIN and enter JUSP assigned login details. If you do not know what these are please contact the helpdesk and we will supply you with a working username and password.

    Note that access is managed so that only members of staff authorised by the institution are able to access their institution's usage statistics.

  • What does JUSP contain?

    JUSP contains journal (JR1, JR1a, JR1 GOA, JR2 and JR5), book (BR1, BR2 and BR3), database (DB1 and DB2) and platform (PR1) COUNTER-compliant usage statistics and provides a single gateway for libraries to access statistics from participating publishers, gateways and host intermediaries. You can view definitions for each report in the Glossary. You can find a full list of participating publishers and the reports we are collecting on our Participants page. If there are any additional publishers you wish to see in JUSP then please submit them via a facility within the portal. We are only able to work with publishers who are fully COUNTER compliant and provide usage data using the SUSHI Protocol.

    Over 30 types of report are available in JUSP, all derived from the JR1, JR1a, JR1 GOA, JR2, JR5, BR1, BR2, BR3, DB1, DB2 and PR1 reports. You can find a full list of the available journal reports on our Guides to the reports page and other reports on our Guides to book and other reports page.

  • Do JR1 reports include the breakdown of PDF/HTML?

    PDF/HTML breakdown figures are not provided in a consistent format by all publishers, so we don't include this information in our reports. JUSP presents the total usage figure for the specified time period.

  • How do I compare my usage with that of other institutions?

    Usage profiling reports are available for a number of publishers. These reports enable you to compare your usage for a particular publisher with an average for all libraries for which we hold data from that publisher in JUSP and that are in the same Jisc band and region, and in the groups (pre-1992, post-1992, RLUK, etc) to which their institution belongs. Reports can be run by calendar or academic year. There are also two data visualisations 'Compare your site with others in your Jisc Band' and 'Compare your site with others in your Jisc Band' which display a bar chart with your institution highlighted.

  • Can I download and export my own data?

    Yes you can. Report data are downloadable in CSV format and you can also download journal and book reports from JUSP via SUSHI machine-to-machine interaction. You can find more information about this in our Interoperability FAQs.

  • How do I ensure that all my HighWire data are visible in JUSP?

    Subscriptions on the HighWire platform can be associated with multiple accounts. Each of the publishers in HighWire assigns a unique account number to their subscribers, and provides that directly to them. However, HighWire offers the functionality to consolidate usage across the various publishers by associating all HighWire subscriptions with one account.

    We ask you to provide us with details of this HighWire account when you sign up for JUSP in order that we can gather your HighWire usage data. Please ensure that all your HighWire titles are associated with this account.

    When a new HighWire-hosted publisher joins JUSP, you will need to check that all the titles from that publisher are associated with this account. If they are not, please associate them, check to see that they are appearing in that account on the HighWire website and let us know via our helpdesk so that we can regather data for you if necessary.

    You can see a full list of HighWire publishers on our Participants page and further details on how to associate titles in HighWire can be found on its website.

  • Do you plan to include multimedia reports?

    We are carrying out investigative work into the feasibility of including MR1 reports in JUSP in late 2017 and early 2018.

  • Will there ever be a time when I can run a report for say, ProQuest or EBSCOhost, and it will give me a JR1 and BR2 for a particular full-text database?

    Usage for any publisher or aggregator is not supplied with clear division of packages, deals or products, we simply collect and process JR1, BR2 and other reports as supplied by the publisher and work with those. Data about which titles are included in a particular package or product are best explored by using KB+.

Using JUSP for book, database and platform reports

  • How do I view book, database and platform reports in JUSP?

    To view book, database and platform reports in JUSP login to the portal and then click on 'BOOKS AND OTHER' in the top right. The first time you visit you will need to register. If you see an error message, please follow the instructions to copy and paste relevant details into the body of an email to our helpdesk (help@jisc.ac.uk) and we'll get access to the portal sorted for you.

  • Why can't I see any data for the BR1 (or BR2)?

    The BR1 report is to be provided only when an entire book is provided as a single file; otherwise Book Report 2 must be used (COUNTER). Most publishers supply the BR2 and not the BR1 though some do provide both. The table on our Participants page will show which reports each publisher provides.

  • Where can I find out what e-book and database reports are available?

    You can view which reports publishers provide on our Participants page. You can see which months and report types have been gathered for your institution by viewing "Your data" on the home page of 'Books and Other' in the portal. Book reports are displayed in the top table and the database and platform reports in a separate table underneath.

  • Are you planning to add more book publishers?

    Yes! We are actively working with e-book publishers and aggregators; in many cases we have identified issues with their COUNTER reports which have been passed back to the publisher to fix. JUSP requires data to be supplied using the SUSHI protocol and some vendors do not currently offer this - until they do, we are unable to work with them. You can see the current situation for various publishers and aggregators not yet signed up to JUSP under "Current publisher issues" when logged into the BOOKS & OTHER section of the portal.

  • Can JUSP collect BR3 (access denied) reports more frequently, for example weekly instead of monthly?

    Although some vendors provide up-to-date usage and turnaways data directly from their administrator site, the SUSHI versions of the COUNTER reports are only available for complete months. We make data available when the publisher releases them, so this could be at any point during the following month.

  • What does "section request" mean?

    The meaning of section request varies between publishers. The COUNTER definition is "the first level of subdivision of a book or reference work." For example, this may be a chapter or an encyclopaedia entry.

  • How do I compare BR1 and BR2?

    The BR1 and BR2 are not directly comparable. For the SCONUL return, SCONUL suggests you apply a multiplier. If you have any other suggestions of ways to deal with this, please let us know and we can share it via our community page.

  • I access e-book content through aggregator services and they are able to supply usage reports. When will I be able to access this content in JUSP?

    There is significant interest from JUSP libraries in being able to access usage data from e-book aggregator services. Unfortunately some of these aggregator services do not currently support the SUSHI protocol. Members of the JUSP team and Jisc Collections have been in contact with the main aggregator services to discuss this, but we have no timescale for development.

    As JUSP relies on the COUNTER standard and machine based SUSHI services to provide a cost efficient and effective service it will be necessary for these vendors to offer SUSHI support before JUSP can harvest data. We encourage JUSP libraries to contact e-book aggregator vendors to lobby for conformance.

  • Can I mark-up e-book titles by purchase type?

    JUSP does not have this functionality but we recognise the demand for this and aim to explore this within the context of development of Jisc's library support services.

  • What is the difference between Result Clicks and Result Views?

    Our glossary gives definitions of these terms. If you would like further information about interpreting the numbers of clicks and views, we suggest the guide on the COUNTER website: https://www.projectcounter.org/quick-guideresult-clicks-record-views/

How JUSP processes usage data

  • How many years' worth of usage data do you hold and how often is this updated?

    When a new publisher or library joins JUSP we collect data back to January 2014 where available and then update on a monthly basis. We make data available when the publisher releases them, so this could be at any point during the month. JR1 data may also be available as far as 2009 for some libraries and publishers as we retain historical data.

  • Do you make any changes to the data?

    No. We take the data as provided in the publishers' SUSHI feeds and do not change or manipulate them unless the file fails one of our checking procedures and there's an obvious fix, for example a missing ISSN. The totals figures are never changed.

  • What checks do you carry out before you upload the data?

    We can't check every file for every publisher and institution by eye as this would leave no time to do anything else! But over 99.9% of the data are collected with no problems and it is only in a very tiny minority of cases that errors occur.

    Data go through several stages before they are accepted into the database.

    1. We carry out a visual check of the size and format of the publisher files to ensure it's a correct file. Files are almost always of a certain file size, so any that differ wildly are likely to be false downloads and in those cases we gather them again.
    2. We run a program over the files, which performs around a dozen sanity checks to ensure that the files are formatted correctly, that identifiers are present, that titles are not incomplete or missing, and that the XML structure in the file is correct.
    3. We generate a load file for each corresponding SUSHI file. Once loaded, we randomly pick a selection of institutions and check that the figures look correct.

  • What types of errors does JUSP find during these checks and how are they resolved?

    Although 99.9% of files work straight away, we do sometimes encounter problems both in the SUSHI data collection and in the file processing.

    Occasionally files may timeout on download, or only include partial data - this is why we perform a visual check of the file sizes. The checking can then throw up a wide range of errors, which can include: wrongly formatted or missing identifiers; problems with non-ASCII characters (we correct these); incorrect XML; carriage returns or other spacing errors in the files; titles appearing which aren't in the JUSP database (we then add them before reprocessing); missing total counts (very rare); all total counts being 0 (genuine in some cases, but in others obviously a mistake); and many more. When we find a recurring issue, we contact the publisher and this is usually fixed at source.

  • What happens to any errors that are not identified during these checks?

    One of the benefits of being part of the JUSP user community is that if our participants notice any data anomalies, we can investigate them, resolve them (with help from the publisher where necessary) and make any corrections to the data. This benefits not just the initial enquirer but also all JUSP libraries. We also sometimes receive notification from publishers of issues with their data, such as restatement of a particular month's data, and we can also resolve these to benefit all JUSP libraries.

    Let us know if you spot any potential data anomalies and we will investigate.

  • How does JUSP handle usage data from journals' databases or aggregated sets of publisher data such as Project Muse?

    We provide a JR1 report for Project Muse as a whole (as supplied) rather than breaking the usage down by any individual publishers that form part of that report.

  • How does JUSP handle usage data from JSTOR?

    We provide JR1 reports for JSTOR in the same way as for any other participating publisher.

    Where a title in JSTOR also has usage directly from the publisher or via a gateway / intermediary, the individual journal search and usage report and the title click-through functionality in many of the reports will enable you to see the total usage of a title, split into usage via publisher and gateways, and usage via JSTOR.

  • How does JUSP handle usage data from gateways and intermediaries such as EBSCOhost or IngentaConnect?

    In the case of journal reports we only extract the usage data from these gateways and host intermediaries for those publishers that have signed the JUSP participation agreement. The data are added to direct publisher usage in reports such as "JR1 reports including gateways and host intermediaries" and "Annual summary use of gateways and host intermediaries", as well as many summary-level reports.

    For book, database and platform reports usage data is only available in the system as full reports for the platform. For these you can view usage of all titles on these platforms, but you cannot view usage of a title across platforms.

    Please note that Ebsco EJS provided usage statistics up to July 2014; after that date usage of all titles accessed via Ebsco EJS comes directly from the publisher. SwetsWise ceased operations in late 2014 and usage data from them are available in JUSP up until November 2014.

  • What happens when a journal changes publisher?

    If the new publisher is a JUSP participant, we will collect data from that publisher as they start to appear in their JR1, JR1a, JR1 GOA, JR2 and JR5 reports. You may however also continue to see usage from the previous publisher if articles from earlier volumes from that publisher continue to be available to you. When you use the individual journal search and usage report and the title click-through functionality in many of the reports you will see usage details for all publishers of the selected journal title.

    If the new publisher is not a JUSP participant, feel free to suggest them as a new participant via the wishlist facility within the JUSP portal itself.


  • What is JUSP interoperable with?

    JUSP is currently interoperable with UStat, Alma Analytics, 360 Counter, Millennium, EBSCONET Usage Consolidation, LibInsight, LM LibNet, RedLink, Selection Support and SirsiDynix BLUEcloud eRM (CORAL).

    Further information about using the JUSP SUSHI server to gather usage data from JUSP and import it into other usage statistics products can be found on the SUSHI server administration / authorisation pages accessible from your JUSP portal welcome page. You will also find there a list of a list of the SUSHI parameters that you will need (CustomerReferenceID, CustomerReferenceName) for those publishers for which we hold your data in JUSP.

    A JUSP API is available to support wider projects and services such as KB+ and RAPTOR-JUse. Please contact our helpdesk if you would like more information about this.

  • How do I access JUSP data via UStat?

    Go to the SUSHI server administration/ authorisation pages via the link from your JUSP portal welcome page and check the "Authorize 3rd party access" for UStat box.

    See our video which demonstrates the stages required to set JUSP up in your UStat account. You will need to set up an entry in UStat for each publisher participating in JUSP.

  • How do I access JUSP data via Millennium?

    Go to the SUSHI server administration / authorisation pages via the link from your JUSP portal welcome page and enter Millennium's IP address in one of the IP boxes.

    Check the Innovative online customer support website (CSDirect) if you're an ERM customer and need help setting up SUSHI harvesting from JUSP.

    You will need to set up an entry in Millennium for each publisher participating in JUSP as shown here:

    1 > Access Provider         elsev
    2 > Customer ID             1
    3 > Consortium Affiliation
    4 > Day of Month            29
    5 > From (# of months back) 5
    6 > To (# of months back)   2
    7 > WSDL URL                http://jusp.jisc.ac.uk/sushiserver/?wsdl
    8 > Requestor ID            exe
    9 > SUSHI Release           1.6

    The JUSP server requires the correct version of SUSHI software to be added to the Millennium SUSHI configuration. If line 9 is blank, users will get an error message.

  • How do I access JUSP data via 360 Counter?

    Go to the SUSHI server administration/ authorisation pages via the link from your JUSP portal welcome page and check the "Authorize 3rd party access" for 360 COUNTER box.

  • How do I access JUSP data via EBSCONET Usage Consolidation?

    Go to the SUSHI server administration/ authorisation pages via the link from your JUSP portal welcome page and check the "Authorize 3rd party access" for EBSCONET Usage Consolidation box.

  • What should we do if our usage statistics products isn't listed?

    We have worked with a number of providers to develop interoperability with their products, and these products are listed above, and in the SUSHI server admin and authorisation section of the Portal. If the statistics tool you use is not listed, you can authorise access by entering their IP address in the box as described in the JUSP SUSHI Service User Guide.

    If you would like to see the product added as an authorised third party service, we will need to work with the vendor in order to set this up, so you will need to contact the vendor and ask them to approach us about working with them. You can also view a template email in the SUSHI server admin pages of the logged in Portals.

  • What is the JUSP SUSHI server?

    SUSHI is a PHP-based system that allows participating institutions and third parties such as UStat and Millennium to download usage data directly from JUSP. By downloading data this way, you can save time by interacting with a single SUSHI server as opposed to multiple publisher servers. And you can also be certain that the data has been rigorously checked as we quality check at the point of aggregation.

  • How do I access the SUSHI server?

    You'll need a SUSHI client that can send and receive SOAP messages conforming to the SUSHI 1.6 standard, and you'll also need to register for SUSHI access with JUSP and provide the Requestor ID, Customer Reference ID and other required information when you use your SUSHI client to make a SUSHI request. You can find further details about this and a user guide on the welcome screen that you see when you login to the JUSP portal.

  • What reports can I download via SUSHI and when?

    You can download all core reports (JR1, JR1a, JR1 GOA, JR2, JR5, BR1, BR2, BR3, DB1, DB2 and PR1) via SUSHI.

    Data from individual publishers are released at different times during the month. If you only intend to gather data using the JUSP SUSHI server once a month, we recommend doing this at the end of the month. If you want to gather data for an individual publisher, check your JUSP portal welcome page to ensure that the data you require are available in JUSP.

  • How does JUSP work with KB+

    JUSP works to share data with KB+ in 3 important ways. Firstly, almost all journal title lists in JUSP are taken from the KB+ public exports facility, enabling us to download quality assured and checked title lists rather than finding them from numerous sources on the Internet. Secondly we work with KB+ to supply them with headline journal usage figures for inclusion on the KB+ service. These are exported from JUSP into KB+ using our API. Finally we now have a shared core titles facility for journals, which is maintained at KB+ and imported / updated on JUSP regularly.

  • How often are core titles updated?

    Users maintain their own lists of core journal titles on the KB+ service alone (previously this was done in separate ways on both services, hence the need to rationalise). JUSP then imports the updated data regularly (usually weekly, but we can do this more frequently on request). When core titles are included in JUSP reports, they are denoted with a small yellow star next to the journal title in the relevant report.

Publisher participation

  • What is required for publisher usage data to appear in JUSP?

    For data to appear in JUSP, a publisher must meet the following criteria:

    • They have been requested to join by JUSP participating libraries
    • They supply at least one of the JR1, JR1a, JR1 GOA, JR2, JR5, BR1, BR2, BR3, DB1, DB2 and PR1 COUNTER-compliant usage statistics reports via the Standardized Usage Statistics Harvesting Initiative (SUSHI) protocol (http://www.niso.org/workrooms/sushi)
    • They return a signed Publisher Participation Agreement
  • What is the role of the JUSP team in getting a publisher to participate in JUSP?

    Jisc Collections, a JUSP consortium partner, contact publishers requested by libraries. They provide them with background information about JUSP, and respond to any questions or concerns they may have, and arrange meetings and demonstrations as required. The team also promote JUSP more generally in the publisher community through events to raise the profile of JUSP. Once the publisher has signed up to JUSP, we can also work with them to test their SUSHI service and COUNTER reports.

  • How can libraries help encourage publishers to join JUSP?

    A common response from publishers is that they aren't aware of demand from libraries for them to join, so it is important that publishers hear about JUSP from you as well. If you are meeting a publisher representative or contacting them about usage statistics, ask them whether they have heard of JUSP and if they will participate.

    We have written a template letter which you can access from the publisher wishlist section within the logged in Portal. If you are involved in a publisher library advisory group and that publisher is not a member of JUSP, please ask them to join.