파라미터 설정

개요

앱 개발자들은 새로운 기능을 만들고 출시할 때, 사용자들의 반응을 확인하고 또는 예상하지 못한 상황에 대비하여야 합니다. 기능 플래그의 파라미터를 활용하면, 사용자에게 유동적인 결과를 점진적으로 적용시킬 수 있습니다.

예를 들어 특정 문구에 대한 사용자의 반응을 보거나 피드백을 받고 싶은 경우, 사용자 그룹의 10%에게 해당 기능을 적용시키고, 유동적으로 바꾸고자 하는 문구의 파라미터를 설정할 수 있습니다. 설정한 파라미터 값을 변경하거나 트래픽을 조절하여 해당 기능의 성능과 반응을 확인하고, 전체 사용자에 대해 기능을 완전히 적용시킬 수 있습니다.

📘

파라미터 설정 사용 조건

SDK 조건

• 지원 대상: JavaScript, Android, iOS, React, React Native, Unity, Java/Kotlin, Node.js
• 지원 버전: iOS 및 Android는 2.9.0 이상, Javascript/React/Node.js는 11.7.3 이상, React Native 3.3.0 이상, Java/Kotlin 2.8.0 이상, Unity 1.3.0 이상
• SDK에서 제공하는 기능과 버전에 대한 보다 자세한 내용은 SDK 문서를 참고 바랍니다.

요금제 확인

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

예시

1. 공지 팝업, 프로모션 배너 정의
   
   기능 플래그의 파라미터를 활용하면 웹 페이지, 앱에서의 이벤트, 프로모션 배너 문구를 원하는 값을 설정하여 동적으로 노출시키고 변경시킬 수 있습니다.
   
   일회성 팝업이나 추천 유도 텍스트를 날짜별, 언어 별로 재노출 또는 변경한다고 가정할 때 우리는 사용자 타겟팅 규칙에 언어별로 사용자 그룹을 설정하고, 파라미터에 노출시키고자 하는 문구의 파라미터 키 (banner_text), 값(“배너 문구“) , 날짜의 파라미터 키 (“view_date”) , 값 (“2022-09-22”) 쌍을 설정할 수 있습니다.
   
   문구를 변경하고 싶다면 해당 파라미터의 값을 변경할 수 있으며, 특정 날짜가 지나 팝업을 더 이상 노출하고 싶지 않을때는 기능 플래그 상태를 꺼짐로 변경하여 설정한 기본 값(False)으로 되돌릴 수 있습니다.
   
   

2. 게임 내 제한된 유저 별 속성 적용 또는 기능 테스트
   
   게임 내에서 기능 플래그의 파라미터를 활용하면 불특정 다수에게 런타임시에 적용될 수 있는 콘텐츠들을 다양하게 컨트롤 할 수 있습니다. 일부 플레이어에게 특정 이벤트를 적용하거나, 아이템 획득률 변경, 게임 난이도 조절을 통해 게임 내 플레이어들에게 다양한 경험을 선사할 수 있습니다.
   
   예를 들어 게임 내 ‘특정 퀘스트 클리어시 보석 지급 유무’를 컨트롤하는 기능 플래그를 적용했다고 합시다. 이때 보석을 지급 받는 유저의 반응을 봤을 때 보석량이 너무 크거나 적어 보석량을 조절해야 하는 상황이 발생할 수 있습니다. 이 경우 보석량을 기능 플래그의 파라미터로 적용해둔 경우 앱 배포 없이 유동적으로 값을 변경하여 즉각적으로 게임에 반영할 수 있습니다. 이외에도 게임의 난이도, 아이템 획득률 등 게임 내 여러 속성, 설정 값에 대하여 기능을 테스트 하거나 수정 사항을 적용할 수 있습니다.

정책

1. 설정 가능 시점
   언제든지 설정하거나 설정을 변경할 수 있습니다.
   (단, 운영 환경의 기능 플래그가 켜짐 상태일 때는 파라미터를 삭제할 수 없습니다.)

2. 적용 시점
   기능 플래그 상태에 따라 저장시 변경 사항이 즉시 사용자에게 적용되는 점을 유의하세요.

• 기능 플래그가 꺼짐 상태일 때 False 값이 사용자에게 적용됩니다.
• 기능 플래그가 켜짐 상태일 때 전체 True, False 설정 사항이 사용자에게 적용됩니다.

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

대시보드에서 파라미터 설정하기

기능 플래그 상세 화면의 파라미터 설정 탭에서 설정이 가능합니다.
우측 상단의 저장하기 버튼을 클릭하여 변경사항을 저장하세요.

1. 파라미터 키
   파라미터 생성시 필수 항목으로 키 값은 알파벳, 숫자, _, -, . 만 입력 가능하며, 1~128자 사이의 길이 제한이 있습니다. 기능 플래그 내 이미 같은 이름으로 생성된 파라미터 키가 있다면 중복된 키 값으로는 파라미터를 설정할 수 없습니다.
   코드상에서 설정한 파라미터 키를 사용하여 기능플래그를 호출하면, 파라미터 값을 얻을 수 있습니다.

2. 파라미터 유형
   파라미터 유형을 선택하여 값을 설정할 수 있습니다. 현재 지원되는 유형은 다음과 같습니다.

• String
• Number
• Boolean
• JSON

3. 파라미터 값

• 설정하기
  선택한 파라미터 유형에 따라 [False]와 [True]에 각각 원하는 값을 설정할 수 있습니다.
  값은 자유롭게 수정이 가능하지만, 수정한 파라미터 값은 코드상에 즉시 반영됩니다.

• 수정하기
  [False] 우측의 수정하기 버튼을 클릭하여 파라미터 값을 수정할 수 있습니다.
  [False] 값의 수정 사항은 기능 플래그 상태에 상관없이 사용자에게 즉시 반영됩니다.

4. 파라미터 추가하기
   파라미터 추가하기를 클릭하여 파라미터를 최대 10개까지 추가할 수 있습니다.

🚧

한번 저장된 파라미터 키와 유형은 수정할 수 없습니다.

SDK 설정 방법

SDK를 설정하는 방법은 다음 문서를 참고하시기 바랍니다.

JavaScript →
React →
React Native
Node.js →
Java/Kotlin →
Android →
iOS →
Unity →