Initialization

After installing the SDK, initialize the app in the onCreate function of the Application class.

Parameters

Key	Description
ACCOUNT_ID Required	Wingify Account ID
SDK_KEY Required	SDK key
USER_ID Optional	Unique identifier for the user
IVwoInitCallback Optional	SDK Initialization callback

Example

package com.wingify.screenshotsample

import android.app.Application
import com.vwo.insights.VWOInsights
import com.vwo.insights.core.models.ClientConfiguration
import com.vwo.insights.exposed.IVwoInitCallback

class VWOApplication : Application() {

    override fun onCreate() {
        super.onCreate()
          
        ClientConfiguration configuration = new ClientConfiguration("ACCOUNT_ID", "SDK_KEY", "USER_ID");
        VWOInsights.init(this, new IVwoInitCallback() { 
                @Override  
                public void vwoInitSuccess(@NonNull String s) {
                     // Insights SDK Initialized successfully 
                }
     
                @Override
                public void vwoInitFailed(@NonNull String s) {
                     // Insights SDK NOT Initialized successfully
                }
         }, configuration, null);
    
    }
}

package com.wingify.screenshotsample

import android.app.Application
import com.vwo.insights.VWOInsights
import com.vwo.insights.core.models.ClientConfiguration
import com.vwo.insights.exposed.IVwoInitCallback

class VWOApplication : Application() {

    override fun onCreate() {
      super.onCreate()
 
        val configuration = ClientConfiguration("ACCOUNT_ID","APPLICATION_ID", "USER_ID")

        VWOInsights.init(this, object : IVwoInitCallback {
              override fun vwoInitSuccess(message: String) {  
                    // Insights SDK Initialized successfully 
              }


              override fun vwoInitFailed(message: String) {
                    // Insights SDK NOT Initialized successfully
              }

        }, configuration)
    }

}

Performance Mode

From SDK version 2.6.0+, Mobile Insights provides an optional performance mode that uses a highly optimized recording mechanism for Android native apps.

Call enablePerformanceMode() before init(), typically in your Application.onCreate().

Scope: Android native (including Jetpack Compose) only.
Flutter apps should use enableFlutterPerformanceMode() instead.

API level

Requirement	Value
Minimum for optimized path	Android 8.0 (API 26).
Call on API < 26	Safe — SDK uses the standard recording path

Guidelines

Enable performance mode if you want the optimized recording path introduced in 2.6.0+.
Always call it before SDK initialization.
If you observe unexpected behavior after enabling it, remove the call and verify again.

Example

package com.example.myapp;

import android.app.Application;
import androidx.annotation.NonNull;
import com.vwo.insights.VWOInsights;
import com.vwo.insights.exposed.IVwoInitCallback;
import com.vwo.insights.exposed.models.ClientConfiguration;

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        // From SDK version 2.6.0+ we have introduced a new highly optimized recording
        // mechanism. You can enable it using VWOInsights.enablePerformanceMode();
        // Call this before init(). Takes effect on Android 8.0 (API 26) and above.
        VWOInsights.enablePerformanceMode(); // Android 8.0 (API 26)+

        ClientConfiguration configuration =
                new ClientConfiguration("ACCOUNT_ID", "SDK_KEY", "USER_ID");

        VWOInsights.init(this, new IVwoInitCallback() {
            @Override
            public void vwoInitSuccess(@NonNull String message) {
                // Insights SDK initialized successfully
            }

            @Override
            public void vwoInitFailed(@NonNull String message) {
                // Insights SDK failed to initialize
            }
        }, configuration);
    }
}

package com.example.myapp

import android.app.Application
import com.vwo.insights.VWOInsights
import com.vwo.insights.exposed.IVwoInitCallback
import com.vwo.insights.exposed.models.ClientConfiguration

class MyApplication : Application() {

    override fun onCreate() {
        super.onCreate()

        // From SDK version 2.6.0+ we have introduced a new highly optimized recording
        // mechanism. You can enable it using VWOInsights.enablePerformanceMode().
        // Call this before init(). Takes effect on Android 8.0 (API 26) and above.
        VWOInsights.enablePerformanceMode()

        val configuration = ClientConfiguration("ACCOUNT_ID", "SDK_KEY", "USER_ID")

        VWOInsights.init(this, object : IVwoInitCallback {
            override fun vwoInitSuccess(message: String) {
                // Insights SDK initialized successfully
            }

            override fun vwoInitFailed(message: String) {
                // Insights SDK failed to initialize
            }
        }, configuration)
    }
}

Recommended initialization order

enablePerformanceMode() (optional)
init(...)
After a successful init callback, start session recording as needed