DocumentationAPI ReferenceSupport
API Reference
Sign In
  1. Wingify USER FEEDBACK - MOBILE

Surveys - Android - Migration Guide

Migration Guide: Blitzllama to Wingify User Feedback Android SDK

Overview

This guide helps you migrate your Android application from the Blitzllama SDK to the Wingify User Feedback SDK for in-app surveys. Both SDKs provide similar functionality, but there are key differences in initialization, configuration, and API methods.

Minimum Requirements:

  • Android 5.0 (API level 21) and above
  • Wingify dashboard access (to obtain Account ID and SDK Key)

Migration Summary

FeatureBlitzllama SDKWingify User Feedback SDK
Dependencycom.blitzllama:Blitzllama:1.9.1com.vwo:insights:2.7.0
API Key LocationAndroidManifest.xmlClientConfiguration object
User CreationSeparate createUser() callPassed during initialization (optional), then use setUserId() to switch users
User Switchinglogout()setUserId(randomString, callback)
Trigger MethodtriggerEvent()trackEvent()
SDK ManagerBlitzLlamaSDK.getSdkManager()VWOInsights.getSurveySdkManager()
User AttributessetUserAttribute()setAttribute()

Step 1: Update Dependencies

Remove Blitzllama Dependency

Before (Blitzllama):

// app/build.gradle
dependencies {
    implementation 'com.blitzllama:Blitzllama:1.9.1'
}

Add Wingify User Feedback Dependency

After (Wingify User Feedback):

// app/build.gradle
dependencies {
    implementation 'com.vwo:insights:2.7.0'
}

Step 2: Update AndroidManifest.xml

Remove Blitzllama Configuration

Remove the following from AndroidManifest.xml:

<!-- REMOVE THIS -->
<meta-data 
    android:name="blitz_api_key"   
    android:value="YOUR_BLITZLLAMA_API_KEY" />

Wingify Configuration

Wingify User Feedback does not require manifest configuration. Credentials are passed programmatically during SDK initialization.

📘

Note: If you had <uses-sdk tools:overrideLibrary="com.blitzllama.androidSDK" />, you can remove it as well.

Step 3: Update SDK Initialization

The most significant change is in how the SDK is initialized and how users are identified.

Key Points:

  • User ID can be passed during initialization in ClientConfiguration (optional)
  • Use setUserId() later to switch users or identify users after they log in
  • For anonymous users, you can pass an empty string ("") during initialization or use a random string with setUserId()

Blitzllama Approach (Before)

Java

// Application class extending BlitzLlamaSDK
public class MyApplication extends BlitzLlamaSDK {
    @Override
    public void onCreate() {
        super.onCreate();
        BlitzLlamaSDK.init(this);
    }
}

// In your Activity - Create user separately
BlitzLlamaSDK.getSdkManager(this).createUser("user_id");

Kotlin

class MyApplication : BlitzLlamaSDK() {
    override fun onCreate() {
        super.onCreate()
        BlitzLlamaSDK.init(this)
    }
}

// In your Activity - Create user separately
BlitzLlamaSDK.getSdkManager(this).createUser("user_id")

Wingify User Feedback Approach (After)

Java

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();

        // User ID is optional during initialization
        // Pass empty string ("") for anonymous users, or actual user ID if known
        ClientConfiguration clientConfig = new ClientConfiguration(
            "your_account_id",    // Account ID from Wingify dashboard
            "your_sdk_key",       // SDK Key from Wingify dashboard
            ""                    // User ID (optional) - use "" for anonymous, or "user_id" if known
        );

        IVwoInitCallback callback = new IVwoInitCallback() {
            @Override
            public void vwoInitSuccess(@NotNull String message) {
                // SDK initialized successfully
                // Safe to trigger surveys now
                
                // If user logs in later, use setUserId() to identify them:
                // VWOInsights.setUserId("user_id", callback);
            }

            @Override
            public void vwoInitFailed(@NotNull String message) {
                // Handle initialization failure
            }
        };

        VWOInsights.init(this, callback, clientConfig);
    }
}

Kotlin

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()

        // User ID is optional during initialization
        // Pass empty string ("") for anonymous users, or actual user ID if known
        val clientConfig = ClientConfiguration(
            "your_account_id",    // Account ID from Wingify dashboard
            "your_sdk_key",       // SDK Key (App ID) from Wingify dashboard
            ""                    // User ID (optional) - use "" for anonymous, or "user_id" if known
        )

        val callback = object : IVwoInitCallback {
            override fun vwoInitSuccess(message: String) {
                // SDK initialized successfully
                // Safe to trigger surveys now
                
                // If user logs in later, use setUserId() to identify them:
                // VWOInsights.setUserId("user_id", callback)
            }

            override fun vwoInitFailed(message: String) {
                // Handle initialization failure
            }
        }

        VWOInsights.init(this, callback, clientConfig)
    }
}

Key Changes

  1. No longer extend SDK class - Your Application class extends Application instead of BlitzLlamaSDK
  2. User ID is optional at initialization - User identifier can be passed in ClientConfiguration (use "" for anonymous users), or set later using setUserId()
  3. Use setUserId() to switch users - Call setUserId() when user logs in or switches accounts (no separate createUser() or logout() methods)
  4. Callback-based initialization - Wingify uses explicit success/failure callbacks

Step 4: Update Survey Triggers

Basic Trigger

Blitzllama (Before):

Java

BlitzLlamaSDK.getSdkManager(context).triggerEvent("trigger_name");

Kotlin

BlitzLlamaSDK.getSdkManager(context).triggerEvent("trigger_name")

Wingify User Feedback (After):

Java

SdkManager sdkManager = VWOInsights.getSurveySdkManager(context);
sdkManager.trackEvent("event_name");

Kotlin

val sdkManager = VWOInsights.getSurveySdkManager(context)
sdkManager.trackEvent("event_name")

Trigger with Event Properties

Blitzllama (Before):

Java

Map<String, Object> properties = new HashMap<>();
properties.put("product_id", "SKU123");
properties.put("amount", 99.99);

BlitzLlamaSDK.getSdkManager(context).triggerEvent("purchase_completed", properties);

Kotlin

val properties = mapOf(
    "product_id" to "SKU123",
    "amount" to 99.99
)

BlitzLlamaSDK.getSdkManager(context).triggerEvent("purchase_completed", properties)

Wingify User Feedback (After):

Java

SdkManager sdkManager = VWOInsights.getSurveySdkManager(context);

Map<String, Object> properties = new HashMap<>();
properties.put("product_id", "SKU123");
properties.put("amount", 99.99);
properties.put("category", "electronics");

sdkManager.trackEvent("purchase_completed", properties);

Kotlin

val sdkManager = VWOInsights.getSurveySdkManager(context)

val properties = mapOf(
    "product_id" to "SKU123",
    "amount" to 99.99,
    "category" to "electronics"
)

sdkManager.trackEvent("purchase_completed", properties)

Trigger with Completion Callback

Blitzllama (Before):

Java

BlitzLlamaSDK.getSdkManager(context).triggerEvent("event_name", properties, new SurveyListener() {
    @Override
    public void onSurveyComplete() {
        // Survey completed
    }
});

Wingify User Feedback (After):

Java

SdkManager sdkManager = VWOInsights.getSurveySdkManager(context);

Map<String, Object> properties = new HashMap<>();
properties.put("screen", "home");

sdkManager.trackEvent("home_screen_loaded", properties, result -> {
    // Survey interaction completed
    System.out.println("Survey completed with result: " + result);
});

Kotlin

val sdkManager = VWOInsights.getSurveySdkManager(context)

val properties = mapOf("screen" to "home")

sdkManager.trackEvent("home_screen_loaded", properties) { result ->
    // Survey interaction completed
    println("Survey completed with result: $result")
}

Trigger with Activity Reference

For better context when displaying surveys, you can pass an Activity reference:

Java

SdkManager sdkManager = VWOInsights.getSurveySdkManager(context);
sdkManager.trackEventWithActivity(this, "checkout_screen");

Kotlin

val sdkManager = VWOInsights.getSurveySdkManager(context)
sdkManager.trackEventWithActivity(this, "checkout_screen")

Method Mapping

BlitzllamaWingify User Feedback
triggerEvent("name")trackEvent("name")
triggerEvent("name", properties)trackEvent("name", properties)
triggerEvent("name", properties, listener)trackEvent("name", properties, listener)
N/AtrackEventWithActivity(activity, "name")

Step 5: Update User Attributes

Setting Email and Name

Blitzllama (Before):

BlitzLlamaSDK.getSdkManager(context).setUserEmail("[email protected]");
BlitzLlamaSDK.getSdkManager(context).setUserName("John Doe");

Wingify User Feedback (After):

In Wingify, use setAttribute() to set user email and name:

Java

Map<String, Object> attributes = new HashMap<>();
attributes.put("user_email", "[email protected]");
attributes.put("user_name", "John Doe");

VWOInsights.setAttribute(attributes);

Kotlin

val attributes = mapOf(
    "user_email" to "[email protected]",
    "user_name" to "John Doe"
)

VWOInsights.setAttribute(attributes)
📘

Note: You don't need to include user_id in setAttribute() — the SDK automatically uses the current user ID set via initialization or setUserId().

Setting Custom User Attributes

Blitzllama (Before):

// Set individual attributes with data type
BlitzLlamaSDK.getSdkManager(context).setUserAttribute("plan_type", "premium", "string");
BlitzLlamaSDK.getSdkManager(context).setUserAttribute("user_level", "5", "number");

Wingify User Feedback (After):

Java

// Supports different value types (String, Number, Boolean)
Map<String, Object> attributes = new HashMap<>();
attributes.put("plan_type", "premium");
attributes.put("user_level", 5);      // Can use actual number type
attributes.put("is_active", true);    // Can use boolean

VWOInsights.setAttribute(attributes);

Kotlin

val attributes = mapOf(
    "plan_type" to "premium",
    "user_level" to 5,
    "is_active" to true
)

VWOInsights.setAttribute(attributes)
📘

Note: Wingify uses setAttribute() instead of setUserAttribute(). Data types are automatically inferred, so you don't need to specify them explicitly. The SDK automatically associates attributes with the current user ID.

Step 6: Update Survey Language Setting

Blitzllama (Before):

BlitzLlamaSDK.getSdkManager(context).setSurveyLanguage("en");

Wingify User Feedback (After):

VWOInsights.getSurveySdkManager(context).setSurveyLanguage("en");

This API remains largely the same.

Step 7: Handle User Switching

Blitzllama (Before)

BlitzLlamaSDK.logout();

Wingify User Feedback (After)

Wingify User Feedback does not have a logout() method. Instead, use setUserId() to switch between users. To create anonymous sessions (equivalent to logout), pass a random string as the user ID.

Switching to a New User

Use setUserId() when your user logs in or switches accounts:

import com.vwo.insights.VWOInsights;
import com.vwo.insights.exposed.IVwoInitCallback;

// When user logs in or switches account
VWOInsights.setUserId("new_user_id", new IVwoInitCallback() {
    @Override
    public void vwoInitSuccess(String message) {
        // User switch complete
        // Recording resumes automatically if it was active before
    }

    @Override
    public void vwoInitFailed(String message) {
        // Handle failure
    }
});
import com.vwo.insights.VWOInsights
import com.vwo.insights.exposed.IVwoInitCallback

// When user logs in or switches account
VWOInsights.setUserId("new_user_id", object : IVwoInitCallback {
    override fun vwoInitSuccess(message: String) {
        // User switch complete
        // Recording resumes automatically if it was active before
    }

    override fun vwoInitFailed(message: String) {
        // Handle failure
    }
})

Switching to Anonymous User (Logout)

If your user logs out and you want to track them as anonymous, generate a random user ID:

Java:

import java.util.UUID;

// When user logs out
String randomUserId = UUID.randomUUID().toString();
VWOInsights.setUserId(randomUserId, new IVwoInitCallback() {
    @Override
    public void vwoInitSuccess(String message) {
        // Now tracking as anonymous user
    }

    @Override
    public void vwoInitFailed(String message) {
        // Handle failure
    }
});

Kotlin:

import java.util.UUID

// When user logs out
val randomUserId = UUID.randomUUID().toString()
VWOInsights.setUserId(randomUserId, object : IVwoInitCallback {
    override fun vwoInitSuccess(message: String) {
        // Now tracking as anonymous user
    }

    override fun vwoInitFailed(message: String) {
        // Handle failure
    }
})

Key Differences

BlitzllamaWingify User Feedback
BlitzLlamaSDK.logout()No direct logout method
N/AVWOInsights.setUserId(userId, callback)
Logout clears sessionUse random string for anonymous tracking
Requires re-initializationsetUserId() handles session refresh internally
📘

Note: setUserId() automatically stops the current session, refreshes configuration, and resumes recording if it was active before the switch.

Step 8: Update Event/Trigger Names in Wingify Dashboard

If you're using triggers configured in the Blitzllama dashboard, you may need to recreate them in the Wingify dashboard:

  1. Log in to your Wingify dashboard
  2. Navigate to Data360 → Events → Create
  3. Create events with the same names you used as trigger names in Blitzllama
  4. Configure these events in Surveys → Custom Triggers
⚠️

Important: Ensure event names match exactly between your code and the Wingify dashboard.

Import Statement Changes

Update all your import statements:

Blitzllama ImportWingify User Feedback Import
com.blitzllama.androidSDK.*com.vwo.insights.*
com.blitzllama.androidSDK.BlitzLlamaSDKcom.vwo.insights.VWOInsights
com.blitzllama.androidSDK.SdkInitialisationSuccessCallbackcom.vwo.insights.exposed.IVwoInitCallback

Complete Migration Example

Before (Blitzllama)

// MyApplication.kt
class MyApplication : BlitzLlamaSDK() {
    override fun onCreate() {
        super.onCreate()
        BlitzLlamaSDK.init(this)
    }
}

// MainActivity.kt
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // Create user
        BlitzLlamaSDK.getSdkManager(this).createUser("user_123")
        
        // Set attributes
        BlitzLlamaSDK.getSdkManager(this).setUserEmail("[email protected]")
        BlitzLlamaSDK.getSdkManager(this).setUserAttribute("plan", "premium", "string")
        BlitzLlamaSDK.getSdkManager(this).setSurveyLanguage("en")
        
        // Trigger survey
        BlitzLlamaSDK.getSdkManager(this).triggerEvent("home_screen_loaded")
    }
}

After (Wingify User Feedback)

// MyApplication.kt
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()
        
        val clientConfig = ClientConfiguration(
            "your_account_id",
            "your_sdk_key",
            "user_123"  // User ID now here
        )
        
        val callback = object : IVwoInitCallback {
            override fun vwoInitSuccess(message: String) {
                // SDK ready
            }
            override fun vwoInitFailed(message: String) {
                // Handle failure
            }
        }
        
        VWOInsights.init(this, callback, clientConfig)
    }
}

// MainActivity.kt
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // SDK must be initialized before calling these methods
        val sdkManager = VWOInsights.getSurveySdkManager(this)
        
        // Set attributes (including email and name)
        VWOInsights.setAttribute(mapOf(
            "user_email" to "[email protected]",
            "user_name" to "John Doe",
            "plan" to "premium"
        ))
        sdkManager.setSurveyLanguage("en")
        
        // Trigger survey
        sdkManager.trackEvent("home_screen_loaded")
    }
}

Troubleshooting

Survey not showing after migration?

  1. Verify initialization: Ensure vwoInitSuccess callback is received before triggering surveys
  2. Check event names: Event names must match exactly with VWO dashboard configuration
  3. Verify credentials: Confirm Account ID and SDK Key are correct from VWO dashboard

Race condition on first screen?

Use the vwoInitSuccess callback to trigger surveys:

val callback = object : IVwoInitCallback {
    override fun vwoInitSuccess(message: String) {
        // Safe to trigger survey here
        VWOInsights.getSurveySdkManager(context).trackEvent("app_launched")
    }
    override fun vwoInitFailed(message: String) { }
}

Migration Checklist

  • Updated build.gradle dependency from Blitzllama to Wingify User Feedback
  • Removed Blitzllama meta-data from AndroidManifest.xml
  • Updated Application class initialization
  • Replaced createUser() with setUserId() for user identification
  • Changed triggerEvent() calls to trackEvent()
  • Updated setUserAttribute() to setAttribute()
  • Updated import statements
  • Configured events in Wingify dashboard
  • Tested survey triggering in the app

Version Information

ComponentVersion
Wingify User Feedback SDK Version2.7.0
Minimum Android SDK21 (Android 5.0)
Blitzllama SDK Version (migrating from)1.9.1

Updated about 10 hours ago

Did this page help you?

Updated about 10 hours ago

Did this page help you?