Get started with the Connect SDK in a Cordova app
The Connect SDK for Cordova is a simplified version of the Connect SDK, focused on two things: sending mobile push notifications and identifying app users — creating new contacts in your audience, or recognizing existing ones using the app. One JavaScript API covers both iOS and Android, so your marketing team can author push content (thumbnail images, expandable rich content, and tappable actions) from Connect without any code changes on your side per campaign.
ImportantThe Connect Cordova SDK doesn't include behavioral analytics, automatic screen or touch capture, or session replay.
Language: JavaScript, with TypeScript definitions. The rich-media extensions on iOS are implemented in Swift.
Availability: Pro, Premium, and Ultimate
What the plugin does
| Capability | Description | Guide |
|---|---|---|
| Push notifications | Registers the device for push on both platforms — APNs on iOS, Firebase Cloud Messaging (FCM) on Android — and delivers Connect-authored notifications. | Push notifications in a Cordova app |
| Identity signals | Match anonymous sessions and push-eligible devices to known contacts in your Connect audience by firing a signal at sign-in or registration. | Identify users at sign-in and Identify users at registration |
Requirements
| Cordova CLI | 12.0.0 or later |
| Node.js | 20 or later |
| cordova-ios | 7.0.0 or later |
| iOS deployment target | 15.1 or later (plugin default; do not set lower — CocoaPods rejects it) |
| Xcode / CocoaPods | Xcode 15 or later, with CocoaPods installed |
| cordova-android | 13.0.0 or later |
Android minSdk | 26 |
| Android build tooling | Android Studio with SDK 34+, JDK 17, and a standalone gradle binary on PATH (recent Android Studio versions no longer bundle one) |
See Integrate the Connect SDK into a Cordova app for the full requirements.
Integration path
- Integrate the Connect SDK into a Cordova app — install the plugin, create
ConnectConfig.json, and callenable(). - Identify your users at sign-in and at registration.
- Enable push notifications — iOS and Android setups are independent and can be done in either order.
- Move your Cordova integration to production when you're ready to release.
Reference
See the Connect Cordova SDK public API reference for the full method list — enable, disable, setLogLevel, logIdentity, and the push namespace.
Sample app
The Acoustic Connect Cordova sample app exercises identity signals and push permission requests on both platforms.
Updated 10 days ago
