Advanced Configuration

​

Log Levels

import { Zixflow, ZixflowLogLevel } from 'zixflow-reactnative';

const config = {
  apiKey: 'YOUR_API_KEY',
  logLevel: ZixflowLogLevel.Debug,  // Debug, Info, Error, None
};

Zixflow.initialize(config);

​

Auto-Tracking Options

import { Zixflow, ScreenView } from 'zixflow-reactnative';

const config = {
  apiKey: 'YOUR_API_KEY',
  autoTrackDeviceAttributes: true,
  trackApplicationLifecycleEvents: true,
  screenViewUse: ScreenView.All,
};

Zixflow.initialize(config);

• Lifecycle events: Lifecycle Events
• Screen tracking: Screen Tracking

​

Custom API Hosts

import { Zixflow } from 'zixflow-reactnative';

const config = {
  apiKey: 'YOUR_API_KEY',
  apiHost: 'https://custom-api.zixflow.com',
  cdnHost: 'https://custom-cdn.zixflow.com',
};

Zixflow.initialize(config);

​

Push click behavior (Android)

import { Zixflow, PushClickBehaviorAndroid } from 'zixflow-reactnative';

const config = {
  apiKey: 'YOUR_API_KEY',
  push: {
    android: {
      pushClickBehavior: PushClickBehaviorAndroid.ActivityPreventRestart,
    },
  },
};

Zixflow.initialize(config);

​

Troubleshooting

​

Basic steps

1. Confirm Requirements (React Native 0.60+, iOS 13+, Android API 21+).
2. Use the documented package version: zixflow-reactnative@^1.1.3.
3. Enable debug logging while reproducing the issue.
4. Follow the Quick Start order (install → platforms → initialize → identify → push).

​

Enable debug logging

import { Zixflow, ZixflowConfig, ZixflowLogLevel } from 'zixflow-reactnative';

const config: ZixflowConfig = {
  apiKey: 'YOUR_API_KEY',
  logLevel: ZixflowLogLevel.Debug,
};

await Zixflow.initialize(config);

Turn debug logging off in production (Error or None).

​

SDK not sending data

• Verify apiKey from Installation.
• Call Zixflow.initialize once, early in the root component.
• Call Zixflow.identify before expecting person-targeted campaigns.
• Check network / proxy (apiHost / cdnHost) if you override hosts.

​

iOS push not received

1. Push Notifications + Background Modes (Remote notifications) enabled in Xcode.
2. Host app Podfile includes zixflow-reactnative/apn or /fcm.
3. MessagingPushAPN / MessagingPushFCM initialized in AppDelegate (JS init alone is not enough on iOS).
4. User identified and permission granted.
5. Test on a physical device with valid APNs credentials in the Zixflow dashboard.

​

Android push not received

1. Client google-services.json under android/app/.
2. Google Services plugin applied; FCM credentials in the Zixflow dashboard.
3. POST_NOTIFICATIONS granted on Android 13+.
4. Package name matches the Firebase Android app.

​

Rich push / delivery metrics flaky on iOS

1. Notification Service Extension target present with zixflow-reactnative-richpush/*.
2. NSE deployment target matches the host app.
3. Configure App Groups so undelivered metrics can recover on next launch.
4. Image URL reachable over HTTPS.

​

Deep links

​

Multiple push libraries

​

Extension-related compile errors

pod install --repo-update --project-directory=ios

​

What to include when asking for help

• SDK version (1.1.3), RN / iOS / Android versions, device model
• Unfiltered debug logs covering init, identify, and the failing step
• For push: live campaign payload (not only a local test), app state (foreground / background / killed)