In-app gamification, rewards, and engagement campaigns for React Native — unified API across iOS and Android.

All CustomerGlu SDKs share the same version number.
iOS 4.1.2 · Android 4.1.2 · React Native 4.1.2

• Requirements
• Installation
• Quick Start
• Banner Widgets
• Features
• What's New in 4.1.2
• Troubleshooting
• Native SDKs
• Documentation

npm install @customerglu/react-native-customerglu

yarn add @customerglu/react-native-customerglu

Install the native CocoaPods dependency:

cd ios && pod install && cd ..

The React Native SDK automatically pulls in the native iOS SDK (CustomerGlu 4.1.2) via CocoaPods.

The native Android SDK (com.customerglu:CustomerGluLibrary:4.1.2) is resolved automatically via Maven Central.

Ensure mavenCentral() is in your project-level build.gradle (or settings.gradle):

// build.gradle (project)
allprojects {
    repositories {
        mavenCentral()
    }
}

// OR settings.gradle (newer projects)
dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}

No additional Android configuration is required.

<key>CUSTOMERGLU_WRITE_KEY</key>
<string>YOUR_WRITE_KEY</string>

<meta-data
    android:name="CUSTOMERGLU_WRITE_KEY"
    android:value="YOUR_WRITE_KEY" />

You can find your write key in the CustomerGlu Dashboard under Settings → SDK Keys.

import { CustomerGlu } from '@customerglu/react-native-customerglu';

// Register user (call once after login / app launch)
await CustomerGlu.registerDevice('user-123');

// Open the rewards wallet
CustomerGlu.openWallet();

// Load all campaigns
CustomerGlu.loadAllCampaigns();

// Send a custom event
CustomerGlu.sendEventData({
  eventName: 'purchase',
  eventProperties: { amount: 99 },
});

// Update user attributes
CustomerGlu.updateProfile({ plan: 'premium' });

Embed native banner widgets in your React Native views using CGBannerWidget:

import { CGBannerWidget } from '@customerglu/react-native-customerglu';

function HomeScreen() {
  return (
    <CGBannerWidget
      bannerId="home_rewards_banner"
      style={{ width: '100%' }}
    />
  );
}

The SDK handles rendering, styling, native widget inflation, and click actions automatically based on your dashboard configuration. Banner height is managed dynamically — native widgets measure their content and resize the React Native container.

• DYNAMIC_MULTISTEP native rendering — three widget variants (MS1, MS2, MS3) rendered natively on both iOS and Android instead of WebView for better performance and native feel
• Auto-height bridge — native widgets broadcast measured height via CGBANNER_FINAL_HEIGHT to resize React Native containers dynamically
• iOS overflow support — clipsToBounds = NO on the bridge view enables MS3 expand/collapse animation overflow
• 19 configurable nativeStyle fields — colors, fonts, border radius, shimmer, and more — all controlled via dashboard

The React Native SDK wraps the native SDKs. For advanced customization or standalone native apps:

Full SDK docs, guides, and API reference:

https://docs.customerglu.com/sdk/mobile-sdks#react-native

MIT