iOS SDK 15.6.7,
Android SDK 15.5.3,
Hello Screen Dynamic States,
Bluedot Cordova plugin 4.0.1,
Bluedot Xamarin Android wrapper 15.5.2,
Bluedot Xamarin iOS wrapper 15.6.6,
Bluedot React Native wrapper 2.3.0,
This documentation describes the steps required to integrate the Bluedot Point iOS SDK and MarketingCloudSDK in an iOS App.
This integration depends on both Salesforce MarketingCloudSDK and Point iOS SDK. These dependencies are managed by a cocoapod and will be installed after executing pod install
command. Salesforce MarketingCloudSDK v5.2.1 can be downloaded from https://github.com/salesforce-marketingcloud/MarketingCloudSDK-iOS/releases/tag/v5.2.1.
To integrate MarketingCloudSDK you need to add MarketingCloudSDKConfiguration.json
file to your project.
[{ "name": "production", "appid": "__your app id__", "accesstoken": "__your access token__", "marketing_cloud_server_url": "__your app endpoint__", "mid": "__your account mid__", "etanalytics": false, "pianalytics": false, "location": false, "inbox": false, "uselegacypiidentifier": true }]
And then add MarketingCloudSDKConfiguration.json to Copy Bundle Resources in your target’s Build Phases settings.
You can find more information here.
Requirements
To integrate PointSDK, please refer to the integration steps here.
To trigger Bluedot events in Salesforce Marketing Cloud, please ensure that the Contact Key is passed into Bluedot via the CustomKey
field with [BDLocationManager.instance setCustomEventMetaData]
:
@implementation ViewController - (void)viewDidLoad { [super viewDidLoad]; ... successful = [[MarketingCloudSDK sharedInstance] sfmc_configure:&error]; [[MarketingCloudSDK sharedInstance] sfmc_setContactKey:@"__your_contactKey__"]; [BDLocationManager.instance setCustomEventMetaData:@{@"ContactKey": [[MarketingCloudSDK sharedInstance] sfmc_contactKey]}]; BDLocationManager.instance.sessionDelegate = self; BDLocationManager.instance.locationDelegate = self; [BDLocationManager.instance authenticateWithApiKey:@"__your_ApiKey__" requestAuthorization:authorizedAlways]; }
The custom event metadata is not persisted across SDK sessions. If the SDK is logged out the custom event metadata is cleared by the SDK. We suggest setting the custom data every time the SDK is authenticated in the app.
More information on best practices of setting and using custom event metadata can be found here.
A sample project which demonstrates the integration of JB4A iOS SDK and Bluedot Point iOS SDK is available on GitHub.