Applications

A mobile app is represented by an Application within Incognia. Every application has a unique Application ID, which is used to initialize the SDK and to identify the mobile app when using the Incognia solutions.

Creating an application

To create a new Application, go to the Applications page and select a platform on the Add App card. The Android and iOS platforms are currently supported.

It is necessary to create a different Incognia application for each platform in which your mobile app is present.

Integrating the SDK

After creating an Application, an SDK configuration file containing the Application ID can be downloaded and you can proceed to the SDK setup.

The SDK setup can be done via the Setup Wizard available on the Incognia dashboard or by following this documentation. The SDK Setup Wizard is a step-by-step guide and includes a live integration test to ensure that the SDK is correctly integrated.

App metrics

After the SDK is integrated, metrics will start being generated and are accessible through the Application page.

Currently, the app metrics are not updated in real-time and can take up to a day to be available.

Some available metrics are the number of active installs, number of active installs with location data, percentage of the active installs with background location permissions, and the distribution of the SDK version over the user base.

Metric

Description

Active Installs

Displays the number of active installs with the SDK over the last week.

An active install is an installation of the app in which the SDK has generated data at least once. Reinstalls on the same device also increase this metric.

Installs with location data

Displays the number of active installs that sent location data at least once in the last week.

Installs with location permission

Displays the percentage of active installs that allowed access to the device’s location over the last week. On Android, this metric uses the ACCESS_FINE_LOCATION and ACCESS_BACKGROUND_LOCATION permissions. On iOS, this metric checks the Always location permission.

SDK version

Displays the distribution of the SDK version on the active installs over the last 7 days.

If your mobile app is using the SDK-only trial integration for Enterprise customers, metrics such as the number of signup events, number of login events, and number of payment events are also available.

Metric

Description

Signups received

Displays the number of signup events received by Incognia over the last week.

Signup events are sent by calling the trackSignup method on the SDK with the SDK-only trial integration.

Logins received

Displays the number of login events received by Incognia over the last week.

Login events are sent by calling the trackLogin method on the SDK with the SDK-only trial integration.

Payments received

Displays the number of payment events received by Incognia over the last week.

Payment events are sent by calling the trackTransaction method on the SDK with the SDK-only trial integration.

Device diagnostic

A device diagnostic feature is also available to shed light on integration issues and to check that device data is being correctly sent.

To do the device diagnosis, press Device diagnosis on the Application page.

The latest Installation IDs should be listed. The lack of data might indicate that the SDK integration is not working properly (e.g., network requests might be failing).

The lack of data might indicate that the SDK integration is not working properly.

Select an ID and press Check. Information about the location permission, device sensors, whether the device is real or emulated and the SDK version should be displayed.

Item

Description

Location permissions

Shows whether the runtime location permissions were given at the moment of the last event sent by this installation.

On Android, this diagnostic checks the ACCESS_FINE_LOCATION and ACCESS_BACKGROUND_LOCATION permissions. On iOS, this metric checks the Always location permission

Sensors

Shows whether the Wi-Fi and GPS sensors were enabled at the moment of the last event sent by this installation.

Regular device

Shows whether this is a real device or a simulator/emulator/rooted device.

SDK version

Shows the SDK version of the last event sent by this installation.