Skip to main content

Celonis Product Documentation

Prerequisites for the Platform Adoption Monitor app

You’ll need administrator permissions in your Celonis team to complete these prerequisites and install the Platform Adoption Monitor app. If you need to get help with any of the app’s prerequisites or setup steps, Contacting Support tells you how,Contacting Support

For the app to collect statistics, enable the login history and Studio tracking service in your Celonis team. Here’s how:

  • Login history: To check if the login history is already enabled, from the Celonis navigation menu, select Admin & Settings > Login History, and check that you can see the login history. If you can’t, enable the login history. We suggest you set the log retention to 2 years. If you’ve only just activated the login history, it might take a few days or weeks for all statistics to become visible in the app.

  • Studio tracking service: To check if the Studio tracking service is already enabled, from the Celonis navigation menu, select Admin & Settings > Platform adoption, and check that you can see the Studio tab on the platform adoption dashboard in addition to the Login History tab. If the Studio tab is present, click Tracking service and make sure it’s enabled.

To enable the app to access the Celonis Platform Adoption API and extract usage data for your Celonis team, create an OAuth 2.0 client. Here’s how:

  1. From the Celonis navigation menu, select Admin & Settings .

  2. Select Applications from the navigation panel.

  3. Click Add new application and select OAuth Client.

  4. Type a name for the OAuth client in the Name field - we suggest celonis-platform-adoption.

  5. Leave the Grant type field as “Client Credentials”, and for Authentication Methods, select “Client secret basic”.

  6. Click Define Scopes, and select these scopes:

    • platform-adoption.tracking-events:read

    • team.login-history:read

    • team.user-group-info:read

  7. Click Create. Save the client ID and secret - you can only view them once. You’ll need to copy these into the Celonis Platform Adoption data connection during app installation.

  8. Go to Admin & Settings > Permissions. Find the Team box, and click Edit on it.

  9. Search for the celonis-platform-adoption application (the name you gave to your OAuth client).

  10. In the row for the application, check the boxes to assign these permissions to the application:

    • USE LOGIN HISTORY API

    • USE STUDIO ADOPTION API

    • USE USER GROUP INFO API

  11. Click Save to activate the OAuth client’s permissions.

For the full instructions to register and manage OAuth clients, see Registering your OAuth client in Celonis Platform.