Mobile - Apps

The Mobile Apps section in Project Settings allows you to integrate your Android and iOS applications with Zoho PageSense. By connecting your mobile app with PageSense, you can track user interactions, capture in-app events, and send push notifications to engage users.

To begin tracking metrics from your mobile application, you must first add your app and integrate the PageSense SDK into your mobile project. Once the SDK is implemented, PageSense can start collecting user activity data from within the app.

Note: The Settings icon is located in the top-right corner of your PageSense interface. From there, navigate to Mobile → Apps to add and manage your mobile applications.

After adding your app, you can configure the following options:

SDK – Integrate the PageSense SDK to start tracking app activity.

User Information – Send user attributes such as email, name, or phone number to PageSense.

Events – Track specific user actions within the app.

Push Notifications – Enable notifications to communicate with mobile users.

SDK

The SDK (Software Development Kit) is required to connect your mobile application with Zoho PageSense. Once integrated, the SDK enables PageSense to collect user interaction data from your mobile application.

PageSense provides SDK support for both Android and iOS platforms.

Android SDK

To start tracking metrics for your Android application, integrate the Zoho PageSense Android SDK into your project.

Step 1: Add the Maven repository

Add the following repository in the root build.gradle file of your Android project.


allprojects {
  repositories {
    maven {
      url 'https://maven.zohodl.com'
    }
  }
}

Step 2: Add the SDK dependency

Add the PageSense dependency in the app-level build.gradle file.


dependencies {
  implementation 'com.zoho.pagesense:pagesense:1.1.2'
}

Step 3: Initialize the SDK

Initialize the PageSense SDK inside the onCreate method of your Application class.

public class CustomApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
PageSense.init(this, "6cxww7rh:20d7168ea0a542869590c71fdf5a6721:2:US");
}
}

Once initialized, PageSense will start tracking activity within your Android application.

iOS SDK

To track metrics for your iOS application, integrate the Zoho PageSense iOS SDK into your project.

Step 1: Add the SDK

You can add the SDK using either of the following methods:

Direct Integration

Download the SDK and add the ZohoPageSenseSDK.xcframework file into your project.

Using CocoaPods

Add the following line to your Podfile:


pod 'PageSenseSDK'

Step 2: Configure PageSense credentials

Add your PageSense credentials in the Info.plist file.

Open the Info.plist file in your project.
Create a new key named ZPS_APP_ID.
Set the key type to String.
Enter the App ID from your PageSense account.

After completing these steps, PageSense will begin tracking user activity in your iOS application.

User Information

The User Information option allows you to send user-specific details from your mobile application to PageSense. This helps identify users and analyze engagement patterns more effectively.

Examples of user details include:

Email Address
Name
Phone number

Android

For Android applications, you can send user information using the following API format:


UserInfo userInfo = PageSense.getUserInfoInstance();
userInfo.setEmail(<emailId>);
userInfo.setFirstname(<first_name>);
userInfo.setPhone(<phone>);
PageSense.addUserInfo();

iOS

For iOS applications, use the following API format:

let userPropertiesDictionary = ["firstname":"firstname","lastname":"lastname","email":"email"]
PageSense.trackUser(userProfile : userPropertiesDictionary)

Providing user information helps you better understand how individual users interact with your mobile application.

Events

The Events feature allows you to track specific actions performed by users inside your mobile application. Events help measure engagement and monitor how users interact with different features of your app.

Examples of events include:

Purchases
Downloads
App installs or uninstalls
Button clicks
Feature interactions

Android

For Android applications, events can be tracked using the following API format:


PageSense.addEvent(
  String <EVENT_NAME>,
  HashMap<String, Object> <EVENT_CUSTOM_ATTRIBUTE>
);

iOS

PageSense.trackEvent(eventName: "eventName")


PageSense.trackEvent(eventName : "eventName", withProperties : ["eventProperty" : "value"])

Tracking events helps you understand how users engage with different parts of your application.

Push Notifications

The Push Notifications option allows you to send notifications directly to users who have installed your mobile application. These notifications help you communicate updates, alerts, or promotional messages and encourage users to return to your app.

Android Push Notifications

To enable push notifications for Android applications, authentication must be configured using Firebase Cloud Messaging (FCM).

Provide the following details:

Service Account JSON file
Firebase Project ID

After configuring these details, PageSense can deliver push notifications to Android devices.

iOS Push Notifications

To enable push notifications for iOS applications, authentication must be configured using Apple Push Notification Service (APNS).