When conducting an A/B test, you need to distribute users to the test groups and write the logic corresponding to each test group. User allocation can be done through the Hackle SDK.

📘

Test Groups

Test groups refer to the existing versions, including the control group (baseline) and the treatment group(s), where the treatment group can consist of one or more variations. These can be configured in the dashboard, and you can learn more about managing test groups in the A/B Test Settings document.

Variation

By passing an experiment key and user to the Variation() method, you can distribute users and receive the results. Then, you implement the logic for each test group.

In the example code below, we are passing experiment key 42 and user identifier "ae2182e0." There are two test groups: A and B.

import "github.com/hackle-io/hackle-go-sdk/hackle"

// In an A/B test with experiment key 42,
// decide which test group to expose the user with identifier "ae2182e0."
// If no decision can be made, it returns test group A by default.
user := hackle.NewUserBuilder().ID("ae2182e0").Build()
variation := hackleClient.Variation(42, user)

// Implement logic for the assigned group
if variation == "A" {
  // Logic for group A
} else {
  // Logic for group B
}

VariationDetail

The VariationDetail() method functions the same as the Variation() method but additionally provides the reason for the specific group allocation. This method can be useful when examining whether distribution is functioning correctly.

You need to pass the experiment key as a parameter. In the example code below, we are passing experiment key 42.

import "github.com/hackle-io/hackle-go-sdk/hackle" 

// Detailed distribution decision
decision := hackleClient.VariationDetail(42, user)

// Assigned group
variation := decision.Variation()

// Distribution decision reason
reason := decision.Reason()

The distribution decision reason is received in a format like SDK_NOT_READY. You can refer to the table below for more details:

Parameters

• You can also receive the parameter values for the distributed group using the VariationDetail() method.
• Since Hackle's A/B test settings often include parameters in the form of key-value pairs, you can use the following methods to access and utilize these parameter values based on their types:

GetString

• Returns the parameter value set as STRING or JSON in the group's configuration.
• Retrieves the configured value for the distributed group.

import "github.com/hackle-io/hackle-go-sdk/hackle"

decision := hackleClient.VariationDetail(42, user)
  
stringValue := decision.GetString("string_key", "default_value")
jsonValue := decision.GetString("json_key", "{}")

GetNumber

• Returns the parameter value set as a Number type as a float64.
• Retrieves the configured value for the distributed group.

import "github.com/hackle-io/hackle-go-sdk/hackle"

decision := hackleClient.VariationDetail(42, user)

number := decision.GetNumber("number_key", 42.0)

GetBool

• Returns the parameter value set as a boolean type.
• Retrieves the configured value for the distributed group.

import "github.com/hackle-io/hackle-go-sdk/hackle"

decision := hackleClient.VariationDetail(42, user)

boolValue := decision.GetBool("bool_key", false)