Arise iOS SDK

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

Installation steps

1. Add the Arise library to your project

First, download the Arise SDK for iOS. Unzip it and drag it inside your project’s Frameworks folder in XCode. Ensure that you select ‘Copy items into the destination group’s folder’ when the dialogue box appears.

2. Add dependencies

In XCode:

• select your project in the project navigator
• in the project settings select your target
• click on the Build Phases tab
• Open the Link With Libraries collapsible panel
• Click on ‘+’
• Search for libsqlite3.dylib and click on the Add button.

3. Initialize the framework

Add the following line in your AppDelegate.h:

#import <Arise/Arise.h>

Add the following line under application:didFinishLaunchingWithOptions of your AppDelegate.m file to initialize the framework:

[Arise initializeWithKey:@"9c51b5e8f06ebd26728f29954365098f052c68c8"];

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

4. Get the experiment value

You can request a variation value using the getVariation: method with the experiment name (same as the one displayed in your dashboard) :

[ABTest getVariation:@"Experiment1" data:^(NSString *value){
    purchaseButton.title = value;
}];

Do not forget to import the Arise SDK in your header file:

#import <Arise/Arise.h>

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

#import "ViewController.h"

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad
{
    [super viewDidLoad];

    // Get and setup the variation
    [ABTest getVariation:@"Experiment1" data:^(NSString *value){
        // Use the variation value to customize our application
        // ...

        // For example :
        // Change the title of the purchase button
        purchaseButton.title = value;
    }];
}

- (void)onLoadPurchasePage
{
    // the user is viewing the item purchase page
    // record a view event
    [ABTest recordView:@"Experiment1"];
}

- (IBAction)onPurchase:(id)sender
{
    // the user has bought the item
    // record a conversion event
    [ABTest recordConversion:@"Experiment1"];
}

- (void)didReceiveMemoryWarning
{
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

Notes

The Arise iOS SDK supports iOS 6 and later.