A/B Testing - Stringboot

Stringboot’s A/B testing engine works seamlessly on iOS.

How It Works

1

Assignment

The SDK assigns a unique Device ID and determines the user’s variant.

2

Delivery

SBText, SBLabel, and StringProvider.get() automatically return the variant string.

3

Tracking

You log the assignment to your analytics provider.

Analytics Integration

To track experiment performance, implement the StringbootAnalyticsHandler protocol.

1

Implement Analytics Handler

Create a class conforming to StringbootAnalyticsHandler. Choose your analytics provider below:

Firebase
Mixpanel
Amplitude

class MyAnalyticsHandler: StringbootAnalyticsHandler {
    func onExperimentAssigned(_ assignment: ExperimentAssignment) {
        Analytics.logEvent("experiment_assigned", parameters: [
            "experiment_key": assignment.experimentKey,
            "variant_name": assignment.variantName,
            "string_key": assignment.stringKey
        ])
    }

    func onExperimentViewed(_ experimentKey: String, variantName: String) {
        Analytics.logEvent("experiment_viewed", parameters: [
            "experiment_key": experimentKey,
            "variant_name": variantName
        ])
    }
}

class MyAnalyticsHandler: StringbootAnalyticsHandler {
    func onExperimentAssigned(_ assignment: ExperimentAssignment) {
        Mixpanel.mainInstance().track(event: "Experiment Assigned", properties: [
            "experiment_key": assignment.experimentKey,
            "variant_name": assignment.variantName,
            "string_key": assignment.stringKey
        ])
    }

    func onExperimentViewed(_ experimentKey: String, variantName: String) {
        Mixpanel.mainInstance().track(event: "Experiment Viewed", properties: [
            "experiment_key": experimentKey,
            "variant_name": variantName
        ])
    }
}

class MyAnalyticsHandler: StringbootAnalyticsHandler {
    func onExperimentAssigned(_ assignment: ExperimentAssignment) {
        Amplitude.instance().logEvent("Experiment Assigned", withEventProperties: [
            "experiment_key": assignment.experimentKey,
            "variant": assignment.variantName,
            "string_key": assignment.stringKey
        ])
    }

    func onExperimentViewed(_ experimentKey: String, variantName: String) {
        Amplitude.instance().logEvent("Experiment Viewed", withEventProperties: [
            "experiment_key": experimentKey,
            "variant": variantName
        ])
    }
}

2

Register Handler

Pass the handler during initialization:

let analyticsHandler = FirebaseAnalyticsHandler()

StringProvider.shared.initialize(
    cacheSize: 1000,
    apiToken: "YOUR_API_TOKEN",
    analyticsHandler: analyticsHandler
)

Debugging

You can inspect active experiments:

Task {
    let experiments = await StringProvider.shared.getExperiments()
    for (key, exp) in experiments {
        print("Key: \(key), Variant: \(exp.variantName)")
    }
}