This article describes how to determine user licences in the case of user-based billing.

How are the licences retrieved?

When a user calls up an application into which AppNavi has been integrated, AppNavi first carries out a user check. For this purpose, the variable appnavi_userid in the local storage is checked. If no user ID is available, AppNavi generates an ID and stores it in the local storage. At this moment, a licence of the user-based contract has been retrieved. If the user now uses the same application again from the same browser, the licence assignment is made and no new licence is provided. If the same user uses the application from another browser, a licence is retrieved again. The retrieved licences are reset on the first of each month.

Unique identification of users

The setguestuserid method can be used to uniquely identify users and their licences. For this purpose, a unique identifier of a user, such as the e-mail address or another user ID, must be read from the web application using JavaScript. This user characteristic is then transferred to the AppNavi API as a hash. In this way, it is possible to uniquely assign a user's licence across different end devices or browsers.

Calculation of the licences used

At the end of each month, a monthly statement is created for each AppNavi contract. This contains the number of user licences used on a monthly basis. At the end of each quarter, an average is calculated from the last 3 quarterly months. As this method of user determination offers a certain degree of imprecision, AppNavi grants a goodwill of 10%.