Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
iOS client library for SeatGeek's Sixpack A/B testing framework http://sixpack.seatgeek.com/
Objective-C Ruby
branch: master
Failed to load latest commit information.
Sixpack-iOS
SixpackClient.xcodeproj Moved some source files around to be new cocoa pods compatible
.gitignore Added new debug logging options, and helper methods for fetching chos…
.gitmodules #929 Removed AFNetworking as a submodule from sixpack-ios
CHANGELOG.md source restructuring to work with cocoa pods
LICENSE Updated License, bump to version 1.0
README.md corrected Podfile line
Sixpack-iOS.podspec Pod spec update
SixpackClient-Prefix.pch Added new debug logging options, and helper methods for fetching chos…

README.md

Sixpack-iOS

iOS client library written in Objective-C for SeatGeak's Sixpack ab testing framework.

Version Platform

Installation

CocoaPods

The recommended way to use Sixpack-iOS is through CocoaPods

Sixpack-iOS.podspec is available through CocoaPods, to install it simply add the following line to your Podfile:

pod "Sixpack-iOS"

Manual Installation

If you wish to include Sixpack-iOS manually in your project, you must add the SixPackClient Xcode project to your project's workspace.

You will also have to add the appropriate AFNetworking 2.0 source files to the Sixpack-iOS project in order for linking to complete successfully.

Usage

1. Connect to the Sixpack host

Call connectToHost before any other Sixpack calls. Usually inside: application:didFinishLaunchingWithOptions:

The Url should be the location of your sixpack mountpoint:

[Sixpack connectToHost:@"http://my.sixpack.host:8129/sixpack/mount/point"];

2. Set up the experiments

Call setupExperiment once for each experiment after calling connectToHost and before participating:

[Sixpack setupExperiment:@"myExperiment"
           alternatives:@[@"optionA", @"optionB"];

3. Participate in an experiment

Call participate to participate in an experiment. The chosen alternative is returned in the onChoose block:

[Sixpack participateIn:@"myExperiment"
             onChoose:^(NSString *chosenAlternative) {
        if ([chosenAlternative isEqualToString:@"optionA"]) {
            ... Do option A work

        } else if ([chosenAlternative isEqualToString:@"optionB"]) {
            ... Do option B work
        }
    }];

4. Convert

Call convert with the experiment name once the goal is achieved:

[Sixpack convert:@"myExperiment"];

Helper methods

After participating in an experiment, you can retrieve the chosen alternative for that experiment at any time:

+ (NSString *)chosenAlternativeFor:(NSString *)experiment;

After participating in an experiment, you can check for whether a particular alternative was chosen:

+ (BOOL)chosenAlternativeFor:(NSString *)experiment is:(NSString *)alternative;

For Example:

 if ([Sixpack chosenAlternativeFor:@"myExperiment" is:@"optionA"]) {
    [self.view addSubview:self.viewA];
 } else {
    [self.view addSubview:self.viewB];
 }

Debugging

Use this setup method to force an experiment result:

+ (void)setupExperiment:(NSString *)experiment
           alternatives:(NSArray *)alternatives
            forceChoice:(NSString *)forcedChoice;

You can turn on and off debug logging. Logging defaults to On for DEBUG builds and Off for RELEASE builds. You should ensure this is off before submitting to the app store

+ (void)enableDebugLogging:(BOOL)debugLogging;

License

Sixpack-iOS is available under the FreeBSD license. See the LICENSE file for more info.

Something went wrong with that request. Please try again.