원격 구성 파라미터 설정하기

이 문서는 원격 구성의 상세 화면에서 파라미터를 설정하는 내용을 소개합니다.

상세 화면의 구성

원격 구성의 상세 화면에서는 다음과 같은 내용을 확인할 수 있습니다.

1300

파라미터 상세화면

  1. 파라미터 정보
    파라미터 생성시 입력한 파라미터 키를 확인할 수 있습니다.
    설명 영역을 클릭하여 파라미터 설명을 수정할 수 있습니다.

  2. 환경별 복사하기
    개발 <-> 운영 환경으로 파라미터와 설정된 정보를 모두 복사할 수 있습니다.

  3. 파라미터 보관하기
    사용하지 않는 파라미터 키를 보관할 수 있습니다. 단, 보관한 파라미터는 다시 활성화할 수 없습니다.

  4. 우측 상단 영역

  • 되돌리기 : 마지막 저장 시점으로 되돌릴 수 있습니다. 클릭시 이전에 입력했던 내용이 사라집니다.
  • 저장하기 : 저장하기 버튼을 클릭하여 변경사항을 저장하세요. 저장한 내용은 즉시 반영됩니다.
  1. 탭 메뉴
    원격 구성에 대한 메뉴를 탭으로 제공하고 있습니다. 기본적으로 이미지와 같이 파라미터 설정이 선택됩니다.
    (파라미터 설정, 실시간 현황, 변경 내역)

파라미터 설정

2422

파라미터 설정

  1. 파라미터 유형
    파라미터 생성시 선택한 파라미터 유형을 확인할 수 있으며, 변경하기 버튼을 통해 파라미터 유형을 변경할 수 있습니다. 단, 유형 변경시 입력해두었던 값은 초기화됩니다.

  2. 기본 값
    모든 사용자에게 적용할 값을 설정합니다. 타겟팅을 추가하지 않을 경우 기본 값이 반영됩니다.

  3. 타겟팅 추가하기
    타겟팅 추가하기를 클릭하여 사용자 타겟팅을 시작할 수 있습니다. 전체 사용자 중 해당 파라미터를 적용할 사용자에게 원하는 값을 적용해보세요.

사용자 타겟팅

규칙 및 조건의 구성

📘

중요!

규칙과 조건은 아래의 조합으로 구성될 수 있습니다.

(1) 속성명 + 연산자 + 속성값

(2) A/B 테스트 (기능 플래그) + 연산자 + A/B 테스트 그룹 (기능 플래그 상태 값)

(3) 타겟팅 그룹 + 연산자 + 사용자 그룹 키

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

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

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

속성명과 속성값

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

A/B 테스트 타겟팅

A/B 테스트를 타겟팅 조건으로 사용하여 원격 구성을 활용한 A/B 테스트를 할 수 있습니다. 이에 대한 자세한 내용은 원격 구성을 활용한 A/B 테스트 문서를 참고하세요.

연산자

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

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

연산자속성값 타입속성값 선택 가능 개수
다음 중 하나String복수 선택 가능
다음 중 하나가 아닌String복수 선택 가능
다음 중 하나로 시작하는 것String복수 선택 가능
다음 중 하나로 시작하지 않는 것String복수 선택 가능
다음 중 하나로 끝나는 것String복수 선택 가능
다음 중 하나로 끝나지 않는 것String복수 선택 가능
다음 중 하나를 포함하는 것String복수 선택 가능
다음 중 하나를 포함하지 않는 것String복수 선택 가능
=Number복수 선택 가능
Number복수 선택 가능
>=Number단일 항목 선택
<=Number단일 항목 선택
>Number단일 항목 선택
<Number단일 항목 선택
참일 경우Boolean선택 불가 (연산자에 속성값 '참'이 포함됨)
거짓일 경우Boolean선택 불가 (연산자에 속성값 '거짓'이 포함됨)
version =Version단일 항목 선택
version ≠Version단일 항목 선택
version >Version단일 항목 선택
version ≥Version단일 항목 선택
version <Version단일 항목 선택
version ≤Version단일 항목 선택

예시

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

👍

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

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

사용자 타겟팅 설정하기

2132

파라미터 사용자 타겟팅 설정하기

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

  1. 규칙명

  2. 속성명

  3. 연산자
    속성명이 갖는 타입을 고려하여 선택하시기 바랍니다.

  4. 속성값
    연산자에 따라 선택할 수 없는 경우도 있고 여러 개 선택할 수 있는 경우도 있습니다.

  5. 삭제
    규칙을 삭제합니다.

  6. + AND 조건 추가하기
    해당 버튼을 누르면 규칙에 조건을 1개 추가합니다.


  7. 타겟팅에 해당하는 사용자에게 적용할 값을 설정합니다.

  8. 규칙 추가하기
    해당 버튼을 누르면 새로운 규칙을 추가할 수 있습니다.

  9. 기본 값
    타겟팅에 해당되지 않는 나머지 사용자에게 적용할 값을 설정합니다.

📘

새로 추가된 규칙은 앞 규칙을 만족하지 않을 경우에 규칙 만족 여부를 확인합니다.

실시간 현황

최근 30분 이내에 원격 구성에 노출된 사용자 수와 해당 사용자의 정보(시간, 사용자 식별자 값, 할당된 값)를 최대 1,000 건까지 볼 수 있습니다. 30초 단위로 업데이트 버튼이 활성화되므로 보다 최신 상태를 알고 싶다면 해당 버튼을 눌러 갱신할 수 있습니다.

2456

규칙


  1. 기본 값 및 각 규칙에 설정한 값을 확인 할 수 있습니다.

  2. SDK 설정 기본 값
    정상적으로 분배되지 않은 경우, SDK 설정 기본 값이 노출됩니다. '규칙' 에서 오류 정보의 상세 내용을 확인할 수 있습니다.

변경 내역

원격 구성 변경 사항들이 시간 순으로 기록됩니다.
변경 내역을 통해 다른 협업자가 생성 및 수정한 아이템에 대한 내역을 확인할 수 있습니다.

2424

자세히 보기를 클릭하여 수정 전/후 내용의 디테일 확인이 가능합니다.

1774

보관하기

  • 해당 파라미터가 더 이상 필요하지 않은 경우 보관할 수 있습니다.
  • 활성 파라미터는 최대 20개까지 동시 사용 가능하므로 사용하지 않는 파라미터는 보관 처리하여 새로운 파라미터를 생성할 수 있습니다.

단, 한 번 보관한 파라미터는 다시 활성화 할 수 없으므로 신중하게 판단해주세요.

1492

파라미터 보관하기

2558

보관된 파라미터는 다시 활성화 하거나 수정할 수 없습니다.