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.

Incognia dashboard - Previous

People and roles

Next - Incognia dashboard

API credentials

Last updated 5 days ago

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.

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.

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.