Troubleshooting

If you experience difficulties with the SDK, here are some tips and common errors you may find as well as ways to test the use of the SDK by your app. If you have further requests and issues, contact your Customer Success Manager.

FollowAnalytics Device Observer

The FollowAnalytics platform enables you to view your analytics and test your push notifications with the Device Observer. This feature is designed for helping your integration and your QA and it's highly recommended that you use it whenever you are testing your app with the SDK. You can find more on the Device Observer here.

How to test your setup

The SDK has a Validator that will ensure that everything is properly configured. When your app is running in isVerbose to false, a popup is shown at launch time with the details of what is properly configured, and what is not. This makes it easier for you to validate that the various steps were performed properly.

The validator is triggered when the configuration is setup with isVerbose configuration as true. It will display as an in-app message at each launch of the app.

Troubleshooting push notifications

Push notification checklist

Before you start testing for push notifications be sure to have setup all the requirements. Here is a short checklist you can go over:

  • Add the FCM Server key to the Administration page of your app on the platform
  • Implement the FCM library to your build.gradle
  • Add your Firebase messaging service class and implement onNewToken and onMessageReceived methods
  • Add FollowAnalytics methods setPushToken and processFirebaseMessage to your Firebase messaging class
  • Launch your app

You will now be able to receive push notifications.

FollowAnalytics enables you to send a test push notification from the Device Observer. Access the Device Observer by doing the following:

  1. Log on to the platform
  2. Go to Administration > Test Devices
  3. Select or register on your device

Now you are on the Device Observer page. From there you can click to button called "Send push notification". A standard push notification will be sent to the device you are observing. If the platform was unable to send the push notification, two errors could be displayed:

If the problem persists, contact your Customer Success Manager.

My data does not appear on the dashboard

When your app runs with isVerbose as true mode or in a simulator, the data is automatically sent as development logs. Development logs are not sent to the server and will not show on the FollowAnalytics Clients Platform.

Development logs can be checked using the method given in the FAQ section (see related entry in FAQ for more information on debug & release modes).

You can also use the device observer for checking your tags. Select your device, then use your app. You will see that the logs from your phone will appear live from the screen. From there you can see if the your tag is sent to the server.

Integrating in projects with other SDKs and compatibility

The FollowAnalytics SDK is regularly tested alongside most major SDKs on the market. We will keep you informed of compatibility issues we encounter. If you experience any issues of compatibility, please contact your customer success manager.

SDK size and impact on app performance

Crash reports

To see if the SDK, properly sends crash reports you can test this by simulating a crash of your app. To do this, create an empty array and try to access its item at index 0. This will crash your app. When reloading the app, you will see a Crash report sent to FollowAnalytics servers.

To verify that the crash configuration is working properly, launch your app without the debugger. i.e. manually on the device or from the simulator, without using the "run" button in Xcode.

You can then check if the Crash report is sent to the server by looking at the Device Observer.