Example usage of the Android SDK
Code example of how to use the Optimizely Feature Experimentation Android SDK to evaluate feature flags, activate A/B tests, or feature tests.
Once you have installed an SDK, import the Optimizely Feature Experimentation library into your code, get your Optimizely Feature Experimentation project's datafile, and instantiate a client. Then, you can use the client to evaluate flag rules, including A/B tests and flag deliveries.
This example demonstrates the basic usage of each of these concepts:
Evaluate a flag with the key
product_sortusing the Decide method. As a side effect, the Decide function also sends a decision event to Optimizely to record that the current user has been exposed to the experiment.Conditionally execute your feature code. You have a couple of options:
- Fetch the flag enabled state, then check a configuration variable on the flag called
sort_method. The SDK evaluates your flag rules and determines what flag variation the user is in and, therefore, which sort method variable they should see. - Fetch on the flag variation, then run 'control' or 'treatment' code.
- Use event tracking to track an event called
purchased. This conversion event measures the impact of an experiment. Using the Track Event method, the purchase is automatically attributed back to the running A/B test for which we made a decision, and the SDK sends a network request to Optimizely through the customizable event dispatcher so Optimizely can count it in yourresults page.
// Build a managerval optimizelyManager = OptimizelyManager.builder() .withSDKKey("<Your_SDK_Key>") .build(context)// Instantiate a client synchronously with a bundled datafile// copy datafile JSON from URL accessible in app>settingsval datafile = "REPLACE_WITH_YOUR_DATAFILE"val optimizelyClient = optimizelyManager.initialize(context, datafile)// Create a user-contextval attributes: MutableMap<String, Any> = HashMap()attributes["logged_in"] = trueval user = optimizelyClient.createUserContext("user123", attributes)!!// Call the decide methodval decision = user.decide("product_sort")// did the decision fail with a critical error?val variationKey = decision.variationKeyif (variationKey == null) { val reasons = decision.reasons Log.d("Optimizely", "decision error: $reasons")}// execute code based on flag enabled stateval enabled = decision.enabledval variables = decision.variablesif (enabled) { var vs: String? = null try { vs = variables.getValue("sort_method", String::class.java) } catch (e: JsonParseException) { e.printStackTrace() }}// or execute code based on flag variation:if (variationKey == "control") { // Execute code for control variation} else if (variationKey == "treatment") { // Execute code for treatment variation}// Track an eventuser.trackEvent("purchased")// Build a managerOptimizelyManager optimizelyManager = OptimizelyManager.builder() .withSDKKey("<Your_SDK_Key>") .build(context);// Instantiate a client synchronously with a bundled datafile// copy datafile JSON from URL accessible in app>settingsString datafile = "REPLACE_WITH_YOUR_DATAFILE";OptimizelyClient optimizelyClient = optimizelyManager.initialize(context, datafile);// Create a user-contextMap<String, Object> attributes = new HashMap<>();attributes.put("logged_in", true);OptimizelyUserContext user = optimizelyClient.createUserContext("user123", attributes);// Call the decide methodOptimizelyDecision decision = user.decide("product_sort");// did the decision fail with a critical error?String variationKey = decision.getVariationKey();if (variationKey == null) { List<String> reasons = decision.getReasons(); Log.d("Optimizely", "decision error: " + reasons);}// execute code based on flag enabled stateboolean enabled = decision.getEnabled();OptimizelyJSON variables = decision.getVariables();if (enabled) { String vs = null; try { vs = variables.getValue("sort_method", String.class); } catch (JsonParseException e) { e.printStackTrace(); }}// or execute code based on flag variation:if (variationKey.equals("control")) { // Execute code for control variation} else if (variationKey.equals("treatment")) { // Execute code for treatment variation}// Track an eventuser.trackEvent("purchased");Updated 17 days ago