CONNECTBOX

How to implement SDK

Push notifications should not be overwhelming to setup. This guide helps you to integrate ConnectBox with your system and to send your very first effortless push-notification. We’ll also lead you through setting up unique customisation for your pushes such as tagging, creating templates, setting up custom data (user’s name, personal info, etc.)...

In this guide, you'll learn how to:

  • Integrate ConnectBox with your application
  • Set up push notifications
  • Make and send your first push
  • How push notification analytics work
  • Create actions with tags

If you have any further questions that are not addressed in this guide, you can send an e-mail to info@connectbox.co

Now, let’s get started.

The Basics

ConnectBox is a push notification system for IOS and Anroid devices. Firstly, you need to create a profile in order for you to set-up push notifications from ConnectBox panel. You don’t need anything extra to connect to your panel; all you need is a browser. Form this very panel, you will also be able to view analytics for your push notifications.

You can use ConnectBox free up to 1 million notifications on a monthly basis. If your application exceeds this limit, you can always upgrade your account from the "Profile" menu. Also from "Profile", you can always edit your personal information, change your password and phone information.

Adding New Applications

To add and create customisation for your push notification, you can simply follow the steps below;

  • Choose Applications from the list on the left menu from your dashboard.
  • On applications page, choose Add New App.
  • Fill in the needed information on the form.
  • Choose the platforms that your application operates on.
  • If your application runs on IOS, chose either “Add Certificate” or “Add Development Certificate” according to your application’s status.
  • If your application runs on Android, “Android Package Name” and “GCM API Key” is needed.
  • Then create your application.

Installing Connectbox API

All you need to do is downloading the SDK, to integrate Connectbox with your system.

Go to Support from the menu on the left. Choose Downloads and download the SDK form binary.

Add ConnectBox SDK to your application bundle

Open up your AppDelegate.m and add the following to it:

#import "ConnectBox.h"

Inside the didFinishLaunchingWithOptions function, add the following code to initialize the SDK, you can find your application key in your dashboard.

[ConnectBox startAppWithKey:@"APPLICATION_KEY" withLocationSupport:YES];

This will initialize SDK with your application key

Add code below to track application installations & devices

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    // Save the deviceToken to ConnectBox
    [ConnectBox addDeviceWithToken:deviceToken];
}

Add code below to track your notifications

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo{
    // track your notifications
    [ConnectBox handlePush:userInfo];
}
 
 
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    // track your notifications
    [ConnectBox handlePush:userInfo];
}

Customising Your Push-notifications

If you want to track your users' behaviours or need more depth analyze of your application, you may use tags with our SDK.

[ConnectBox addTag:@"First_Time"];

You can remove any tag added before as well

[ConnectBox removeTag:@"First_Time"];

Your first effortless push notification is now ready to be sent!

Users

You can create users related to your device installations

#import "ConnectBoxUser.h"
NSMutableDictionary *userParams = [[NSMutableDictionary alloc] init];
[userParams setObject:@"1" forKey:@"userId"];
[userParams setObject:@"JohnDoe" forKey:@"userName"];
[userParams setObject:@"johndoe@email.com" forKey:@"userEmail"];
// you can add as many parameter as you want, these are hold inside the a"userData" key
[userParams setObject:@"custom" forKey:@"userData"];
[ConnectCloud addUserData:params];

Using Analytics & Tracking Activities

From Dashboard you can view your push notification activities. You can view total downloads, number of active and disabled push notifications, sessions per month and total sessions from the the beginning of time on dashboard.

  • From applications menu select the application to view activities.
  • You can view number o active and deactivate devices with session statics on hand.

For further information on installation please view documentations under Support.