Arise Android SDK

This documentation will help you to install the Arise Android client in your application.

Installation steps

1. Add the Arise library to your project

First, download the Arise library jar file and drag it inside your project’s /libs/ folder.

2. Add permissions

In your project, right click on AndroidManifest.xml Click on Open With/Android Common XML Editor. Add after the <uses-sdk .... /> tag:

<uses-permission android:name="android.permission.INTERNET"></uses-permission>

3. Initialize the framework

In the onCreate function of your main activity, you need to initialize the framework:

// Initialize the arise library
String authKey = "9c51b5e8f06ebd26728f29954365098f052c68c8";
Arise.initialize(getApplicationContext(), authKey);

Replace the value of authKey by your own key. You can find in your dashboard.

4. Get the experiment value

When you plan to run the experiment, you will need to call the getVariationWithListener with the experiment name (same as the one displayed in your dashboard) to get the experiment data:

// Get and setup the variation
ABTest.getVariationWithListener("Experiment1", VariationListener() {
    @Override
    public void onVariationAvailable(String value) {
            final String buyMessage = value;
    }
});

5. Record events

Now that you have setup your application for testing, you will need to record views and conversion events. You need to pass the experiment name as a parameter to associate the events with an experiment.

Record a view:

ABTest.recordView("Experiment1");

Record a conversion:

ABTest.recordConversion("Experiment1");

Full code example

package com.example.shoestore;

import io.arise.ABTest;
import io.arise.Arise;
import io.arise.VariationListener;
import android.os.Bundle;
import android.app.Activity;

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);

            // Initialize the arise library
            String authKey = "9c51b5e8f06ebd26728f29954365098f052c68c8";
            Arise.initialize(getApplicationContext(), authKey);

            // Get and setup the variation
            ABTest.getVariationWithListener("Experiment1", new VariationListener() {
                    @Override
                    public void onVariationAvailable(String value) {
                            // Change the button label
                            final String buyMessage = value;
                            // Use the buyMessage to customize our application
                            // ...

                    }
            });

    }

    private void onLoadPurchasePage(){
            // the user is viewing the item purchase page
            // record a view event
            ABTest.recordView("Experiment1");
    }

    private void onPurchaseCompleted(){
            // the user has bought the item
            // record a conversion event
            ABTest.recordConversion("Experiment1");
    }
}

Notes

The Arise Android SDK supports Android 2.3.3 (API level 10) and later.

Project Versions

Table Of Contents

Previous topic

Arise iOS SDK

Next topic

Release notes

This Page