Installation

To begin your integration journey, follow these guidelines to install the package and configure your native projects.

System requirements

Before installing the SDK, verify that your development environment meets the following minimum requirements:

React Native: Version 0.76 or higher (targets React Native's New Architecture)
iOS Deployment Target: iOS 15.1 or higher
Android API Level: Android 7.0 (API level 24) or higher

Install the package

Install the zetakit_reactnative package in your React Native project using your preferred package manager.

Using Yarn

yarn add zetakit_reactnative

Using npm

npm install zetakit_reactnative

Manual package.json entry

Add the dependency directly to your package.json:

{
  "dependencies": {
    "zetakit_reactnative": "^1.0.0"
  }
}

Then run yarn install or npm install to download the package.

Configure iOS native project

After installing the npm package, you must install the native CocoaPods dependencies.

Navigate to your project's ios directory and run pod install:

cd ios && pod install && cd ..

Notification Service Extension (Optional)

If you plan to use rich push notifications or delivery tracking on iOS, add the ZetaNotificationService pod to your Notification Service Extension target in your ios/Podfile:

target 'NotificationServiceExtension' do
  pod 'ZetaNotificationService'
end

Then run pod install again. For full setup instructions, see the Push Notifications guide.

Configure Android native project

Set the Minimum SDK Version

Open android/app/build.gradle and ensure your minSdkVersion is set to 24 or higher:

android {
    defaultConfig {
        minSdkVersion = 24
    }
}

Configure Firebase Messaging (Optional)

If your app uses push notifications, add Firebase to your Android project:

Follow the Firebase Android setup guide to register your app.
Place your google-services.json file in the android/app/ directory.

Add the Firebase Messaging dependency to your android/app/build.gradle file:

dependencies {
    implementation("com.google.firebase:firebase-messaging:24.1.0")
}

Android host-project configuration

Your React Native app's android/ project is a standard Android host project, so the native Android SDK's build requirements apply to it unchanged. Rather than repeat them here, follow the native guide for:

Toolchain requirements — compileSdk, Kotlin, Gradle, and AGP versions.
ProGuard / R8 — no custom rules are required; the SDK ships its own consumer rules.
Transitive dependencies — the libraries the native SDK pulls in and how Gradle resolves version conflicts.

See Android Installation for the full details.

Register your app in ZMP

To enable the SDK to communicate with the Zeta Marketing Platform (ZMP), you must register your application in the ZMP console. This registration process will generate the clientSiteId and clientSecret required for initialization.

Since React Native apps target both iOS and Android, you must register each platform separately:

iOS: Register using your app's Bundle ID (found in Xcode or app.json).
Android: Register using your app's Package Name (Application ID, found in android/app/build.gradle).

Follow the Mobile App Registration guide to complete registration for each platform.

The ZMP app registration screen, highlighting where to copy the clientSiteId and clientSecret used during initialization.

Important: SDK API tokens have write-only access, restricted to updating profiles, tracking events, and logging errors. Refresh tokens are scoped to mobile-specific APIs and cannot access broader platform functionality.

For a complete walkthrough of the portal registration with step-by-step screenshots, refer to the ZMP Mobile App Registration guide.

Next step

Now that the SDK is installed and native projects are configured, continue to the next step of your journey:

Getting Started — Initialize the SDK in your JavaScript/TypeScript code.

On this page