Get started with the Connect SDK on iOS
The Connect SDK for iOS captures how users interact with your app — screen views, gestures, taps, behavior signals — and delivers the data to Acoustic Connect for analytics, session replay, and audience targeting. For Swift apps, the SDK also enables identity-aware reporting and mobile push notifications.
What you can build
- Behavioral analytics — screen views, gestures, taps, keyboard inputs, and form interactions captured automatically. Available in Swift and Objective-C apps.
- Behavior signals — log named signals at moments that matter to your business, like add-to-cart, search, or checkout. Supported through the
logSignalAPI. - Identity-aware reporting — match anonymous app sessions to known contacts in your Connect audience by firing identity signals at sign-in and registration. Swift only.
- Push notifications — reach users on their device even when the app is closed. Connect tracks delivery, taps, in-app sessions, and conversions automatically, surfacing results in the mobile channel dashboard — no extra integration code required. Supports thumbnail images, expandable content, and tappable actions authored by your marketing team. Swift only.
- Session replay — visual reconstruction of user sessions for UX analysis and support. Requires a Connect Ultimate subscription.
Swift integration path
The iOS 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.
- Integrate the Connect SDK into a native iOS app — see how users interact with your app: screen views, gestures, taps, and form interactions captured automatically and flowing into Connect.
- Add the features your app needs — identity, push, or both, in any order:
- Identify users at sign-in (iOS) — attribute sessions to known contacts and target re-engagement journeys.
- Identify users at registration (iOS) — create contact records and trigger onboarding journeys for new users.
- Enable push notifications in a native iOS app — reach users on their device with rich, actionable notifications.
- Move Connect SDK integration to production — get your integration App Store-ready: swap to the release build, declare the SDK in your privacy manifest, configure the kill switch (lets you remotely disable data collection on all devices without a new release), and mask PII in session replay.
Objective-C apps
The Connect SDK supports behavioral data collection and session replay in Objective-C apps. Identity signals and push notifications are Swift-only — the ConnectIdentity API is not available in Objective-C, and push delivery requires Swift APIs.
To integrate, see Integrate the Connect SDK into a native iOS app (Objective-C).
Try the sample app
The Acoustic Connect Mobile Push Sample App for iOS is a reference implementation of the integration patterns this documentation describes — the ConnectSDKManager helper and identity helpers. To see behavioral data flowing into Connect, replace the placeholder credentials with your own app key and collector URL. Push notifications require full Apple Developer setup and are better integrated directly in your own app — see Enable push notifications in a native iOS app.
