Applications & SDK setup

Register an application

Requires app:manage.

1. Go to Settings → SDK Configuration Generator and click Register SDK.

2. Platform — choose Android (other platforms are coming soon) and click Continue.

3. App Info

   • App Name (required)
   • Application / Bundle ID — your applicationId, e.g. com.acme.shop. Each package id can be registered only once.
   • Description (optional)
   • App is Live — turn on for published apps and enter the Store URL and optionally the Current Version.

   Click Generate Keys.

4. License — copy the License Key, SDK API Key and Application ID. Tick I have saved my license key, SDK API key, and application ID and click Done.

Caution

The SDK API Key is displayed only once. If you lose it, download the config file again (next section) — it contains all three values.

Download cimka_config.json

Under Settings → SDK Configuration Generator → Your Apps, select the app. A preview of the config is shown. Click Download Config and place the file at:

app/src/main/assets/cimka_config.json

For live apps you can also update the Store URL here.

Choose what to collect

Requires app:manage to save.

Open Operations → App Config, pick an app and set:

Toggle	Collects
SDK Enabled	Master switch — off disables the SDK entirely, without an app update
Click Tracking	Taps and UI interactions
Screen Views	Screen enter/exit navigation
Crash Reports	Uncaught exceptions and stack traces
Network Requests	HTTP request/response logging
Trace Logs	Manual Cimka.trace.log() calls
Lifecycle Events	Activity / Fragment / Compose lifecycle
Session Tracking	Session start/end and heartbeats
Device Audit	Root / emulator / tamper detection
Dependency Scan	Third-party library inventory

Click Save. Devices apply the change the next time the app comes to the foreground, or within 2 minutes.