Mobile SDK Integration

Introduction

To take the full advantage of the Marketing Cloud, it is mandatory to integrate needed libraries/frameworks generally called as SDKs to your mobile app. At this moment, only iOS and Android mobile applications are supported by the SDK. This page contains steps on how to update your mobile app’s source and integrate the app with Bluedot Point SDK.

Integration Prerequisite

To start with integration we need to firstly gather the two necessities for integration of SDK. The most important one is to add the SDK framework to the app source code, that can be either achieved by copy-pasting the SDK artifacts files to project or adding in the artifacts via the online repository.  The second important element is the credentials needed to authorize or authenticate the SDK. These credentials are unique for each account or application.

For Bluedot Point SDK, both pre-requisite is available in the dashboard under Developers page. For each platform, there is a need to download its SDK along with its wrapper. A wrapper works as a bridge between the Bluedot Point SDK  and Journey Builder SDK. Copy the downloaded artifacts to the project. Bluedot Point SDK requires User Name, Package Name, and API Key as composite attributes for authenticating the SDK.

It is assumed that Journey Builder SDK is integrated into the project with required credentials. If this is not the case, then an extra step is required that involves integrating Journey Builder SDK to the project. Detailed documentation is available here for Android and iOS.

 

 

Add FCM ID obtained from Firebase account to Salesforce Mobile Push Administration Page for the App.

Please refer below screenshot for reference:

Integrating SDK to Android App

Bluedot Point SDK requests the BDSalesforceIntegrationWrapper that works as a bridge in communicating with the Journey Builder SDK. Using the combo of these three libraries the mobile app can take the advantage of the Marketing Cloud with the precision based and accurate Geofence and BLE beacons triggering. The SDK comes with the minimum requirements, which are needed to be satisfied for the SDK to start working, this means updating the AndroidManifest.xml file, that is the main configuration file of every Android project. The development tool or IDE (Integrated Development Environment) for the project is recommended to be Android Studio which can be downloaded from here. A detailed step by step guideline is available here.

 

Integrating SDK to iOS App

Bluedot Point SDK integration wrapper for Salesforce Marketing Cloud enables mobile apps to take advantage of the power of the Marketing Cloud and the superior accuracy, Geofence, Geolines™ and BLE Beacon triggering capabilities of the Bluedot SDKs. By integrating the simple Bluedot API, an application will benefit from accurate location awareness, while substantially reducing battery consumption compared to traditional location services methods. Applications powered by the Point SDK will be running both in the foreground and background. A detailed step by step guideline is available here.

Created by Bluedot DevOps on February 24, 2018

Start the discussion