Skip to main content
Version: v5

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.

important
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.

warning
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.

MetricDescription
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 dataDisplays the number of active installs that sent location data at least once in the last week.
Installs with location permissionDisplays 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 versionDisplays 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.

MetricDescription
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.