개요

사용자 타겟팅은 특정 속성을 가진 사용자에게 기능 플래그 상태 값을 적용하는 기능입니다. 예를 들어 모바일 운영체제 중 안드로이드를 사용하는 모든 사용자에게 기능 플래그를 적용하는 것이 가능합니다.

단, 개별 타겟팅 대상이 된 사용자는 사용자 타겟팅 대상이 될 수 없습니다.

📘

사용자 타겟팅 기능을 사용하려면

SDK 조건 확인

• 지원 대상: Android, iOS, JavaScript, React, React Native, Java/Kotlin, Python, Node.js
• 지원 버전: iOS 및 React Native는 2.0.0 이상, 그 외는 2.1.0 이상
• SDK에서 제공하는 기능과 버전에 대한 보다 자세한 내용은 SDK 문서를 참고 바랍니다.

요금제 확인

• 프로 플랜 이상의 유료 요금제인 경우 사용할 수 있습니다.

정책

1. 설정 가능 시점
   언제든지 설정하거나 설정을 변경할 수 있습니다.
   다만 기능 플래그가 켜짐 상태일 때 설정할 경우 저장 즉시 해당 사용자에게 적용되는 점을 유의하세요.

2. 기본값
   규칙 없음이 기본값입니다. 이는 개별 타겟팅 대상을 제외한 모든 사용자가 트래픽 할당 대상이 됨을 의미합니다.

3. 환경
   운영 환경 및 개발 환경에서 설정할 수 있습니다.

4. 규칙
   특정 사용자로 타겟을 제한하고자 할 경우, 최소 1개의 규칙이 필요합니다.
   타겟에 대한 규칙은 최대 10개를 가질 수 있습니다. 각 규칙은 독립적입니다. 따라서 해당 규칙 중 하나만 만족하면 타겟이 됩니다.
   예를 들어 신상품을 구매한 소비자를 타겟으로 정한다고 한다면 "'신상품' 카테고리에 속한 상품을 구매한 사용자" 라는 규칙과 "상품명에 '신상'이 들어가는 상품을 구매한 사용자"라는 규칙을 정하고, 이 중 하나만 만족하면 타겟이 되도록 설정할 수 있습니다.

5. 조건
   규칙은 생성과 동시에 1개의 조건을 가지며, 최대 10개의 조건을 가질 수 있습니다.
   각 조건은 논리연산자 AND의 피연산자입니다. 따라서 해당 조건을 모두 만족하는 경우에 타겟이 됩니다.
   예를 들어 모바일 운영체제 중 안드로이드 사용자이면서 연령대가 30대인 사용자를 타겟으로 한다면 "모바일 운영체제가 안드로이드인 사용자" 라는 조건과 "연령대가 30대인 사용자" 라는 조건을 모두 만족해야 합니다.

6. 속성
   조건은 속성을 기반으로 동작합니다. 따라서 속성을 지원하는 핵클 SDK를 연동하고 최소한 타겟 규칙에 정의한 사용자의 속성을 수집할 수 있어야 합니다.
   속성에 대한 자세한 내용은 속성 문서를 참고하세요.

규칙 및 조건의 구성

📘

중요!

규칙과 조건은 모두 속성명 + 연산자 + 속성값의 조합으로 구성됩니다.

예를 들어 사용자의 운영체제를 osName이라는 속성명으로 수집하고 있던 상황에서 모바일 운영체제 중 안드로이드 사용자를 타겟으로 설정하고 싶은 경우 아래와 같은 조합을 만들 수 있습니다.

• 속성명: osName
• 연산자: 다음 중 하나
• 속성값: Android, android

최초로 만들어진 조합은 첫 번째 규칙이 됩니다.

속성명과 속성값

속성에 대한 자세한 내용은 속성 문서를 참고하세요.

연산자

연산자는 조건을 설정할 때 사용되며, 속성명과 속성값의 관계를 설명하는 역할을 합니다.
핵클은 총 16가지의 연산자를 제공하며, 선택한 속성명이 갖는 속성값의 타입에 따라 적절한 연산자를 선택해야 합니다.

보다 자세한 내용은 아래 표를 참고하세요.

예시

광역시에 거주하는 사용자를 타겟으로 하고 싶다면 여섯 개의 광역시 중 한 곳에 거주하면 되므로 다음과 같이 규칙을 정의할 수 있습니다.

👍

[광역시에 거주하는 사용자] 규칙 만들기

• 속성: 거주지 (해당 속성의 속성명은 residence, 속성값 타입은 String이라고 가정)
• 연산자: 다음 중 하나
• 연산자에서 말하는 '다음'에 들어갈 속성값: "인천광역시", "대전광역시", "대구광역시", "울산광역시", "부산광역시", "광주광역시"

대시보드에서 타겟 설정하기

기능 플래그 상세 화면의 사용자 타겟팅 영역의 오른쪽 하단에 설정하기 버튼이 있습니다.
이 버튼을 눌러 타겟 설정 혹은 이미 설정한 내용을 수정할 수 있습니다.

최초 설정인 경우 첫 번째 규칙의 첫 번째 조건과 나머지 트래픽을 설정할 수 있습니다.

설정할 때 입력 혹은 선택할 값 및 각 버튼의 설명은 다음과 같습니다.

1. 속성명
2. 연산자. 속성명이 갖는 타입을 고려하여 선택하시기 바랍니다.
3. 속성값. 연산자에 따라 선택할 수 없는 경우도 있고 여러 개 선택할 수 있는 경우도 있습니다.
4. 규칙을 삭제합니다.
5. 조건을 추가합니다. 해당 버튼을 누르면 규칙에 조건을 1개 추가합니다.
6. 규칙의 상태를 설정할 수 있습니다. 켜짐, 꺼짐, 비율 직접 설정의 세 가지 선택지가 있습니다.
7. 규칙을 추가합니다. 해당 버튼을 누르면 새로운 규칙을 추가할 수 있습니다.
8. 규칙에 해당되지 않는 나머지 사용자의 비율을 설정합니다.

아래 스크린샷을 통해 + 규칙 추가하기를 누른 후 새로 생성된 규칙에서 + AND 조건 추가하기 버튼을 누른 예시를 확인할 수 있습니다.

새로 추가된 규칙은 앞 규칙을 만족하지 않을 경우에 규칙 만족 여부를 확인하기 때문에 else if 라는 타이틀이 붙습니다.
위 스크린샷의 번호에 대한 설명은 다음과 같습니다.

1. 규칙이 2개 이상인 경우 순서를 변경할 수 있습니다. 규칙명 왼쪽의 아이콘을 이용합니다.
2. 조건을 추가합니다.
3. 3번의 버튼을 이용해서 조건을 추가할 경우, 이와 같이 조건을 입력할 수 있는 한 줄이 추가됩니다.
4. 규칙의 조건을 모두 만족하는 대상 중 설정한 비율의 대상에게만 기능 플래그를 적용합니다. 이 경우는 100%의 대상자에게 기능 플래그를 적용합니다.

앞서 언급한 바와 같이, 규칙은 최대 10개의 조건을 가질 수 있으며, 타겟팅은 최대 10개의 규칙을 가질 수 있습니다.
테스트 생성에 필요한 정보를 입력하고 타겟팅 설정을 마쳤다면 저장하기 버튼을 눌러 설정을 완료합니다.

대시보드에서 설정 보기

기능 플래그 상세 화면의 사용자 타겟팅 영역에서 설정 정보를 볼 수 있습니다.

타겟 미설정 (규칙 없음)

타겟을 설정하지 않은 경우, 즉 규칙이 없는 경우는 개별 타겟팅 대상이 된 사용자를 제외한 모든 사용자가 트래픽 할당 대상이 됩니다.

①에서 설정된 규칙이 없음을 알려주고 있습니다.
②에서 규칙 예시를 볼 수 있습니다. 이는 실제 규칙이 아니며 규칙을 설정할 경우 이런 식으로 보인다는 것을 보여주는 사례입니다.
③의 설정하기 버튼을 통해 타겟 설정을 할 수 있습니다.

타겟 설정 (규칙 1개 이상)

타겟이 설정된 경우 1개 이상의 규칙을 갖고 있습니다. 아래 스크린샷에서 2개의 규칙을 설정한 사례를 확인할 수 있습니다.

①은 첫 번째 규칙을 의미합니다. 첫 번째 규칙에는 항상 if 타이틀이 붙습니다.
②와 같이 else if 타이틀이 붙은 경우 두 번째 혹은 그 이후 순번의 규칙을 의미합니다.
①, ② 모두 설정한 조건과 규칙의 상태를 확인할 수 있습니다.
③의 설정하기 버튼을 통해 타겟 설정을 변경할 수 있습니다.