Introduction

This guide outlines the integration process for the Wingify Feature Management(FM) SDK and Wingify Insights Mobile SDK to ensure seamless session data synchronization.

With this integration, customers can link session data between Wingify Insights Mobile SDK and Wingify FM SDK, enabling post-segmentation of session data based on various attributes. This empowers them to analyze user behavior more effectively, identify friction points, and optimize user experiences with precise insights.

Benefits of Integrating Both SDKs:

Seamlessly link user sessions between Wingify Insights Mobile SDK and Wingify FM SDK.
Post-segment session data based on specific attributes or flags.
Ensure session consistency when sessions are renewed in the Wingify Insights Mobile SDK.
Enhance tracking, analysis, and insights across both platforms.

Prerequisites

Before integrating, ensure the following:

You have access to the latest versions of both SDKs.
You have already added Wingify Insights Mobile SDK and Wingify FM SDK separately in your application.
You have your Wingify Insights Mobile SDK API key and Wingify FM SDK credentials along with the AccountId and unique USER_ID

Integration

While integrating both SDKs, ensure the following:

Implement the Session Callback as shown and pass the received session data to the Wingify FM SDK for session validation.

private fun getSessionCallback(): IVwoSessionCallback {
    return IVwoSessionCallback { sessionData ->
        FMEConfig.setSessionData(sessionData)
    }
}

func vwoScreenCaptureSessionDidUpdate(sessionData: [String : Any]) {
    FmeConfig.setSessionData(sessionData)
}

USER_ID is mandatory to link both SDKs and ensure session continuity by passing the session callback.

val sessionCallback = getSessionCallback()

VWOInsights.linkFME(sessionCallback, USER_ID)

VWO.linkFme(sessionCallback: self, userId: "")

Initialize the Wingify Insights Mobile SDK first, as it handles session recording and tracking.
Wait for a successful initialization callback from Wingify Insights before starting the Wingify FM SDK to avoid misalignment in session data.
Start session recording before initializing the Wingify FM SDK to ensure all interactions are captured correctly.

Step 1: Configure and Initialize the Wingify Insights Mobile SDK

class WingifyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        initVWOInsights()
    }

    private fun initVWOInsights() {
        val config = ClientConfiguration(ACCOUNT_ID, SDK_KEY, null)

        /* Below two lines are extra code needed to link both the SDKs.*/

        // SessionCallback to revalidate sessions
        val sessionCallback = getSessionCallback()
        // USER_ID is mandatory to link between both the SDKs
        WingifyLog.i(VWInsights.linkFME(sessionCallback, USER_ID)

        // Initialize Wingify Insights Mobile SDK
        WingifyLog.i(VWInsights.init(this, object : IVwoInitCallback {
            override fun vwoInitSuccess(message: String) {
							  // Mobile Insights SDK initializated successfully
               WingifyLog.i(VWInsights.startSessionRecording()

                // Init Wingify FM SDK
                initWingifyFME()
            }

            override fun vwoInitFailed(message: String) {
               WingifyLog.i(VWOLog.INITIALIZATION_LOGS, "vwoInitFailed: $message", false)
            }
        }, config)
    }
}

import Wingify_FME
import Wingify_Insights

@main
class AppDelegate: UIResponder, UIApplicationDelegate,SessionCallback {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        self.initMiSDK()
        return true
    }

    func initMiSDK() {
				// SessionCallback to revalidate sessions and userId is mandatory
       Wingify.linkFme(sessionCallback: self, userId: "")

       Wingify.configure(accountId: "", sdkKey: "", userId: "", completion: { result in
            switch result {
            case .success(_):
                // Mobile Insights SDK initializated successfully
               .startSessionRecording()

                // Init Wingify FM SDK
                self.initWingifyFME()
            case .failure(_):
                print("Wingify Insights initialization failed")
            }
        })
    }
}

Step 2: Initialize the Wingify FM SDK

private fun initWingifyFME() {
    val wingifyInitOptions =InitOptions()
    wingifyInitOptions.sdkKey = FME_SDK_KEY
    wingifyInitOptions.accountId = WINGIFY_ACCOUNT_ID
    wingifyInitOptions.context = [email protected]

   .init(wingifyInitOptions, object : com.vwo.interfaces.IVwoInitCallback {
        override fun vwoInitSuccess(wingifyClient:, message: String) {
            // use wingifyClient to invoke Wingify FM SDK APIs
        }

        override fun vwoInitFailed(message: String) {
            Log.i("VWOSession", "SessionId Uuid FM Init failed: $message")
        }
    })
}

private fun initWingifyFME() {
    val wingifyInitOptions =InitOptions()

    wingifyInitOptions.sdkKey = FME_SDK_KEY
    wingifyInitOptions.accountId = WINGIFY_ACCOUNT_ID
    wingifyInitOptions.context = [email protected]

   .init(wingifyInitOptions, object : com.vwo.interfaces.IVwoInitCallback {
        override fun vwoInitSuccess(wingifyClient:, message: String) {
            // use wingifyClient to invoke Wingify FM SDK APIs
        }

        override fun vwoInitFailed(message: String) {
            Log.i("VWOSession", "SessionId Uuid FM Init failed: $message")
        }
    })
}

Step 3: Implement Session Callback

private fun getSessionCallback(): IVwoSessionCallback {
    return IVwoSessionCallback { sessionDetails ->
        // Pass the received session data to the FM SDK for session validation
        FMEConfig.setSessionData(sessionDetails)
    }
}

func vwoScreenCaptureSessionDidUpdate(sessionDetails: [String : Any]) {
    // Pass the received session data to the FM SDK for session validation
    FmeConfig.setSessionData(sessionDetails)
}

Sequence Diagram

sequenceDiagram
    participant App as Application / AppDelegate Class
    participant Wingify as Wingify Insights Mobile SDK
    participant FM as Wingify FM SDK

    App->>Wingify:Insights.linkFME(sessionCallback, USER_ID)
    App->>Wingify:.configure(accountId, sdkKey, userId, callback)
    Wingify-->>App: IVwoSessionCallback()
    App->>FM: FMEConfig.setSessionData(sessionMap)
    Wingify-->>App: vwoInitSuccess()
    App->>Wingify:Insights.startSessionRecording()
    App->>FM: initWingifyFME()
    FM-->>App: FM SDK initialised successfully

Summary

This document outlines integrating the Wingify Insights Mobile SDK and Wingify FM SDK in both Android and iOS applications. Developers can ensure accurate tracking and analysis for experiments and feature rollouts by linking the session data between both SDKs.