기능 플래그
기능 플래그를 사용하면 특정 사용자나 무작위로 선택한 사용자에 대해 원격으로 기능을 활성화 또는 비활성화할 수 있습니다. 중요한 점은 추가 코드 배포나 앱 스토어 업데이트 없이 프로덕션 환경에서 기능을 켜고 끌 수 있다는 것입니다. 이를 통해 새로운 기능을 안심하고 안전하게 출시할 수 있습니다.

필수 조건
기능 플래그를 사용하려면 다음 최소 SDK 버전이 필요합니다:
사용 사례
점진적 출시
기능 플래그를 사용하여 일부 표본 사용자에게 기능을 점진적으로 활성화할 수 있습니다. 예를 들어 새 기능을 VIP 사용자에게 먼저 소프트 런칭할 수 있습니다. 이 전략은 새 기능을 모든 사용자에게 한 번에 출시할 때 따르는 위험을 줄이고 버그를 조기에 발견하는 데 도움이 됩니다.

예를 들어 더 빠른 고객 서비스를 위해 앱에 새로운 “Live Chat Support” 링크를 추가하기로 했다고 가정해 보겠습니다. 이 기능을 모든 고객에게 한 번에 출시할 수도 있습니다. 하지만 전체 출시에는 다음과 같은 위험이 따릅니다.
- 지원팀이 아직 교육 중인데, 출시 후에는 고객이 지원 티켓을 생성할 수 있습니다. 지원팀에 시간이 더 필요한 경우에도 여유가 없습니다.
- 실제로 새 지원 문의가 얼마나 들어올지 확실하지 않으므로 인력이 적절하게 배치되지 않을 수 있습니다.
- 지원팀이 감당하지 못할 정도가 되더라도 이 기능을 빠르게 다시 끌 수 있는 전략이 없습니다.
- 채팅 위젯에 버그가 생길 수 있으며, 고객이 부정적인 경험을 하는 것은 원하지 않습니다.
Braze 기능 플래그를 사용하면 대신 기능을 점진적으로 출시하여 이러한 위험을 모두 줄일 수 있습니다.
- 지원팀이 준비되었다고 하면 “Live Chat Support” 기능을 켭니다.
- 이 새 기능을 사용자의 10%에게만 활성화하여 인력이 적절하게 배치되어 있는지 판단합니다.
- 버그가 있으면 새 릴리스를 서둘러 배포하는 대신 기능을 빠르게 비활성화할 수 있습니다.
이 기능을 점진적으로 출시하려면 “Live Chat Widget”이라는 이름의 기능 플래그를 생성하면 됩니다.

앱 코드에서는 Braze 기능 플래그가 활성화된 경우에만 Start Live Chat 버튼을 표시합니다.
import {useState} from "react";
import * as braze from "@braze/web-sdk";
// Get the initial value from the Braze SDK
const featureFlag = braze.getFeatureFlag("enable_live_chat");
const [liveChatEnabled, setLiveChatEnabled] = useState(featureFlag.enabled);
// - Available in version 7.0.0+
// Listen for events from the Braze SDK
braze.subscribeToFeatureFlagsEvents((event) => {
switch (event.type) {
case braze.ChannelEventType.CACHE_REPLAY:
case braze.ChannelEventType.CACHE_LOAD:
case braze.ChannelEventType.DATA_UPDATED: {
const flag = event.cacheSnapshot.featureFlags.find((f) => f.id === "enable_live_chat");
setLiveChatEnabled(flag ? flag.enabled : false);
break;
}
case braze.ChannelEventType.ERROR:
if (event.reason === braze.ChannelErrorReason.FEATURE_DISABLED) {
setLiveChatEnabled(false);
}
break;
}
});
// Listen for updates from the Braze SDK
braze.subscribeToFeatureFlagsUpdates(() => {
const newValue = braze.getFeatureFlag("enable_live_chat").enabled;
setLiveChatEnabled(newValue);
});
// Only show the Live Chat if the Braze SDK determines it is enabled
return (<>
Need help? <button>Email Our Team</button>
{liveChatEnabled && <button>Start Live Chat</button>}
</>)
Web SDK 7.0.0 이상에서는 subscribeToFeatureFlagsEvents를 사용하세요. subscribeToFeatureFlagsUpdates는 이전 패턴이며 7.0.0부터 더 이상 사용되지 않습니다.
수신할 수 있는 전체 이벤트 목록은 기능 플래그 생성을 참조하세요.
// Get the initial value from the Braze SDK
FeatureFlag featureFlag = braze.getFeatureFlag("enable_live_chat");
Boolean liveChatEnabled = featureFlag != null && featureFlag.getEnabled();
// - Available in version 44.0.0+
// Listen for events from the Braze SDK
braze.subscribeToFeatureFlagsEvents(event -> {
if (event instanceof FeatureFlagsEvent.CacheReplay || event instanceof FeatureFlagsEvent.CacheLoad || event instanceof FeatureFlagsEvent.DataUpdated) {
FeatureFlag newFeatureFlag = braze.getFeatureFlag("enable_live_chat");
Boolean newValue = newFeatureFlag != null && newFeatureFlag.getEnabled();
liveChatEnabled = newValue;
} else if (event instanceof FeatureFlagsEvent.ErrorEvent) {
FeatureFlagsEvent.ErrorEvent errorEvent = (FeatureFlagsEvent.ErrorEvent) event;
if (errorEvent.getReason() instanceof ChannelErrorReason.FeatureDisabled) {
liveChatEnabled = false;
}
}
});
// Listen for updates from the Braze SDK
braze.subscribeToFeatureFlagsUpdates(event -> {
FeatureFlag newFeatureFlag = braze.getFeatureFlag("enable_live_chat");
Boolean newValue = newFeatureFlag != null && newFeatureFlag.getEnabled();
liveChatEnabled = newValue;
});
// Only show the Live Chat view if the Braze SDK determines it is enabled
if (liveChatEnabled) {
liveChatView.setVisibility(View.VISIBLE);
} else {
liveChatView.setVisibility(View.GONE);
}
Android SDK 44.0.0 이상에서는 subscribeToFeatureFlagsEvents를 사용하세요. subscribeToFeatureFlagsUpdates는 이전 패턴이며 44.0.0부터 더 이상 사용되지 않습니다.
// Get the initial value from the Braze SDK
val featureFlag = braze.getFeatureFlag("enable_live_chat")
var liveChatEnabled = featureFlag?.enabled
// - Available in version 44.0.0+
// Listen for events from the Braze SDK
braze.subscribeToFeatureFlagsEvents { event ->
when (event) {
is FeatureFlagsEvent.CacheReplay, is FeatureFlagsEvent.CacheLoad, is FeatureFlagsEvent.DataUpdated -> {
val newValue = braze.getFeatureFlag("enable_live_chat")?.enabled
liveChatEnabled = newValue
}
is FeatureFlagsEvent.ErrorEvent -> {
if (event.reason is ChannelErrorReason.FeatureDisabled) {
liveChatEnabled = false
}
}
else -> {}
}
}
// Listen for updates from the Braze SDK
braze.subscribeToFeatureFlagsUpdates {
val newValue = braze.getFeatureFlag("enable_live_chat")?.enabled
liveChatEnabled = newValue
}
// Only show the Live Chat view if the Braze SDK determines it is enabled
if (liveChatEnabled) {
liveChatView.visibility = View.VISIBLE
} else {
liveChatView.visibility = View.GONE
}
Android SDK 44.0.0 이상에서는 subscribeToFeatureFlagsEvents를 사용하세요. subscribeToFeatureFlagsUpdates는 이전 패턴이며 44.0.0부터 더 이상 사용되지 않습니다.

braze.featureFlags.featureFlags 또는 braze.featureFlags.featureFlag(id:)를 읽으면 SDK가 초기화 후 작업을 완료할 때까지 호출 스레드가 차단됩니다. 메인 스레드나 지연 시간에 민감한 컨텍스트에서는 대신 getAllFeatureFlags(_:)를 사용하세요.
// Non-blocking — completion handler always delivers on the main thread.
braze.featureFlags.getAllFeatureFlags { flags in
let liveChatEnabled = flags.first(where: { $0.id == "enable_live_chat" })?.enabled ?? false
liveChatView.isHidden = !liveChatEnabled
}
Objective-C의 경우:
[braze.featureFlags getAllFeatureFlagsWithCompletion:^(NSArray<BRZFeatureFlag *> *flags) {
// Use `flags` here.
}];
// Get the initial value from the Braze SDK
let featureFlag = braze.featureFlags.featureFlag(id: "enable_live_chat")
var liveChatEnabled = featureFlag?.enabled ?? false
// - Available in version 19.0.0+
// Listen for events from the Braze SDK
let cancellable = braze.featureFlags.subscribeToEvents { event in
switch event {
case .cacheReplay, .cacheLoad, .dataUpdated:
let newValue = braze.featureFlags.featureFlag(id: "enable_live_chat")?.enabled ?? false
liveChatEnabled = newValue
default:
break
}
}
// Listen for updates from the Braze SDK
let cancellable = braze.featureFlags.subscribeToUpdates { _ in
let newValue = braze.featureFlags.featureFlag(id: "enable_live_chat")?.enabled ?? false
liveChatEnabled = newValue
}
// Only show the Live Chat view if the Braze SDK determines it is enabled
liveChatView.isHidden = !liveChatEnabled
Swift SDK 19.0.0 이상에서는 subscribeToEvents(_:)를 사용하세요. subscribeToUpdates(_:)는 이전 패턴이며 19.0.0부터 더 이상 사용되지 않습니다.
각 이벤트가 발생하는 시점과 각 업데이트 사유, 재시도 상태, 분석 액션, 오류 사유의 의미는 이벤트 구독을 참조하세요.
앱 변수 원격 제어
기능 플래그를 사용하여 프로덕션 환경에서 앱의 기능을 수정할 수 있습니다. 이는 앱 스토어 승인 때문에 모든 사용자에게 변경 사항을 빠르게 출시하기 어려운 모바일 앱에서 특히 중요할 수 있습니다.
예를 들어 마케팅팀이 앱 내비게이션에 현재 진행 중인 세일과 프로모션을 표시하고 싶어 한다고 가정해 보겠습니다. 보통 엔지니어는 모든 변경 사항에 일주일의 준비 기간이 필요하고, 앱 스토어 심사에는 3일이 걸립니다. 하지만 추수감사절, 블랙 프라이데이, 사이버 먼데이, 하누카, 크리스마스, 새해 첫날이 모두 두 달 안에 몰려 있어서 이렇게 촉박한 마감일을 맞출 수 없습니다.
기능 플래그를 사용하면 Braze가 앱 내비게이션 링크의 콘텐츠를 제어하도록 하여, 마케팅 매니저가 며칠이 아닌 몇 분 만에 변경할 수 있습니다.
이 기능을 원격으로 구성하려면 navigation_promo_link라는 새 기능 플래그를 생성하고 다음과 같은 초기 속성정보를 정의합니다.

앱에서는 Braze의 getter 메서드를 사용하여 이 기능 플래그의 속성정보를 가져오고, 그 값을 바탕으로 내비게이션 링크를 구성합니다.
import * as braze from "@braze/web-sdk";
import {useState} from "react";
const featureFlag = braze.getFeatureFlag("navigation_promo_link");
// Check if the feature flag is enabled
const [promoEnabled, setPromoEnabled] = useState(featureFlag.enabled);
// Read the "link" property
const [promoLink, setPromoLink] = useState(featureFlag.getStringProperty("link"));
// Read the "text" property
const [promoText, setPromoText] = useState(featureFlag.getStringProperty("text"));
return (<>
<div>
<a href="/">Home</a>
{ promoEnabled && <a href={promoLink}>{promoText}</a> }
<a href="/products">Products</a>
<a href="/categories">Categories
</div>
</>)
// liveChatView is the View container for the Live Chat UI
FeatureFlag featureFlag = braze.getFeatureFlag("navigation_promo_link");
if (featureFlag != null && featureFlag.getEnabled()) {
liveChatView.setVisibility(View.VISIBLE);
} else {
liveChatView.setVisibility(View.GONE);
}
liveChatView.setPromoLink(featureFlag.getStringProperty("link"));
liveChatView.setPromoText(featureFlag.getStringProperty("text"));
// liveChatView is the View container for the Live Chat UI
val featureFlag = braze.getFeatureFlag("navigation_promo_link")
if (featureFlag?.enabled == true) {
liveChatView.visibility = View.VISIBLE
} else {
liveChatView.visibility = View.GONE
}
liveChatView.promoLink = featureFlag?.getStringProperty("link")
liveChatView.promoText = featureFlag?.getStringProperty("text")
let featureFlag = braze.featureFlags.featureFlag(id: "navigation_promo_link")
if let featureFlag {
liveChatView.isHidden = !featureFlag.enabled
} else {
liveChatView.isHidden = true
}
liveChatView.promoLink = featureFlag?.stringProperty(key: "link")
liveChatView.promoText = featureFlag?.stringProperty(key: "text")
이제 추수감사절 전날에는 Braze 대시보드에서 해당 속성정보 값만 변경하면 됩니다.

그 결과, 다음에 누군가 앱을 로드하면 새로운 추수감사절 특가를 보게 됩니다.
메시지 조율
기능 플래그를 사용하여 기능 출시와 메시징을 동기화하고 제품팀과 마케팅팀 간의 협업을 강화할 수 있습니다. 기능 플래그로 기능 릴리스와 메시징을 조율하면 두 팀이 전략을 맞추고 일관된 사용자 경험을 만들 수 있습니다.
예를 들어 사용자를 위한 새로운 로열티 리워드 프로그램을 출시한다고 가정해 보겠습니다. 마케팅팀과 제품팀이 프로모션 메시지의 타이밍을 기능 출시와 완벽하게 맞추기는 어려울 수 있습니다. 하지만 Canvas의 기능 플래그를 사용하면 제품팀은 정교한 로직을 적용하여 특정 오디언스에게 기능을 활성화하고, 마케팅팀은 같은 사용자에게 보내는 관련 메시징을 제어할 수 있습니다.
기능 출시와 메시징을 효과적으로 조율하기 위해 show_loyalty_program이라는 새 기능 플래그를 생성합니다. 초기 단계적 릴리스에서는 기능 플래그를 언제, 누구에게 활성화할지 Canvas가 제어하도록 합니다. 지금은 출시 비율을 0%로 두고 타겟 Segment를 선택하지 않습니다.

그런 다음 Canvas에서 “High Value Customers” Segment에 대해 show_loyalty_program 기능 플래그를 활성화하는 기능 플래그 단계를 생성합니다.

이제 이 Segment의 사용자에게 새 로열티 프로그램이 표시되기 시작하고, 기능이 활성화된 후에는 팀이 피드백을 수집할 수 있도록 이메일과 설문조사가 자동으로 발송됩니다.
기능 실험
기능 플래그를 사용하여 새 기능에 대한 가설을 실험하고 확인할 수 있습니다. 트래픽을 두 개 이상의 그룹으로 나누면 그룹 간 기능 플래그의 영향을 비교하고, 결과에 따라 최선의 조치를 결정할 수 있습니다.
기능 플래그 실험에서는 최대 9개의 그룹, 즉 대조군 1개와 최대 8개의 배리언트를 사용할 수 있습니다.
A/B 테스트는 변수의 여러 버전에 대한 사용자 반응을 비교하는 강력한 도구입니다.
이 예시에서는 팀이 이커머스 앱을 위한 새로운 결제 흐름을 구축했습니다. 사용자 경험이 개선되고 있다고 확신하지만, 앱 매출에 미치는 영향을 측정하기 위해 A/B 테스트를 실행하려고 합니다.
먼저 enable_checkout_v2라는 새 기능 플래그를 생성합니다. 오디언스나 출시 비율은 추가하지 않습니다. 대신 기능 플래그 실험을 사용하여 트래픽을 분할하고, 기능을 활성화하고, 성과를 측정합니다.
앱에서는 기능 플래그가 활성화되어 있는지 확인하고 응답에 따라 결제 흐름을 교체합니다.
import * as braze from "@braze/web-sdk";
const featureFlag = braze.getFeatureFlag("enable_checkout_v2");
braze.logFeatureFlagImpression("enable_checkout_v2");
if (featureFlag?.enabled) {
return <NewCheckoutFlow />
} else {
return <OldCheckoutFlow />
}
FeatureFlag featureFlag = braze.getFeatureFlag("enable_checkout_v2");
braze.logFeatureFlagImpression("enable_checkout_v2");
if (featureFlag != null && featureFlag.getEnabled()) {
return new NewCheckoutFlow();
} else {
return new OldCheckoutFlow();
}
val featureFlag = braze.getFeatureFlag("enable_checkout_v2")
braze.logFeatureFlagImpression("enable_checkout_v2")
if (featureFlag?.enabled == true) {
return NewCheckoutFlow()
} else {
return OldCheckoutFlow()
}
let featureFlag = braze.featureFlags.featureFlag(id: "enable_checkout_v2")
braze.featureFlags.logFeatureFlagImpression(id: "enable_checkout_v2")
if let featureFlag, featureFlag.enabled {
return NewCheckoutFlow()
} else {
return OldCheckoutFlow()
}
A/B 테스트는 기능 플래그 실험에서 설정합니다.
이제 사용자의 50%는 기존 경험을, 나머지 50%는 새로운 경험을 보게 됩니다. 그런 다음 두 배리언트를 분석하여 어떤 결제 흐름의 전환율이 더 높았는지 판단할 수 있습니다.
전환율은 메시지의 전체 수신자 대비 정의된 이벤트가 발생한 횟수의 백분율입니다. 이 정의된 이벤트는 Campaign을 구축할 때 결정됩니다.

위너를 결정하면 이 Campaign을 중지하고 기능 플래그의 출시 비율을 모든 사용자 대상 100%로 높일 수 있으며, 그동안 엔지니어링 팀은 다음 앱 릴리스에 이 기능을 하드코딩합니다.
세분화
기능 플래그 필터를 사용하면 사용자에게 기능 플래그가 활성화되어 있는지 여부를 기준으로 Segment를 생성하거나 메시지를 타겟팅할 수 있습니다. 예를 들어 앱의 프리미엄 콘텐츠를 제어하는 기능 플래그가 있다고 가정해 보겠습니다. 기능 플래그가 활성화되지 않은 사용자를 필터링하는 Segment를 생성한 다음, 해당 Segment에 프리미엄 콘텐츠를 보려면 계정을 업그레이드하라고 권하는 메시지를 보낼 수 있습니다.
- Segment 또는 메시지 오디언스를 엽니다.
- 기능 플래그 필터를 추가합니다.
- 기능 플래그를 선택합니다.
- 기능 플래그가 활성화된 사용자를 포함하려면 비교 연산자를 is로, 활성화되지 않은 사용자를 포함하려면 is not으로 설정합니다.

Segment 필터링에 대한 자세한 내용은 Segment 생성을 참조하세요.

재귀적 Segment를 방지하기 위해 다른 기능 플래그를 참조하는 Segment는 생성할 수 없습니다.
요금제 제한
무료 및 유료 요금제의 기능 플래그 제한 사항은 다음과 같습니다.
| 기능 | 무료 버전 | 유료 버전 |
|---|---|---|
| 활성 기능 플래그 | 워크스페이스당 10개 | 워크스페이스당 110개 |
| 활성 Campaign 실험 | 워크스페이스당 1개 | 워크스페이스당 100개 |
| 기능 플래그 Canvas 단계 | 무제한 | 무제한 |
다음 중 하나라도 해당하는 기능 플래그는 활성 상태로 간주되며 한도에 포함됩니다.
- 출시 비율이 0%보다 큰 경우
- 활성 Canvas에서 사용 중인 경우
- 활성 실험에서 사용 중인 경우
동일한 기능 플래그가 여러 기준에 해당하더라도(예: Canvas에서 사용 중이면서 출시 비율이 50%인 경우) 한도에는 활성 기능 플래그 1개로만 계산됩니다.

기능 플래그 유료 버전을 구매하려면 Braze 계정 매니저에게 문의하거나 Braze 대시보드에서 업그레이드를 요청하세요.