Features

Identification

To access certain features of the DevRev SDK, user identification is required.

The identification function should be placed appropriately in your app after the user logs in. If you have the user information available at app launch, call the function after the DevRev.configure(appID) method.

You can select from the following methods to identify users within your application:

Anonymous identification

The anonymous identification method allows you to create an anonymous user with an optional user identifier, ensuring that no other data is stored or associated with the user.

1
DevRev.identifyAnonymousUser(successCallback, errorCallback)

Unverified identification

The unverified identification method identifies users with a unique identifier, but it does not verify their identity with the DevRev backend.

1
DevRev.identifyUnverifiedUser(identity, successCallback, errorCallback)

Verified identification

The verified identification method identifies users with a unique identifier and verifies their identity with the DevRev backend.

1
DevRev.identifyVerifiedUser(identity, successCallback, errorCallback)

Update the user

You can update the user’s information using the following method:

1
DevRev.updateUser(identity, successCallback, errorCallback)

Logout

You can log out the current user by using the following method:

1
DevRev.logout(deviceID, successCallback, errorCallback)

The user will be logged out by clearing their credentials, as well as unregistering the device from receiving push notifications, and stopping the session recording.

PLuG support chat

Once user identification is complete, you can start using the chat (conversations) dialog supported by our DevRev SDK. The support chat feature can be shown as a modal screen from the top-most screen.

To show the support chat screen in your app, you can use the following method:

1
DevRev.showSupport(successCallback, errorCallback)

Creating a new support conversation

You can initiate a new support conversation directly from your app. This method displays the support chat screen and simultaneously creates a new conversation.

1
DevRev.createSupportConversation(isAnimated, successCallback, errorCallback)

In-app link handling

The DevRev SDK provides a mechanism to handle links opened from within any screen that is part of the DevRev SDK.

You can fully customize the link handling behavior by setting the specialized in-app link handler. That way you can decide what should happen when a link is opened from within the app.

1
DevRev.setInAppLinkHandler(handler, successCallback, errorCallback)

You can further customize the behavior by setting the setShouldDismissModalsOnOpenLink boolean flag. This flag controls whether the DevRev SDK should dismiss the top-most modal screen when a link is opened.

1
DevRev.setShouldDismissModalsOnOpenLink(value, successCallback, errorCallback)

Analytics

The DevRev SDK allows you to send custom analytic events by using a properties map. You can track these events using the following function:

1
DevRev.trackEvent(name, properties, successCallback, errorCallback)

Session analytics

The DevRev SDK offers session analytics features to help you understand how users interact with your app.

Opting-in or out

Session analytics features are opted-in by default, enabling them from the start. However, you can opt-out using the following method:

1
DevRev.stopAllMonitoring(successCallback, errorCallback)

To opt back in, use the following method:

1
DevRev.resumeAllMonitoring(successCallback, errorCallback)

Session recording

You can enable session recording to capture user interactions with your app.

The session recording feature includes the following methods to control the recording:

Session properties

You can add custom properties to the session recording to help you understand the context of the session. The properties are defined as a map of string values.

1
DevRev.addSessionProperties(properties, successCallback, errorCallback)

To clear the session properties in scenarios such as user logout or when the session ends, use the following method:

1
DevRev.clearSessionProperties(successCallback, errorCallback)

Masking sensitive data

To protect sensitive data, the DevRev SDK provides an auto-masking feature that masks data before sending to the server. Input views such as text fields, text views, and web views are automatically masked.

While the auto-masking feature may be sufficient for most situations, you can manually mark additional views as sensitive using the following method:

1
DevRev.markSensitiveViews(tags, successCallback, errorCallback)

If any previously masked views need to be unmasked, you can use the following method:

1
DevRev.unmarkSensitiveViews(tags, successCallback, errorCallback)

Timers

The DevRev SDK offers a timer mechanism to measure the time spent on specific tasks, allowing you to track events such as response time, loading time, or any other duration-based metrics.

The mechanism utilizes balanced start and stop methods, both of which accept a timer name and an optional dictionary of properties.

To start a timer, use the following method:

1
DevRev.startTimer(name, properties, successCallback, errorCallback)

To stop a timer, use the following method:

1
DevRev.endTimer(name, properties, successCallback, errorCallback)

Screen tracking

The DevRev SDK offers automatic screen tracking to help you understand how users navigate through your app. Although view controllers are automatically tracked, you can manually track screens using the following method:

1
DevRev.trackScreenName(screenName, successCallback, errorCallback)

Push notifications

You can configure your app to receive push notifications from the DevRev SDK. The SDK is designed to handle push notifications and execute actions based on the notification’s content.

The DevRev backend sends push notifications to your app to alert users about new messages in the PLuG support chat.

Configuration

To receive push notifications, you need to configure your DevRev organization by following the instructions in the push notifications section.

Register for push notifications

The DevRev SDK offers a method to register your device for receiving push notifications. You can register for push notifications using the following method:

1
DevRev.registerDeviceToken(deviceToken, deviceID, successCallback, errorCallback)

On Android devices, the deviceToken should be the Firebase Cloud Messaging (FCM) token value, while on iOS devices, it should be the Apple Push Notification Service (APNS) token.

Unregister from push notifications

If your app no longer needs to receive push notifications, you can unregister the device.

Use the following method to unregister the device:

1
DevRev.unregisterDevice(deviceID, successCallback, errorCallback)

Processing push notifications

Android

On Android, notifications are implemented as data messages to offer flexibility. However, this means that automatic click processing isn’t available. To handle notification clicks, developers need to intercept the click event, extract the payload, and pass it to a designated method for processing. This custom approach enables tailored notification handling in Android applications.

To process the notification, use the following method:

1
DevRev.processPushNotification(payload, successCallback, errorCallback)

Here, the message object from the notification payload should be passed to this function.

For example:

1
const notificationPayload = {
2
	"message": {
3
		"title": "New Message",
4
		"body": "You have received a new message.",
5
		"data": {
6
			"messageId": "12345",
7
			"sender": "John Doe"
8
		}
9
	}
10
};
11
12
const messageJson = notificationPayload["message"];
13
14
DevRev.processPushNotification(messageJson, function() {
15
	console.log("Push notification processed successfully.");
16
}, function(error) {
17
	console.error("Failed to process push notification:", error);
18
});

iOS

On iOS devices, you must pass the received push notification payload to the DevRev SDK for processing. The SDK will then handle the notification and execute the necessary actions.

1
DevRev.processPushNotification(payload, successCallback, errorCallback)

For example:

1
const notificationPayload = {
2
	"message": {
3
		"title": "New Message",
4
		"body": "You have received a new message.",
5
		"data": {
6
			"messageId": "12345",
7
			"sender": "John Doe"
8
		}
9
	}
10
};
11
12
const messageJson = notificationPayload["message"];
13
14
DevRev.processPushNotification(messageJson, function() {
15
	console.log("Push notification processed successfully.");
16
}, function(error) {
17
	console.error("Failed to process push notification:", error);
18
});