Receiving of notifications test

After completing the basic integration of the Plot Projects SDK you need to test it. You verify whether the Plot plugin is integrated properly by receiving a location based notification. When you have receive a notification, you know the basic integration is successful.

How to test the basic integration of the Plot Projects iOS SDK in your app:

  1. In your application's code, ensure the debug property is set to true, as it allows the plugin to show what is happening. The following code snippet shows an example of how to do that. All you need to add the second line to your plotconfig.json file:

    {
      "publicToken": "YOUR_TOKEN",
      "debug": true,
      "automaticallyAskLocationPermission": true,
      "enableOnFirstRun": true
    }
    

  2. If you don't have a Sandbox environment yet, you can create one by clicking on your app name in the Dashboard. Then click "Manage apps and Plans" and create a new app by clicking the Green Plus icon on the bottom right. Select app

  3. Install your app on your phone. If it is already installed, then remove the app and reinstall it, so you can start from a clean slate.

  4. Log in to the Plot Projects dashboard
  5. When in your Sandbox app, go to the Notification Campaigns screen by clicking on the corresponding menu item. At the bottom right, you can create a new Notification Campaign. Empty campaign list

  6. Give the campaign a name and a message. You can ignore the fields on the Advanced Settings screen. Advanced settings

  7. Select the action "Open app". If you don't have a geofence yet at your location, you can create one now on this screen. Place the geofence at the location where you're currently are. The geofence radius should be kept at 200 meters.
    Create geofence

  8. Select in the "Users should receive notifications" section the option "More than once" and save your campaign. Resendability settings

  9. Note that you will NOT receive this notification on your device immediately. The Plot Projects SDK only connects to our backend periodically (every 2 hours or when the device has moved significantly) to update its cached campaigns. This isn't influenced by whether the app has been opened or closed in this period. Therefore, when a new notification has been added it may take a while before that notification is downloaded and may be received by you. If you don't want to wait this long you have a couple of options:

    1. You can trigger a backend call by clearing the local database of your app on your phone. To clear the local database you have to open the Apps section under settings on your phone/emulator and find your app. There you can stop the app and clear local data under storage section. When the app is then opened again it will directly start downloading the notifications and, when you are at the right location of course, show the notifications. The following screenshots illustrate how to achieve that: SettingsSettings for app Storage settingsClear data

    2. You can set up the Plot Projects feature Quicksync, allowing you to instantly send new campaigns to all your app users (see our Quicksync integration guide).

Note

If you didn't receive your test notification after a couple minutes you can use this checklist.

Note

When a notification has been received, it won't be sent again until you leave the geofence. Cleaning the local database will make it possible to receive a notification again. This can make testing easier.