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:
-
In your application's code, ensure the
debug
property is set totrue
, 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 yourplotconfig.json
file:{ "publicToken": "YOUR_TOKEN", "debug": true, "automaticallyAskLocationPermission": true, "enableOnFirstRun": true }
-
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.
-
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.
- Log in to the Plot Projects dashboard
-
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.
-
Give the campaign a name and a message. You can ignore the fields on the Advanced Settings screen.
-
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.
-
Select in the "Users should receive notifications" section the option "More than once" and save your campaign.
-
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:
-
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:
-
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.