1. Go to your Podfile and add the Rudder-Moengage extension:

   Copy
   pod 'Rudder-Moengage'

2. After adding the dependency followed by pod install, you can add the imports to your AppDelegate.m file, as shown:

   Copy
   #import "RudderMoengageFactory.h"

3. Finally, change the initialization of your RudderClient, as shown:

   Copy
   RudderConfigBuilder *builder = [[RudderConfigBuilder alloc] init];
   [builder withDataPlaneUrl:DATA_PLANE_URL];
   [builder withFactory:[RudderMoengageFactory instance]];
   [RudderClient getInstance:WRITE_KEY config:[builder build]];

1. Install RudderMoEngage (available through CocoaPods) by adding the following line to your Podfile:

   Copy
   pod 'RudderMoEngage', '~> 1.0.0'

2. Run the pod install command.
3. Then, import the SDK depending on your preferred platform:

   Copy
   import RudderMoEngage

   Copy
   @import RudderMoEngage;

4. Next, add the imports to your AppDelegate file under the didFinishLaunchingWithOptions method, as shown:
   
   

   Copy
   let config: RSConfig = RSConfig(writeKey: WRITE_KEY)
               .dataPlaneURL(DATA_PLANE_URL)
   
   RSClient.sharedInstance().configure(with: config)
   RSClient.sharedInstance().addDestination(RudderMoEngageDestination())

   Copy
   RSConfig *config = [[RSConfig alloc] initWithWriteKey:WRITE_KEY];
   [config dataPlaneURL:DATA_PLANE_URL];
   
   [[RSClient sharedInstance] configureWith:config];
   [[RSClient sharedInstance] addDestination:[[RudderMoEngageDestination alloc] init]];

1. Open your app/build.gradle (Module: app) file and add the following:

   Copy
   repositories {
       mavenCentral()
   }

2. Add the following under the dependencies section:

   Copy
   // RudderStack Android and MoEngage SDKs
   implementation 'com.rudderstack.android.sdk:core:[1.0,2.0)'
   implementation 'com.rudderstack.android.integration:moengage:2.0.0'
   
   // For MoEngage core SDK initialisation
   implementation("com.moengage:moe-android-sdk:12.5.04")
   
   // Firebase messaging dependency
   implementation 'com.google.firebase:firebase-messaging:23.1.1'
   
   // If you don't have Gson included already
   implementation 'com.google.code.gson:gson:2.8.9'

3. Also, add the below plugin after buildscript:

   Copy
   // For Push Notification
   apply plugin: 'com.google.gms.google-services'

4. Open your build.gradle (Module: Project) file and add the following in the buildscript dependencies:

   Copy
   // For Push Notification
   buildscript {
       dependencies {
           classpath 'com.google.gms:google-services:4.3.14'
       }
   }

5. Initialize the RudderStack SDK in the Application class's onCreate() method, as shown:

   Copy
   // initializing Rudder SDK
   val rudderClient = RudderClient.getInstance(
       this,
       WRITE_KEY,
       RudderConfig.Builder()
           .withDataPlaneUrl(DATA_PLANE_URL)
           .withFactory(MoengageIntegrationFactory.FACTORY)
           .build()
   )

6. Initialize the MoEngage SDK in the Application class's onCreate() method:

   Copy
   // initializing MoEngage SDK and "XXXXXXXXXXX" is the APP ID from the dashboard.
   val moEngage = MoEngage.Builder(this, "XXXXXXXXXXX")
       .configureLogs(LogConfig(LogLevel.VERBOSE, false))
       .build()
   MoEngage.initialiseDefaultInstance(moEngage)

1. Add the RudderStack-MoEngage module to your app by running the following command:

   Copy
   npm install @rudderstack/rudder-integration-moengage-react-native
   // OR //
   yarn add @rudderstack/rudder-integration-moengage-react-native

2. Import the above module and add it to your SDK initialization, as shown:

   Copy
   import rudderClient from "@rudderstack/rudder-sdk-react-native"
   import moengage from "@rudderstack/rudder-integration-moengage-react-native"
   const config = {
     dataPlaneUrl: <DATA_PLANE_URL>,
     trackAppLifecycleEvents: true,
     withFactories: [moengage],
   }
   rudderClient.setup( <WRITE_KEY> , config)

3. Add the following under the dependencies section of the android/app/build.gradle (Module: app) file in the Android folder of your React Native project:

   Copy
   implementation 'com.rudderstack.android.sdk:core:1.+'
   implementation 'com.rudderstack.android.integration:moengage:1.0.0'
   implementation 'com.moengage:moe-android-sdk:10.5.00'
   
   //jet pack library required by moengage
   implementation 'androidx.core:core-ktx:1.3.2'
   implementation 'androidx.appcompat:appcompat:1.2.0'
   implementation 'androidx.lifecycle:lifecycle-process:2.2.0'
   
   //firebase messaging dependency
   implementation 'com.google.firebase:firebase-messaging:21.0.0'
   
   // if you don't have Gson included already
   implementation 'com.google.code.gson:gson:2.8.6'

4. In the android/build.gradle (Module: Project) file, add the following:

   Copy
   repositories {
     mavenCentral()
   }

5. Add the following in the buildscript dependencies in android/build.gradle (Module: Project) file:

   Copy
   // For Push Notification
   buildscript {
     dependencies {
       classpath 'com.google.gms:google-services:4.3.4'
     }
   }

6. Also, add the following plugin at the top of android/app/build.gradle (Module: app):

   Copy
   // For Push Notification
   apply plugin: 'com.google.gms.google-services'

7. Initialize the MoEngage SDK in the Application class' onCreate() method, as shown:

   Copy
   // MoEngage SDK initialisation: Replace "xxxxxxx" with your APP ID.
   MoEngage moEngage = new MoEngage
     .Builder(MainActivity.this.getApplication(), "xxxxxxx")
     .enableLogs(LogLevel.VERBOSE)
     .build();
   MoEngage.initialise(moEngage);

• Run the following command to implement the alias method in your iOS project:

  Copy
  [[RSClient sharedInstance]  alias:@"newId"];

1. To send push notifications in iOS an APNS certificate needs to be created and has to be converted to .pem file.
2. This .pem file needs to be uploaded in the MoEngage dashboard.
3. In the target app turn on App Groups and enable one of the App group ids, in case if you don't have an App Group ID then create one. The name of your app group should be group.{bundle id}.MoEngage.
4. Turn on Background mode and set/enable Remote Notification.
5. Turn on push notification capabilities in your app.
6. Before initializing add [MoEngage setAppGroupID:<your app group id>];
7. In case if you would like to keep the notifications even after the App Launch then : [MoEngage sharedInstance].disableBadgeReset = true;

In-App messaging

1. To send push notifications in iOS, an APNS certificate needs to be created and converted to a .pem file. This .pem file needs to be uploaded in the MoEngage dashboard.
2. Enable Background mode by navigating to Targets > Select Your App > Signing & Capabilities > Select Background Modes. Then, check Remote notifications.
3. Then, in your plist file, add the MoEngageAppDelegateProxyEnabled key and set it to false to disable swizzling.
4. Finally, implement the relevant methods in your AppDelegate file by referring to this section.
5. To keep the push notifications even after app launch, you can call the below method:

   Copy
   MoEngage.sharedInstance().setDisableBadgeReset(true)

   Copy
   [[MoEngage sharedInstance] setDisableBadgeReset:true];

For more information on implementing push notifications in MoEngage, refer to the MoEngage documentation.

Adding meta for push notification

Copy
val moEngage = MoEngage.Builder(this, "XXXXXXXX")
        .setNotificationSmallIcon(R.drawable.icon)
        .setNotificationLargeIcon(R.drawable.ic_launcher)
        .build()
MoEngage.initialise(moEngage)

1. Registration for Push, i.e. generating push token.
2. Receiving the Push payload from Firebase Cloud Messaging(FCM) service and showing the notification on the device. The above can either be handled by the application or MoEngage SDK. There is some configuration required based on whether the above-mentioned things are handled by the application or SDK.

Push Registration and Receiving handled by App

By default, MoEngage SDK attempts to register for push token, since your application is handling push you need to opt-out of SDK's token registration.

How to opt-out of MoEngage Registration?

To opt-out of MoEngage's token registration mechanism call in the optOutTokenRegistration() on the MoEngage.Builder as shown below

Copy
val moEngage = MoEngage.Builder(this, "XXXXXXXX")
        .setNotificationSmallIcon(R.drawable.icon)
        .setNotificationLargeIcon(R.drawable.ic_launcher)
        .configureFcm(FcmConfig(false))
        .build()
MoEngage.initialise(moEngage)

Pass the Push Token To MoEngage SDK

Copy
MoEFireBaseHelper.getInstance().passPushToken(applicationContext, token)

Passing the Push payload to the MoEngage SDK

Copy
if (MoEPushHelper.getInstance().isFromMoEngagePlatform(remoteMessage.data)) {
  MoEFireBaseHelper.getInstance().passPushPayload(
    applicationContext,
    remoteMessage.data
  )
} else {
  // your app's business logic to show notification
}

Push Registration and Receiving handled by SDK

Copy
<service android:name="com.moengage.firebase.MoEFireBaseMessagingService">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT" />
  </intent-filter>
</service>

In-App messaging:

1. Go to Web Push Settings.
2. Under Web fill in the details as required.
3. For HTTPS Web Push to work, you need to host two files in the root directory of your web server.
4. After clicking **SAVE**, proceed to download serviceworker.js file. Under Web Push Settings.
5. In case you already have your own serviceworker.js add :

   Copy
   importScripts(
     "https://cdn.moengage.com/webpush/releases/serviceworker_cdn.min.latest.js"
   )

6. HTTP : Select a sub-domain. For more details follow the guidelines from MoEngage.

1. Open the android folder of your React Native app and follow all the steps listed in the Android tab of the Configuring Push Notifications section.
2. Open the ios folder of your React Native app and follow all the steps listed in the iOS tab of the Configuring Push Notifications section.