Retain and engage mobile users
Connect with customers using BoardActive's proprietary location-based marketing platform.
Installation
BoardActive for iOS supports iOS 10+. Building with Xcode 9 is required, which adds support for iPhone X and iOS 11.
SDK
Currently, the SDK is available via CocoaPods or downloading the repository and manually linking the SDK's source code to your project.
CocoaPods
Add the BoardActive pod into your Podfile and run pod install
.
platform :ios, '10.0'
target :YourTargetName do
pod 'BoardActive'
end
Update Info.plist
When installing BoardActive, you'll need to make sure that you have the following entries in your Info.plist
: Privacy - Location Always and When In Use Usage Description
, Privacy - Location Always Usage Description
, and Privacy - Location When In Use Usage Description
.
Additionally, you'll have to add three items to Required background modes
: App downloads content in response to push notifications
, App downloads content from the network
, and App registers for location updates
.
The same can be accomplished by selecting the project's primary target, selecting the Capabilities
settings, and, under Background Modes
, ensuring Location updates
, Background fetch
, and Remote notifications
are all checked.
How to Use This SDK
Permissions
Core locations
and UserNotifications
permissions need be requested before the hosting app's AppDelegate
's application(_:willFinishLaunchingWithOptions:)
.
Instantiate BAKit
// 1
import BAKit
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication, willFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey : Any]? = nil) -> Bool {
// 2
BoardActive.client.setupEnvironment(appID: "", appKey: "")
// 3
BoardActive.client.requestNotifications()
return true
}
}
Import the SDK.
Set SDK's
appID
andappKey
and configure the associated Firebase project.Declare BoardActive as the
UNUserNotificationCenterDelegate
andMessagingDelegate
. Requests user push notification authorization via theUNUserNotificationCenter
and registers for remote notifications. Additionally, trigger the calling ofBoardActive.client.requestLocations()
thereby requesting appropriateCoreLocation
permissions and starting location updates.
Example app
There is an example app provided here for Swift.
Setup and Configuration
Visit the BoardActive Github to view our open source code
Customer Support
Please contact us at BoardActive with any questions you may have, or email us at info@boardactive.com. We're only a click away!