React Native SDK

image-20260724-090701.png


The full technical documentation lives here: React Native SDK Overview

This page is just a high-level overview to be used as a starting point; then follow through to the Developer Guide for integration details, APIs, and platform-specific setup.

The Zeta React Native SDK (zetakit_reactnative) brings the Zeta Marketing Platform (ZMP) to your React Native app through a single JavaScript package that bridges the native iOS and Android SDKs.

This documentation covers React Native SDK 1.0.0 (pinned to iOS SDK 1.0.0 and Android SDK 1.0.1). Requirements: React Native 0.76+ (New Architecture), iOS 15.1+, Android API 24+.

What the React Native SDK provides

  • Unified JS API — One package for configuration, user identity, events, in-app messaging, push token forwarding, and app inbox.

  • Native bridges — Wraps ZetaCore / ZetaNotificationService (iOS) and net.zetaglobal.app:core (Android) via React Native native modules.

  • Identity & events — Identify users, update contacts and properties, track location, and send auto-tracked and custom events from JavaScript.

  • Messaging channels — Push (APNs + FCM via native setup), in-app messaging, and a persistent app inbox your UI can query and display.


Use the following articles for the canonical, up-to-date React Native documentation. They are grouped in the order of a typical integration journey.

Set up and initialize

Topic

What you’ll find

Developer Guide

Overview

What the React Native SDK connects to, requirements, native SDK compatibility, and the full integration journey.

React Native SDK Overview

Installation

Install via npm/yarn, configure iOS CocoaPods and Android Gradle/FCM, and register both platforms in ZMP.

Installation

Getting started

Initialize from JavaScript (or optionally natively), configure ZTConfig, and manage opt-in / opt-out.

Getting started

Integrate core features

Topic

What you’ll find

Developer Guide

Contact management

Identify users, update email/phone contacts and custom properties, UCLID, advertising IDs, location, and event tracking.

Contact management

Add messaging channels

Topic

What you’ll find

Developer Guide

Push notifications

Forward device tokens from JS, native iOS/Android push setup, rich media, click tracking, and deep linking.

Push notifications

In-app messaging

Foreground SDK-rendered messages, lifecycle delegates via the bridge, and in-app email collection.

In-app messaging

App inbox

Fetch and query inbox messages, status updates, CTA handling, and building your own inbox UI (since 1.0.0).

App inbox

Prepare for release

Topic

What you’ll find

Developer Guide

API reference

Full JavaScript/TypeScript surface: ZetaClient, accessors, ZTConfig, enums, events, and model types.

API reference

Changelog

API-level Added / Changed / Deprecated / Removed notes for each release.

Changelog

Data & privacy

Opt-in/out, GDPR/CCPA notes, iOS and Android privacy references, and secrets handling.

Data & privacy

Versioning & support

SemVer policy, React Native / native SDK compatibility matrix, release cadence, and support channels.

Versioning & support

Advanced topics

Logging (ZTLogger), bridge-specific push troubleshooting, and testing & QA checklists.

Advanced topics