The RudderStack Android SDK allows the following from your Android applications and sends it to CleverTap via RudderStack:

• Push User Profiles
• Push Events
• Integrate Push Notifications

Prerequisites

The following are the prerequisites for performing this integration:

• A CleverTap account
• A RudderStack account
• A functional React Native app

Integration

For CleverTap RudderStack Android integration, the following are the major steps:

1. Set Up Source and Destination at RudderStack.
2. Configure CleverTap within the application.
3. Install SDK in the Native application.
4. Initialize the RudderStack Client.

Set Up Source and Destination at RudderStack

To set up the source and destination at RudderStack:

1. Navigate to Connect > Sources from the RudderStack dashboard.
2. Click New source to add a new source and then select React native from the list of sources.

3. Enter the source name under Name this source field to identify it within your workspace and click Continue. The Write Key for this source displays, as shown in the following figure:

4. Click Add Destination and select the following options from the dropdown as per your requirement:
   • Use Existing Destination: Select from the list of available destinations.
   • Create new Destination: Create a new destination for your source.
5. Select CleverTap from the destination list and click Continue.
6. Enter the destination name under Name the destination field to identify it in your workspace and click Continue. The Connection Settings page displays.
7. Enter the following CleverTap details:
   • Account ID: A unique ID generated for your account. It is available under Settings > Project as the Project ID.
   • Passcode: A unique code generated for your account. It is available under Settings > Project as the Passcode.
   • Token: A unique code generated for your account. It is available under Settings > Project as Token.
   • Region: Server Only. This is the region assigned to your CleverTap account. Refer to the following table to identify it:

8. Select the Enable tracking for anonymous user option to track anonymous users in CleverTap.
9. Select the Use Clevertap ObjectId for Mapping option under React Native SDK settings section.
   This option enables both CleverTap objectId and identity to map events from RudderStack to CleverTap.
10. Click Continue. The Transformation settings page displays.
11. Select No transformation needed if you do not want to customize JavaScript code functions to implement specific use cases on your event data.

12. Click Continue. The connection is now established between source and destination. You can check if the connection is enabled under Connect > Connections.

Install SDK in React Native Application

We recommend installing the React Native SDK through npm. To add the SDK as a dependency, perform the following steps:

1. Navigate to the root of your application and add @rudderstack/rudder-sdk-react-native to your application as a dependency with:

npm install @rudderstack/rudder-sdk-react-native --save

Or

yarn add @rudderstack/rudder-sdk-react-native

2. Add the RudderStack-CleverTap module to your app using the following code:

npm install @rudderstack/rudder-integration-clevertap-react-native

Or

yarn add @rudderstack/rudder-integration-clevertap-react-native

3. Navigate to your Android/App folder and add the following dependency to your app/build.gradle file:

implementation 'com.clevertap.android:clevertap-android-sdk:4.4.0'
implementation 'com.google.android.gms:play-services-base:17.4.0'
implementation 'com.android.installreferrer:installreferrer:2.1'
implementation 'com.google.firebase:firebase-messaging:20.2.4'
implementation project(':clevertap-react-native')
implementation 'com.github.bumptech.glide:glide:4.11.0' //Mandatory for App Inbox
implementation 'androidx.recyclerview:recyclerview:1.1.0' //Mandatory for App Inbox
implementation 'androidx.viewpager:viewpager:1.0.0' //Mandatory for App Inbox
implementation 'com.google.android.material:material:1.3.0' //Mandatory for App Inbox
implementation 'androidx.appcompat:appcompat:1.2.0' //Mandatory for App Inbox
implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.0.0"
implementation 'androidx.core:core:1.3.0'
implementation 'androidx.fragment:fragment:1.1.0' // InApp
implementation 'com.google.android.exoplayer:exoplayer:2.11.5' //Optional for Audio/Video
implementation 'com.google.android.exoplayer:exoplayer-hls:2.11.5' //Optional for Audio/Video
implementation 'com.google.android.exoplayer:exoplayer-ui:2.11.5' //Optional for Audio/Video
implementation 'com.android.support:multidex:1.0.3'

4. Open the iOS folder from your terminal and install all the pod files with the following command:

pod install

Initialize RudderStack Client

To initialize the RudderStack client:

1. Import the module you added above as shown below:

import rudderClient from '@rudderstack/rudder-sdk-react-native';
import clevertap from "@rudderstack/rudder-integration-clevertap-react-native";
const CleverTap = require('clevertap-react-native');

2. Initialize the CleverTap-RudderStack SDK as follows:

const config = {
  dataPlaneUrl : "YOUR_DATA_PLANE_URL", 
  logLevel: 3,
  trackAppLifecycleEvents: true,
  recordScreenViews:true,
  withFactories: [clevertap]
};
rudderClient.setup("YOUR_WRITE_KEY", config);

• trackAppLifecycleEvents: This method allows the Rudderstack SDK to capture the Lifecycle events.
• logLevel → This method allows you to go through the application log when developing the application.

Push User Profiles

You can call the rudderClient.identify() method for pushing user profiles whenever you want to identify the user in your application, that is, when a user logs in or registers to your application or when you want to update any user information. After installing an app on a device, your user is assigned an "anonymous" profile. The first time when the application identifies the user on the device, the "anonymous" history on the device is associated with the newly identified user. You can call this method as follows:

RudderTraits traits = new RudderTraits();
                traits.putBirthday(new Date());
                traits.putEmail("[email protected]");
                traits.putFirstName("First");
                traits.putLastName("Last");
                traits.putGender("m");
                traits.putPhone("5555555555");
                traits.put("boolean", Boolean.TRUE);
                traits.put("integer", 50);
                traits.put("float", 120.4f);
                traits.put("long", 1234L);
                traits.put("string", "hello");
                traits.put("date", new Date(System.currentTimeMillis()));

                rudderClient.identify("test_user_id1", traits, null);

Replace userID with the unique identifier for your application. This identifier must match the identifier selected on the CleverTap dashboard. For more information, refer to RudderStack Identify.

Push Events

You can call rudderClient.track() for pushing events whenever you want to capture any user action in your application. For example, when a user adds any product, and you want to capture this event, then call this method and pass the following parameters:

• Event: For example, Product Added
• Event Properties: product id or any other property that you want to pass

For more information, refer to Rudderstack Track.

🚧

Event Property Data Types

• The value of a property can be of type Integer, Long, Double, Float, Character, String, a Boolean.
• The Date value must always be passed as $D_EPOCH value only.

Calling a push method may vary based on the type of event as follows:

• All events except the Order Completed event:

rudderClient.track(
                    "Product Added",
                    new RudderProperty()
                    .putValue("product_id", "product_001")
                );

• Order Completed (equivalent to the Charged event in CleverTap)

rudderClient.track("Order Completed", {
      checkout_id: "12345",
      order_id: "1234",
      affiliation: "Apple Store",
      'Payment mode': "Credit Card",
      total: 20,
      revenue: 15.0,
      shipping: 22,
      tax: 1,
      discount: 1.5,
      coupon: "Games",
      currency: "USD",
      products: [
        {
          product_id: "123",
          sku: "G-32",
          name: "Monopoly",
          price: 14,
          quantity: 1,
          category: "Games",
          url: "https://www.website.com/product/path",
          image_url: "https://www.website.com/product/path.jpg",
        },
        {
          product_id: "345",
          sku: "F-32",
          name: "UNO",
          price: 3.45,
          quantity: 2,
          category: "Games",
        },
        {
          product_id: "125",
          sku: "S-32",
          name: "Ludo",
          price: 14,
          quantity: 7,
          category: "Games",
          brand: "Ludo King"
        },
      ],
    });

For more information, see RudderStack Order Completed.

Integrate Push Notification in Android

The following are the three major steps to integrating push notifications into Android:

1. Add Dependency.
2. Set Up Notification Channel Id.
3. Custom handle Android Notification.

Add Dependency

To add a dependency:

1. Get the google-services.json file from the Firebase Cloud Messaging (FCM) console and place it into your project under the android/app folder. To get the google-service.json file, follow the steps listed under Setup Firebase Console..
2. In your root-level (project-level) Gradle file (build.gradle), add rules to include the Google Services Gradle plugin.
3. Ensure that you have Google's Maven repository, as well.

buildscript {

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
  }

  dependencies {
    // ...

    // Add the following line:
    classpath 'com.google.gms:google-services:4.3.5'  // Google Services plugin
  }
}

allprojects {
  // ...

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
    // ...
  }
}

4. Navigate to your Android/App folder and add the following dependency to your app/build.gradle file:

dependencies {
implementation 'com.google.firebase:firebase-messaging:20.2.4'
}
apply plugin: "com.google.gms.google-services"

5. Add the following service in your AndroidManifest.xml file :

<service
    android:name="com.clevertap.android.sdk.pushnotification.fcm.FcmMessageListenerService"
android:exported="true">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT"/>
    </intent-filter>
</service>

6. Navigate to Settings > Channels > Mobile Push > Android from the CleverTap dashboard.
7. Set up the FCM credentials.

Set Up Notification Channel Id

Android has modified the way push notifications can be sent to an app in its Oreo version and above. Starting with CleverTap SDK 3.1.7, we support Android Oreo's latest features, such as Notification Channels and Notification Badges. To create a Notification Channel Id, use the following code:

CleverTap.createNotificationChannel("CleverTapChannelId","CleverTap","This is a test channel",5,true);

The following table provides an explanation for the parameter values used in the above code:

For more information, refer to Push Notifications for Android O.

Custom Handle Android Notification

The following are steps for custom handling your Android notifications:

1. Add the following code within the MyFcmMessageListenerService.Java file if you choose to use your custom FCMMessageListenerService as MyFcmMessageListenerService:

package com.clevertaprudderstack; //Replace this with your Package Name

import com.google.firebase.messaging.RemoteMessage;
import com.clevertap.android.sdk.CleverTapAPI;
import android.os.Bundle; 
import android.util.Log;
import java.util.Map;
import com.clevertap.android.sdk.pushnotification.NotificationInfo;

public class MyFcmMessageListenerService extends FirebaseMessagingService {

    @Override
    public void onMessageReceived(RemoteMessage message){
        try {
            if (message.getData().size() > 0) {
                Bundle extras = new Bundle();
                for (Map.Entry<String, String> entry : message.getData().entrySet()) {
                    extras.putString(entry.getKey(), entry.getValue());
                }

                NotificationInfo info = CleverTapAPI.getNotificationInfo(extras);

                if (info.fromCleverTap) {
                    CleverTapAPI.createNotification(getApplicationContext(), extras);
                } else {
                    // not from CleverTap handle yourself or pass to another provider
                }
            }
        } catch (Throwable t) {
           Log.d("MYFCMLIST", "Error parsing FCM message", t);
        }
    }
}

2. Add the following code to your Android manifest file:

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

3. Additionally, add the code to push the FCM token to CleverTap:

String fcmRegId = FirebaseInstanceId.getInstance().getToken();
clevertapDefaultInstance.pushFcmRegistrationId(fcmRegId,true);

For more information, refer to Handling custom push notifications in Android.

Advanced Features

Debugging

1. To view CleverTap debug logs, you need Android Studio.
2. Enable debug logs by adding the following line of code in your app's build:
   CleverTapAPI.setDebugLevel(CleverTapAPI.LogLevel.DEBUG);
3. After running the application, navigate to _Android Studio > Logcat and search by _CleverTap*. The printed logs display all information associated with CleverTap. You can use this log to identify your CleverTap ID, check the events and user information that are getting pushed to CleverTap, etc.

The following is a sample screenshot of the Logcat in your Android Studio:

For more information, refer to Debugging in Android.