Configure COUNTER 5 and COUNTER 5.1 vendors for reporting

Configure Vendor

1. On the left side of the screen, expand Usage Data.
2. Search for a specific vendor in the COUNTER Vendors box or leave the box blank and click Search.
3. From the search results screen, select the Available COUNTER Vendors tab.
4. Locate the desired vendor and select the Configure Vendor button.
5. Credentials: Enter your library's COUNTER API harvesting credentials to enable testing of the vendor connection. Fields vary by vendor.
   • Enter at least one of the Platform, API Key, Requestor ID or Customer ID.
   • If the vendor you are configuring does not use separate credentials for COUNTER 5 and 5.1,  fill out the credentials form and click Save. 
   • If a vendor requires separate credentials for COUNTER 5 and 5.1, click the checkbox beneath the COUNTER Type labeled, This vendor requires separate credentials for COUNTER 5.1, which will show another set of fields where you can enter the different sets of credentials for COUNTER 5.1.

      Note: The system will first check the vendor's COUNTER API URL for 5.1 reports, and if none are available, it will subsequently check for COUNTER 5 reports.  

6. Click Test to test the credentials. Correct any errors that may occur.

7. Click Save. 

Request a Vendor

Request the addition of COUNTER Vendor to License Manager.

1. On the left side of the screen, expand Usage Data.
2. Search for a specific vendor in the COUNTER Vendors box or leave the box blank and click Search.
3. From the search results screen, select the My Requested Vendors tab.
4. Click the Request a Vendor button.
5. Enter the required information on the Request a Vendor screen. Refer to the COUNTER Registry for recommended values and requirements for the fields below.
   • Vendor Name: Use the search box to enter the vendor you wish to add.  If you cannot find the vendor you wish to add, create a new vendor using the Vendors section on the left-hand navigation.  See Create a vendor for more information.
   • Knowledge Base Provider: Use the search box to enter the Knowledge Base Provider name and select from a drop-down list. Selecting a Knowledge Base Provider will autofill the Provider ID field.
   • Provider ID:  A unique identifier for the vendor. To retrieve the Provider ID, find the collection on a new or existing license.  The Provider ID is included in the Provider column in the Collections tab of a license.
     •  If the desired vendor does not appear in the Knowledge Base Provider drop-down and you do not know the Provider ID, enter a Provider ID of “unknown” when you submit the vendor request. 
   • Registry ID: Enter the Registry ID for the vendor from the COUNTER Registry. Once linked to a Registry ID, the vendor's COUNTER API URL will be updated automatically within License Manager.
   • COUNTER 5 API Server URL: Enter the URL of the COUNTER API for the requested vendor. This URL is different than the URL of the vendor's main webpage. 
     • Example URL: https://sushi5.scholarlyiq.com/counter/r5/reports
     • For the URL to function in License Manager, it must end in "/reports" even if the vendor does not publish the URL in this style.
   • Special Considerations: Optional. Select if your vendor requires IP ranges when enabling COUNTER API harvesting from OCLC. OCLC's IP addresses will appear so you can share them with the vendor.
   • COUNTER Type: Select the COUNTER type to setup for the vendor.
   • Report Type: Select at least one report type to enable for the vendor.
   • Credentials: Enter your library's COUNTER API harvesting credentials to enable testing of the vendor connection. Fields vary by vendor.
     • Enter at least one of the Platform, API Key, Requestor ID or Customer ID.
6. Click Test to test your credentials. Correct any errors that may occur.
7. Click Save to save the vendor even if errors occur.

Once you have requested a vendor, License Manager will test the connection based on the supplied credentials.  Requested vendors will appear with a Request Status on the My Requested Vendors tab.  Statuses include:

• Approved: The vendor's credentials have been verified and the vendor is approved.  The vendor is available under the Available COUNTER Vendors tab.
• Requested: If License Manager is unable to verify the vendor with the credentials provided, the vendor will be reviewed by the License Manager team.
• Declined: The vendor is not approved for COUNTER API harvesting. A reason the vendor has been declined will be provided.  Use the Actions drop-down to edit and resubmit the request.

You can configure an Alert to notify you when a vendor has been approved or declined.  Refer to Configure Alerts for more information.

Integration with the COUNTER Registry 

License Manager automatically updates vendor profiles by integrating with the COUNTER Registry providing more accurate vendor information with limited staff action. If a vendor changes their COUNTER API URL, License Manager will update it automatically.  You can continue to request new vendors when needed.