A/B 테스트를 진행할 때, 테스트 그룹을 대상으로 사용자를 분배하고 각 테스트 그룹에 해당하는 로직을 작성해야 합니다. 이 때 사용자 분배를 핵클 SDK를 통해 진행할 수 있습니다.

📘

테스트 그룹

테스트 그룹은 테스트 대상이 되는 기존안(대조군)과 개선안(실험군)을 의미하며, 개선안은 1개 이상일 수 있습니다. 대시보드에서 설정 가능하며, 테스트 그룹을 관리하는 방법에 대해서는 A/B 테스트 설정 문서를 참고하시기 바랍니다.

🚧

Unity Editor

Unity SDK는 Android, iOS SDK를 기반으로 동작합니다.
따라서, Unity Editor에서는 모두 그룹 A를 리턴합니다.

variation

Variation() 메소드에 실험 키를 전달하면 사용자를 분배하고 결과를 전달받을 수 있습니다. 이후 테스트 그룹 별 로직을 구현합니다.

아래 예제 코드에서는 실험 키 42를 전달하고 있으며, 테스트 그룹은 A와 B 두 개가 존재합니다.

// 실험 키가 42인 A/B 테스트에서 사용자에게 노출할 테스트 그룹을 결정합니다.
// 결정하지 못하는 상황인 경우 테스트 그룹 A를 반환합니다.
string variation = hackle.Variation(42);

// 할당받은 그룹에 대한 로직
if (variation == "A") {
  // 그룹 A 로직
} else if (variation == "B") {
  // 그룹 B 로직
}

variationDetail

VariationDetail() 메소드는 Variation() 메소드와 동일하게 동작하고 추가로 특정 그룹으로 분배된 사유를 같이 제공합니다. 이 메소드는 분배가 잘 되고 있는지 살펴볼 때 유용하게 사용할 수 있습니다.
파라미터로 실험 키를 전달해야 합니다. 아래 예제 코드의 경우 실험 키 42를 전달하고 있습니다.

// 분배 결정 상세
HackleDecision decision = hackle.VariationDetail(42);

// 분배 그룹
string variation = decision.variation;

// 분배 결정 사유
string reason = decision.reason;

분배 결정 사유는 SDK_NOT_READY 와 같은 형태로 받게 됩니다. 자세한 내용은 아래 표를 참고해주세요.

파라미터

• VariationDetail() 메소드를 통해 분배된 그룹의 파라미터 값도 같이 제공받을 수 있습니다.
• GetBoolean() GetDouble() GetInt() GetLong() GetString() 메소드를 통해 A/B 테스트 화면에서 설정한 파라미터 설정 값을 받아 활용할 수 있으며 A/B 테스트의 파라미터 설정 화면에서 값을 변경할 경우, 변경된 값이 코드에 적용됩니다.
• 핵클의 A/B 테스트 화면에서 설정한 파라미터 값이 key, value 형태로 존재하기 때문에, 설정한 파라미터 유형에 따라 아래 메소드를 사용하여 설정한 파라미터 값을 받아 활용할 수 있습니다.

📘

파라미터 설정은 SDK 버전 1.3.0 이상인 경우 사용 가능합니다.

GetString

• STRING, JSON 유형으로 설정된 parameter값을 반환합니다.
• 분배된 그룹의 설정된 값을 반환합니다.

HackleDecision decision = hackle.VariationDetail(42);

string strValue = decsision.GetString("parameter_key_string_type", "defaultValue");
string jsonValue = decsision.GetString("parameter_key_json_type", "{}");

GetInt

• Number 유형으로 설정된 parameter 값을 Int 타입으로 반환합니다.
• 분배된 그룹의 설정된 값을 반환합니다.

HackleDecision decision = hackle.VariationDetail(42);

int intValue = decsision.GetInt("parameter_key_number_type", 0);

GetDouble

• Number 유형으로 설정된 parameter 값을 Double 타입으로 반환합니다.
• 분배된 그룹의 설정된 값을 반환합니다.

HackleDecision decision = hackle.VariationDetail(42);

double doubleValue = decsision.GetDouble("parameter_key_number_type", 0.0);

GetLong

• Number 유형으로 설정된 parameter 값을 Long 타입으로 반환합니다.
• 분배된 그룹의 설정된 값을 반환합니다.

HackleDecision decision = hackle.VariationDetail(42);

long longValue = decsision.GetLong("parameter_key_number_type", 0);

GetBoolean

• Boolean 유형으로 설정된 parameter값을 반환합니다.
• 분배된 그룹의 설정된 값을 반환합니다.

HackleDecision decision = hackle.VariationDetail(42);

bool boolValue = decsision.GetBoolean("parameter_key_boolean_type", false);