QuickSync - How to get started

Our QuickSync feature is an improved way to synchronise your app users' devices with our server. Our default synchronisation lets a device poll for new notifications or geofence every once in awhile. This means that after create a notification it can take some time until you receive the notification when testing.

With Quicksync, this issue is resolved because after creating a notification it will be synchronized with all your users devices immediately.

On iOS Quicksync is very reliable when your app is in the foreground. Due to platform limitations of iOS 11.2 and up, Quicksync sometimes works less reliable when your app is in the background. Further information can be found at Some Notifications received, but not All.

We will keep track of new iOS releases and inform you in case Apple fixes this limitation.

When the app is in foreground the Quick Sync still works as expected.

Guide for Plot version 1.15.4 and newer:¶

Add QuickSync to receive your notifications immediately. Starting from 1.15.4 it uses Firebase Messaging. This guide assumes you’ve integrated Plot using Cocoapods. Make sure you already have integrated Plot using the iOS integration guide.

Step 1: Add the Firebase pod to your Podfile.¶

pod 'Firebase/Messaging', '4.5.0'

Step 2: Add `didReceiveRemoteNotification` method¶

Copy the following snippet into your AppDelegate:

-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    [Plot didReceiveRemoteNotification:userInfo fetchCompletionHandler:completionHandler];
}

Note

When you use other Firebase functionality in your code, you have to call [FIRApp configure] before calling [Plot initialize…]

Setting up Firebase:¶

Step1: Setup a Firebase Project¶

Follow the steps at the Firebase Console to setup your project and make sure you enable cloud messaging for your project.

Step 2: Add Config File¶

To obtain the GoogleService-Info.plist config file, add your iOS app to Firebase by clicking on the "Add Firebase to your iOS app" and following the instructions.

Add Firebase to your iOS app

In case your Firebase project already has the iOS app, go to the General tab in the Project Settings page and retrieve the config file, as shown in the image below.

Retrieve the config file

Once the GoogleService-Info.plist config is downloaded, add it to your project root.

Step 3: Almost Done!¶

After performing the steps above, in order to get the server key, click the settings button, highlighted in red, followed by Project Settings.

Server key new Firebase interface

Then look up the server key found in the Cloud Messaging tab of the Settings page, as presented below.