Skip to content

Configuring Client Usage and User Feedback

Configure the Mobile Client Usage and User Feedback feature to enable the application to upload client-specific usage data reports and feedback to the server; manage files that support crash dump processing; view user groups; and manage service keys.

The developer must include the Mobile Client Usage and User Feedback feature API in the application.

  1. In SAP mobile service cockpit, select Mobile Applications > Native/Hybrid.

  2. Select an application, then select Mobile Client Usage and User Feedback under Assigned Features (or add it first).

  3. Select Configuration to configure client usage and feedback.

  4. Under Client Usage Configuration, select Enable Client Usage to enable the application to collect the client's usage information. Note that user feedback can be uploaded whether Enable Client Usage is selected.

    Client Usage Settings

    Settings Description
    Upload Report After Enter the number of days after which the usage report may be uploaded to the server.
    Enable Hash User Name Select to hash user names with a hash algorithm, rather than store user names a plain text. This helps ensure user privacy. Toggle to disable.
    Enable Crash Logs Upload Select to enable the SDK to upload crash log files from the client back end for iOS and Android apps. See Managing Symbol Files (iOS) and Managing Mapping Files (Android) to manage upload, download, and removal of files.
  5. Under Client Usage Export Configuration, select Enable Client Usage Export Configuration to configure parameters for exporting client usage data to an endpoint. This enables you to use data in other ways, beyond the provided Client Usage and Client Feedback reports. See Downloading or Exporting Client Usage Data for details about downloading usage and user feedback charts, and exporting usage and feedback data in JSON format.

  6. Under Client Usage Report, choose the number of days to include in the client usage report download.

  7. Under Client Feedback Report, choose the number of days to include in the client feedback report download.

  8. Select Save if you made changes.

  9. Select Symbol Center to manage the symbol files that can be used to debug crashes, and search for missing dSYM files for iOS. See Managing Symbol Files (iOS).

  10. Select Mapping File to manage mapping files for debugging crash dumps for Android. See Managing Mapping Files (Android).

  11. Select User Group to view user groups that are configured for the space. To modify the groups, see Configuring Groups for Client Usage.

  12. Select Service Keys to see service keys configured for the application feature. See Service Keys.

  13. Select Info to see feature details, such as useful URLs, and to export usage and feedback data.

Configuring Groups for Client Usage

Configure user groups for client usage reporting. When configured you can get usage information at the user group level using SAP mobile service cockpit.

Groups must be configured via SAP Business Technology Platform cockpit at the space level. Groups are not available for the single-app cockpit in software as a services (SaaS) or platform as a service (PaaS) environments. Mobile Services is limited to five user groups for the space.

  1. In SAP mobile service cockpit, select Settings > Client Usage. Under User Group up to five user groups may appear.

  2. Select Edit to make changes.

    User Group Properties

    Properties Descriptions
    Group ID Up to five groups can be set at the space level. The names are set and cannot be changed, for example "Group 1" and "Group 5".
    Group Name You can modify the group name to make it more meaningful. Enter a valid name up to 256 characters long, without spaces. For example, "Organization", "Region", and "Department".
    (Optional) From SAML Attributes A SAML attribute such as "org", "office", and "dept". These values are from the SAML identity provider (IDP) configuration. Note that if you set a SAML attribute, the value of the SAML Token attribute binds to the value of the group ID.
  3. Select Save to save your changes.

Once configured, when you view User Data charts you can select the Filter icon to set filters for groups, and can select Show User Group Mapping to view configuration settings for groups. See Viewing User Data Charts for information.

You can also see user group configuration settings at the application level, but you cannot make changes. See Configuring Client Usage and User Feedback above for information.


Last update: May 20, 2021