CleverTap iOS Integration

Table of Contents

Getting started

This documentation depends on Bluedot PointSDK and CleverTap SDK. Both dependencies can be managed by CocoaPods or Carthage.

Integrate your project with Bluedot Point SDK

You can find detailed instructions at https://docs.bluedot.io/ios-sdk/ios-quick-start

1. Import BDPointSDK to your class:import BDPointSDK
2. Implement Bluedot BDPGeoTriggeringEventDelegate:

   // Swift
   extension YourClass: BDPGeoTriggeringEventDelegate {
   
       func didEnterZone(_ enterEvent: BDZoneEntryEvent) {
           // Your logic when the device enters a Bluedot Zone
       }
   
        func didExitZone(_ exitEvent: BDZoneExitEvent) {
           // Your logic when the device leaves a Bluedot Zone
        }
   }

3. Assign GeoTriggeringEvent delegate with your implementation

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

4. Authenticate with the Bluedot services

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

Integrate your project with CleverTap SDK

Import CleverTap-iOS-SDK to your class

// Swift
 import CleverTapSDK

Then start CleverTap within the application:didFinishLaunchingWithOptions method.

// Swift
CleverTap.autoIntegrate()

Track CleverTap custom events in your Bluedot Entry / Exit events.

func didEnterZone(_ enterEvent: BDZoneEntryEvent) {
        // Name the custom event
        let customEventName = YOUR CUSTOM EVEN NAME

        // Map the Location and Zone attributes into a properties dictionary
        var properties = [
            "bluedot_zone_id": "\(enterEvent.zone().id!)",
            "bluedot_zone_name": "\(enterEvent.zone().name!)"
        ]

        // Map the Custom Data attributes into properties
        if let custData = enterEvent.zone().customData, !custData.isEmpty {
            custData.forEach { data in properties["\(data.key)"] = "\(data.value)"}
        }
        
        // Log the Custom Event in CleverTap
        CleverTap.sharedInstance()?.recordEvent(customEventName, withProps: properties)
    }