iOS Integration

Table of Contents

• Getting started
  • Integrate your project with Bluedot Point SDK
  • Integrate your project with Braze SDK
• Interaction between Braze SDK and Bluedot Point SDK
  • Start Braze SDK Services
  • Setup Bluedot Location Services

Getting started

This documentation depends on BluedotPointSDK and Braze SDK. Both dependencies can be managed by CocoaPods or Swift Package Manager.

Integrate your project with Bluedot Point SDK

You can find detailed instructions here

1. Import Bluedot Point SDK to your class: import BDPointSDK

2. Implement Bluedot BDPGeoTriggeringEventDelegate:

   extension YourClass: BDPGeoTriggeringEventDelegate {
   
       func didEnterZone(_ triggerEvent: GeoTriggerEvent) {
           // Your logic when the device enters a Bluedot Zone
       }
   
        func didExitZone(_ triggerEvent: GeoTriggerEvent) {
           // Your logic when the device leaves a Bluedot Zone
        }
   }

3. Assign GeoTriggeringEvent delegate with your implementation using BDLocationManager

   let instanceOfYourClass = YourClass()
   BDLocationManager.instance()?.geoTriggeringEventDelegate = instanceOfYourClass

4. Authenticate with the Bluedot services using BDLocationManager

   BDLocationManager.instance()?.initialize()(withProjectId: projectId) { error in
        guard error == nil else {
           print("There was an error initializing the Bluedot Point SDK: \(error.localizedDescription)")
           return
        }
   }

Integrate your project with Braze SDK

1. Install the Braze SDK and then import to your class: import BrazeKit

2. Add a static property to your AppDelegate class

   class AppDelegate: UIResponder, UIApplicationDelegate {
       static var braze: Braze? = nil
   }

3. Configure Braze SDK within the application:didFinishLaunchingWithOptions method.
   For further information refer to Braze Developer Documentation

   ```swift
   let configuration = Braze.Configuration(
       apiKey: "YOUR-APP-IDENTIFIER-API-KEY", // Should be taken from Braze Portal -> Manage Settings -> Settings Tab -> Your App -> API Key
       endpoint: "YOUR-BRAZE-ENDPOINT" // Should be taken from Braze Portal -> Manage Settings -> Settings Tab -> Your App -> SDK Endpoint
   )
   
   let braze = Braze(configuration: configuration)
   AppDelegate.braze = braze
   ```

4. Track Braze custom events in your Bluedot Entry / Exit events.

   func didEnterZone(_ triggerEvent: GeoTriggerEvent) {
   
       print("Entered Zone: \(String(describing: triggerEvent.zoneInfo.name))")
   
       // Name the custom event
       let customEventName = "bluedot_entry"
           
       // Map the Location and Zone attributes into a properties dictionary
       var properties = [
           "zone_id": "\(triggerEvent.zoneInfo.id)",
           "zone_name": "\(triggerEvent.zoneInfo.name)",
           "latitude": "\(triggerEvent.entryEvent?.locations[0].coordinate.latitude ?? 0.0)",
           "longitude": "\(triggerEvent.entryEvent?.locations[0].coordinate.longitude ?? 0.0)",
           "speed": "\(triggerEvent.entryEvent?.locations[0].speed ?? 0.0)",
           "bearing": "\(triggerEvent.entryEvent?.locations[0].course ?? 0.0)",
           "timestamp": "\(triggerEvent.entryEvent?.eventTime.timeIntervalSince1970 ?? 0.0)",
       ]
   
       // Map the Custom Data attributes into properties
       let customData = triggerEvent.zoneInfo.customData
       if !customData.isEmpty {
           customData.forEach { data in properties["\(data.key)"] = "\(data.value)"}
       }
   
       // Log the Custom Event in Braze
       AppDelegate.braze?.logCustomEvent(name: customEventName, properties: properties)
   }
   
   func didExitZone(_ triggerEvent: GeoTriggerEvent) {
   
       print("Exited Zone: \(String(describing: triggerEvent.zoneInfo.name))")
   
       // Name the custom event
       let customEventName = "bluedot_exit"
   
       // Map the Zone attributes into a properties dictionary
       var properties = [
           "zone_id": "\(triggerEvent.zoneInfo.id)",
           "zone_name": "\(triggerEvent.zoneInfo.name)",
           "timestamp": "\(triggerEvent.exitEvent?.eventTime.timeIntervalSince1970 ?? 0.0)",
           "checkedInDuration": "\(triggerEvent.exitEvent?.dwellTime ?? 0.0)"
       ]
   
       // Map the Custom Data attributes into properties
       let customData = triggerEvent.zoneInfo.customData
       if !customData.isEmpty {
           customData.forEach { data in properties["\(data.key)"] = "\(data.value)"}
       }
   
       // Log the Custom Event in Braze
       AppDelegate.braze?.logCustomEvent(name: customEventName, properties: properties)
   }