The Production Usage extended service

The Production Usage extended service lets you use AppPulse Mobile to obtain mobile analytics and extend your testing from the lab to real users.

Configure Mobile Center to work with AppPulse Mobile (for administrator)

  1. In the Mobile Center console Administration >Settings screen. Expand the section of the settings for the AppPulse Integration, and click Yes to enable it. For details, see Administration Settings.
  2. Make sure that you have a valid AppPulse Mobile account. If you do not, sign up for a free trial.
  3. Enable your account to work with the AppPulse Mobile Open API. The Open API enables you to collect data from AppPulse Mobile and use it for your specific needs. For example, using the Open API you can create customized reports, integrate with other external systems, and perform custom data analysis. For details, see Getting Started with the AppPulse Mobile Open API.

    Note: The Open API option is only available if you have a Premium or Mobile Center license. For assistance, go to the Support section in the Contact us page, and click CreateTicket.

  4. Within AppPulse Mobile, select Settings > Open API. If you don't see this option you probably do not have the required license. For assistance, go to the Support your license products section in the Contact page, and click CreateTicket.

    1. Click Generate Client Secret.
    2. Save the Client ID, Client Secret, and tenant ID.
  5. In the Mobile Center console, go to the Administration > Settings screen. Scroll down to the AppPulse section.
    1. Enter values for the following properties using the values generated in the previous step: 
      • Client ID
      • Client secret
      • Tenant ID
    2. If connecting to AppPulse Mobile via a proxy server, enter proxy details in the Proxy section.
  6. Restart the Mobile Center server.

Tip: You must click Save in each section to which you made changes, to make your selections effective.

Back to top

View AppPulse Mobile analytics

AppPulse Mobile lets you determine how your users experience your app, identifying the problems that affect the most common or critical functionality.

  1. Set up your app for monitoring with AppPulse Mobile. For details, see AppPulse Mobile Getting Started Guide. The app monitored by AppPulse can be the previous version of AUT, as long as it has the same app identifier.
  2. In the Mobile Center console, select the APPS menu. Use the Add button to upload your app to Mobile Center.
  3. Open the Production Usage (AppPulse) start page as described in Extended services. In this step, enter the Client ID, Client Secret, and tenant ID that you generated earlier.
  4. A Fundex score, generated for each app and device, is displayed in the top right corner of the monitoring window. The score is a rating based on your app's performance in a predefined list of criteria, such as the number of crashes and errors, resource usage, and so forth. The higher the score, the better the performance. For details, see AppPulse Mobile.

  5. Click the View more details in AppPulse Mobile link to drill down into your AppPulse tenant and view additional information about crashes, performance, and resource consumption data. If you are not logged in to your AppPulse Mobile account, you may be prompted to do so.

  6. Filter the view to limit the results to a specific time interval. Click the interval drop-down (by default Last day) and select the desired interval.
  7. Sort the devices by any of the column headings, such as Device (name), OS version, Response time, Crash rate, and User popularity percentage. Once you have sorted the devices, select the ones whose popularity coverage you want to see. When you select multiple devices, the summary banner below the list indicates the number of the selected devices and their popularity percent. You can export this data to an Excel file using the Export list button.

Back to top

Troubleshoot AppPulse Mobile

A gray face icon above the Fundex score indicates there is a problem retrieving data from AppPulse Mobile. This may occur due to one of the following problems:

  • Non-existing app. The app or the specific version does not exist. Check that the app exists in AppPulse Mobile.
  • No data. No data is available yet for the app.
  • AppPulse Mobile integration error. If the error message indicates an error with AppPulse Mobile or Mobile Center, check that the AppPulse settings in ADMINISTRATION > SETTINGS have valid values. If any of these properties are empty, integration with AppPulse Mobile will fail and the AppPulse Mobile icons will not appear in Mobile Center.

The following table lists some of the common error codes:

Message code Message Error
400 issueOnConfig

The AppPulse Mobile configuration parameters are incorrect or missing. Have your administrator check the AppPulse settings in the Administration > Setting screen.

401 Authentication

The AppPulse Mobile integration account information is incorrect. Check your credentials or contact your administrator.

500 systemError A system error occurred with the AppPulse Mobile integration. Refer to the guidelines above or contact your administrator.
500 proxyHostUnavailable Cannot connect to the AppPulse Mobile server.

Have your administrator check the Proxy settings in the Administration > Setting screen.

500 proxyUnauthorized Cannot connect to AppPulse Mobile server.

Have your administrator check the Proxy settings in the Administration > Setting screen.

500 connectionTimeout

Mobile Center encountered a timeout error. Wait a few minutes and try to connect again.

For further information, view the error log on the Mobile Center server for hints about the issues you are encountering.

  • Linux: opt/mc/server/log/integration.log
  • Windows: server\log\integration.log

The server cache is updated every nine hours with new data from AppPulse Mobile. The cache data is saved separately per app.

Note: Mapping between Mobile Center and AppPulse Mobile is according to the app package name and not according to the app version. If you upload a new version of an app to Mobile Center, the Fundex data relates to all versions of the app. To get Fundex information for a new version, you must add the app to AppPulse Mobile again.

Back to top

See also: