Documentation > Docs

Testing your App Integration

We’ve built a validator tool that you use to test CleverTap integration with your app. It works for both iOS and Android platforms.

Download the Validator

The universal SDK validator requires Java 1.6 or above to run

If your account data is to be hosted on the India Data centre explicitly, please contact your CleverTap Account Manager for additional details regarding integration

Run the Validator – Android

After downloading the universal SDK validator, run it on the command line as follows:

java -jar CleverTapSDKValidator*.jar -android /path/to/AndroidManifest.xml

If you’ve got a custom Application class, specify it’s path as well:

java -jar CleverTapSDKValidator*.jar -android /path/to/AndroidManifest.xml /path/to/Application.java

If everything is integrated properly, you should see something like the following:

[ OK ] Activity lifecycle registered
[ OK ] Required permission - READ_PHONE_STATE
[ OK ] Required permission - INTERNET
[ OK ] Optional, but recommended permission: ACCESS_NETWORK_STATE
[ OK ] Optional, but recommended permission: GET_ACCOUNTS
[ OK ] Optional, but recommended permission: ACCESS_COARSE_LOCATION
[ OK ] Optional, but recommended permission: WRITE_EXTERNAL_STORAGE
[ OK ] Account credentials
[ OK ] Install receiver (for tracking app installs)
[ OK ] GCM related permissions
[ OK ] GCM project number
[ OK ] Additional GCM related meta data
[ OK ] Built-in push support
[ OK ] In-app notification activity
[ OK ] Activities to exclude when displaying an in-app notification

CleverTap integration looks good! Cheers!

Run the Validator – iOS

After downloading the universal SDK validator, run it on the command line as follows:

java -jar CleverTapSDKValidator*.jar -ios /path/to/AppDelegate.m /path/to/your/Info.plist

If everything is integrated properly, you should see something like the following:

[ OK ] Account credentials
[ OK ] Support for tracking deep links
[ OK ] Support for receiving and tracking push messages

CleverTap integration looks good! Cheers!

Manual Integration Checklist

  • Verify that you’re seeing incoming events in the Dashboard.
  • Check whether you’re seeing the Stayed event being recorded. This system event gets recorded automatically when a user stays in your app for more than two minutes, or views two or more screens.
  • Check whether the App Launched event is being recorded in a user profile.
  • Open up a user profile and check out the user’s event history.
  • In the user profile page, click on the identified device tag icon to see whether the user’s push token shows up user-device-app-token-android

Testing Push Notifications

  • If you’re setting the Email, or any unique identifier for the user, look up the profile via Find People.
  • Alternatively, record some event from the app, and then view details for that event, then click on all the faces (should be few as test). In this one, the event can even be App Launched.
  • Open up your profile page, and click on bell icon as shown in the image below to send yourself a test notification.
    user-device-details