User guide

Jumpstart your sees360 integration.

Quick start

Overview

Sees360 gives you a 360 insight into your customers behavior - where they spend, when they spend, which competitors do they use etc and dynamic advice on how to use this data.

Upon initializing the SDK in your app it will run and maintain it’s own background processes to collect and store information on the customers app usage across their device.

Permissions

The SDK will need permission to access the required data sets, these are as follows:

  • INTERNET - Install time permission
  • PACKAGE_USAGE_STATS - Required Special permission
  • ACCESS_COARSE_LOCATION - Optional runtime permission
  • ACCESS_FINE_LOCATION - Optional runtime permission

Accessing the UsageStatsManager requires a special level permission android.permission.PACKAGE_USAGE_STATS which will require a the customer installing the application to grant this via their device settings (this permission is not runtime grantable like location/camera etc). We recommend that developers integrating the SDK do so after this permission has been granted.

The INTERNET permission is an install time permission and the customer does not need to be prompted for access. Instead this will simply be displayed in the app store.

The location permissions are completely optional for the SDK. The SDK will check if it can access the fine location first, then coarse location. If no location information can be accessed then none shall be recorded.

Vocabulary

Throughout the course of the documentation you will come across certain terms we use in the sees360 domain. These are clarified here:

  • Unique Reference - This is a UUID that you provide for each customer probe installation at the startup of the SDK, we recommend that this UUID be referenced against a user on your own platform
  • Project - A project is your app that has initialised the sees360 SDK
  • Probe - A probe is an initialised SDK instance on a customers device communicating with the sees360 API
  • Export - An export is the data received from a probe stored in your defined bucket
  • Bucket - This is an AWS S3 bucket, at this time sees360 only supports exports for AWS S3 and S3 compatible storage backends
  • Stat - Stats are the rolling statistics of aggregated app usage recorded by a probe.
  • Event - Events are the ‘live’ record of an action on an app recorded by a probe, these are defined as ‘opened’ and ‘closed’