Get started with the Connect SDK on Android

The Connect SDK for Android captures how users interact with your app — screen views, gestures, taps, and exceptions — and delivers the data to Acoustic Connect for analytics, session replay, and audience targeting. It also enables identity-aware reporting and mobile push notifications.

What's included in your plan

CapabilityProPremiumUltimate
Behavioral analytics
Push notifications
Identity signals
Session replay
PII masking in session replay

What the SDK captures

Automatically

The SDK captures the following data without any additional code changes.

User interactions

  • Screen views — every activity and fragment transition, with logical page names for session replay navigation
  • Gestures — taps, double taps, tap and hold, swipes (horizontal and vertical), and pinch gestures; unresponsive gestures are highlighted in session replay
  • Form interactions — field focus, text changes, and form submissions
  • Navigation drawer open and close events
  • Dialog appearances and dismissals

Device and session context

At the start of each session, the SDK automatically records device characteristics (model, manufacturer, OS version, screen dimensions, pixel density), app metadata (name, version), locale, language, and orientation. During the session it tracks changes in network connectivity, battery level, and orientation.

Exceptions

  • Uncaught exceptions (crashes) — stack trace and device state at the time of the crash, captured automatically
  • Caught exceptions — captured when you call Connect.logException()

With additional setup

CapabilityDescriptionGuide
Push notificationsSend targeted messages to your app users via Firebase Cloud Messaging (FCM) or Huawei Mobile Services (HMS). The SDK auto-detects the available provider on the device.Firebase or Huawei
Identity signalsMatch anonymous app visitors to known contacts in your Connect audience. Send an identity signal after sign-in or registration to enable targeted push campaigns and cross-channel attribution.Sign-in and Registration
Custom eventsLog any in-app event that isn't captured automatically — for example, a specific button tap or a business-significant action.Event and data logging
WebView captureCapture user interactions inside embedded Google WebViews for a complete session replay that covers both native and web content.Improve session replay

Performance impact

The SDK is designed to minimize its footprint on users' devices:

  • Memory — approximately 2–3% additional memory consumption (based on benchmark testing; actual impact varies by device and app).
  • Battery — minimal effect on battery life.
  • Offline resilience — if the Connect collector is unreachable, the SDK stores captured data in memory (up to 400 KB per file, with up to 5 files cached). The oldest data is discarded if the cache grows beyond this limit. Data is sent automatically when connectivity is restored.

Requirements

LanguagesKotlin and Java
UI architecturesView-based (XML) and Jetpack Compose
Android versionsAndroid 8.0 (API level 26) to Android 16 (API level 36)
CPU architecturesAll standard Android ABIs — the SDK is pure Kotlin/Java with no native binaries
Development environmentAndroid Studio Otter | 2025.2.1 Patch 1 or later

Integration path

The Android integration is split into focused steps. Start with SDK integration, then add the features your app needs — identity and push are independent and can be adopted in either order.

  1. Integrate the SDK into your app: View-based or Jetpack Compose
  2. Identify users at sign-in and at registration
  3. Enable push notifications: Firebase or Huawei
  4. Move your integration to production

Sample apps

Two reference implementations are available: