How to Integrate the Device Data Collector into Flutter Applications

A Runner-Bridging-header.h file is created automatically. You can use this file or you can import the SDK directly into the file.

In the Appdelegate.swift file, update the merchantID field with the merchant ID that was assigned to you. In addition, use the KEnvironment.test environment when running tests, and KEnvironment.prod when releasing running in production.

    KDataCollector.shared().locationCollectorConfig = KLocationCollectorConfig.requestPermissionKDataCollector.shared().debug = true
    KDataCollector.shared().merchantID = "900900" // Insert your valid merchant ID
    KDataCollector.shared().environment = KEnvironment.test
    
    KountAnalyticsViewController().setEnvironmentForAnalytics(KDataCollector.shared().environment)
    
    let controller : FlutterViewController = window?.rootViewController as! FlutterViewControllerlet 
    collectChannel = FlutterMethodChannel(name: "DataCollector", binaryMessenger: controller.binaryMessenger)
    collectChannel.setMethodCallHandler({[weak self] (call: FlutterMethodCall, result: @escaping FlutterResult) -> Void in
        // Note: this method is invoked on the UI thread.
        if call.method == "collect" {
                        self?.callCollect(result: result)
                     }
                    else if call.method == "getSessionID" {
                       self?.callGetSessionID(result: result)
                     }
                     else {
                        result(FlutterMethodNotImplemented)
                        return
                     }
    })
    

Create a private function, callCollect() which takes the result as an argument. In this function, invoke the collector using either the the supplied sessionID KountAnalyticsViewController.getAppSessionID(), your own sessionID, or @"".

Do not forget to send the sessionID used here back to your servers. You must use the sessionID when making API calls to evaluate this transaction/event. Analytics are not available for hybrid apps. This example shows the callback function which will be returned upon completion. Update them as needed for your application.

    private func callCollect(result: @escaping FlutterResult) {
    KountAnalyticsViewController().collect(KountAnalyticsViewController.getAppSessionID(), analyticsSwitch:false) {
      (sessionID, success, error) in
        if (success) {
          result("Collection Successful")
          print("Collection Successful")
        }
        else {
            if((error) != nil) {
              print("Collection failed with error",error?.localizedDescription as Any)
            }else {
              print("Collection failed without error")
            }
            result(FlutterError(code: "UNAVAILABLE" ,message:error?.localizedDescription, details: nil))
        }
      }
    }
                     
    
    private func callGetSessionID(result: @escaping FlutterResult) {
      result(KountAnalyticsViewController.getAppSessionID())
    }
    

You can import the header files or import the SDK directly into the Objective-C file.

In the Appdelegate.m file, write the following code snippet. Update the merchantID field with the merchant ID that was assigned to you. In addition, use the KEnvironmentTest environment when running tests, and KEnvironmentProduction when releasing running in production.

    [[KDataCollector sharedCollector] setDebug:YES];
    // TODO Set your Merchant ID
    [[KDataCollector sharedCollector] setMerchantID:@"900900"];
    // TODO Set the location collection configuration
    [[KDataCollector sharedCollector] setLocationCollectorConfig:KLocationCollectorConfigRequestPermission];
    // For a released app, you'll want to set this to KEnvironmentProduction
    [[KDataCollector sharedCollector] setEnvironment:KEnvironmentTest];
    [[KountAnalyticsViewController sharedInstance] setEnvironmentForAnalytics: [KDataCollector.sharedCollector environment]];
    FlutterViewController *controller = [[FlutterViewController alloc] init];
    controller = (FlutterViewController*)self.window.rootViewController;
    FlutterMethodChannel *collectChannel = [FlutterMethodChannel methodChannelWithName:@"DataCollector" binaryMessenger:controller.binaryMessenger];
    [collectChannel setMethodCallHandler:^(FlutterMethodCall * _Nonnull call, FlutterResult  _Nonnull result) {
        if ([call.method isEqual:@"collect"]) {
            [self callCollect:result];
        }
        else if ([call.method isEqual:@"getSessionID"]) {
            [self callGetSessionID:result];
        }
        else {
            result(FlutterMethodNotImplemented);
        }
    }];
    

Create a private function, callCollect() which takes result as argument and is being called in above code snippet. In this function, you must invoke the collector using either the Kount Supplied sessionID KountAnalyticsViewController.getAppSessionID, your own sessionID, or @"".

Do not forget to send the sessionID used here back to your servers. You will need to use it when making API calls to evaluate this transaction/event. Analytics are not available for hybrid apps. This example shows the callback function which will be returned upon completion. Update them as needed for your application.

    - (void)callCollect:(_Nonnull FlutterResult)result {
        [[KountAnalyticsViewController sharedInstance] collect:@"" analyticsSwitch:NO completion:^(NSString * _Nonnull sessionID, BOOL success, NSError * _Nullable error) {
                if(success) {
                    result(@"Collection Successful");
                    NSLog(@"Collection Successful");
                }
                else {
                    if (error != nil) {
                        NSLog(@"Collection failed with error:%@",error.description);
                    }
                    else {
                        NSLog(@"Collection failed without error");
                    }
                    result([FlutterError errorWithCode:@"UNAVAILABLE" message:error.localizedDescription details:nil]);
                }
        }];
    }

    - (void)callGetSessionID:(_Nonnull FlutterResult)result {
        result([KountAnalyticsViewController getAppSessionID]);
    }
    

Click on your project in the project navigator to open your project settings.

Select your target, and then open the General tab.

Scroll to Frameworks, Libraries, and then Embedded Content Settings.

On the newly-added KountDataCollector.xcframework, select Do Not Embed.

If you do not see KountDataCollector.xcframework, you must add it manually: