For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.
플래그 전제 조건
새로운 실험을 실행하거나 새로운 기능 플래그를 롤아웃할 때 일부 기능은 다른 기능도 활성화된 경우에만 사용자에게 적용됩니다. 먼저 이러한 종속성을 평가한 다음 해당 결과를 플래그 또는 실험의 평가에 사용하십시오.
실험을 사용하면 필수 조건 플래그 또는 실험에 대한 플래그 및 실험의 종속성을 생성할 수 있습니다.
플랜 가용성
: 플래그 전제 조건은 Enterprise 고객에게만 제공됩니다. 조직이 다른 플랜을 사용 중인 경우 종속성 카드는 기능 플래그 구성 UI에 나타나지 않습니다. 자세한 내용을 확인하거나 업그레이드하려면 영업팀에 문의하십시오.
플래그 사전 요구 사항 구성
기능 플래그에 대한 종속성 카드의 플래그 전제 조건을 구성합니다. 실험 > 기능 플래그 > 해당 기능 플래그로 이동하여 종속성 카드로 스크롤하십시오.
이 카드는 해당 기능 플래그에 대한 모든 종속성을 요약합니다(필수 조건, 실험, 상호 제외 및 홀드아웃 그룹). 또한 이 카드에는 해당 항목에 의존하는 플래그와 실험도 나열되어 있습니다.
- 새 필수 조건을 구성하려면 편집 아이콘을 선택합니다.
- 종속성 추가를 선택하여 새 필수 조건 플래그 또는 실험을 추가합니다.
- 플래그 또는 실험 선택을 선택한 다음 원하는 항목을 선택합니다.
플래그 또는 실험은 다음과 같은 경우 전제 조건으로 간주됩니다.
- It's in the same project. - It has a compatible evaluation mode. Local evaluation mode flags and experiments can only have local evaluation mode prerequisites. Remote evaluation mode flags and experiments can have both remote and local prerequisites.
You can't add a prerequisite that creates a circular dependency loop.
- 플래그가 의존하는 변형을 선택합니다. 특수 변형인
Off은 필수 조건 플래그 또는 실험에서 제외된 사용자를 나타냅니다. - 저장을 선택합니다.
워크플로 고려 사항
플래그를 활성화하거나 실험을 시작하기 전에 필수 조건 플래그가 활성화되어 있고 변형 할당이 예상대로 작동하는지 확인하십시오. 필수 조건 플래그와 실험이 활성화될 때까지 실험을 시작할 수 없습니다.
플래그 및 종속성이 있는 실험의 경우 Amplitude는 다음 작업을 차단합니다.
- 다른 플래그 또는 실험이 변형에 의존하는 경우 변형을 삭제하거나 변형 키를 변경하는 작업.
- 해당 플래그 또는 실험을 보관합니다.
전제 조건 플래그가 있는 경우의 평가 작동 방식
이 예에서는 전제 조건 플래그가 있을 때 평가가 어떻게 작동하는지 보여줍니다.
예를 들어 새 기능 플래그(Flag-B)가 다른 기능(Flag-A)을 처음 본 사용자에게만 롤아웃되도록 하려는 경우가 있습니다. Flag-B에서는 Flag-A의 변형에 대한 종속성을 추가하고 두 플래그를 모두 활성화합니다.On
Amplitude가 사용자를 플래그-B에 대해 평가할 때:
Amplitude는 사용자가 Flag-B의 코호트에 속하는지 확인합니다.
- 사용자가 코호트에 속해 있는 경우 Amplitude는 구성된 변형을 제공합니다.
그런 다음 Amplitude는 사용자의 종속성을 평가합니다(이 경우 Flag-A).
- 사용자가 Flag-A에 대한
On변형을 수신하지 못하면 Amplitude는 해당 사용자를 Flag-B에서 제외합니다.
- 사용자가 Flag-A에 대한
그런 다음 Amplitude는 사용자를 Flag-B에 대해 평가합니다.
Flag-B에 대한 타겟팅은 사용자가 수신할 변형(있는 경우)을 결정합니다. Flag-A에 대한 플래그 의존성은 이 시점에서 아무런 영향을 미치지 않습니다.
사용자 속성 타겟팅과 비교한 전제 조건
플래그 전제 조건이나 [Experiment]사용자 속성을 기반으로 한 타겟팅 규칙을 사용하여 비슷한 결과를 얻을 수 있습니다. 이 두 접근법은 중요한 점에서 차이가 있습니다.
타겟팅에 [Experiment]사용자 속성 사용
Amplitude가 사용자를 플래그 또는 실험 변형에 할당할 때, Amplitude는 변형 키를 값으로 사용하는 형식으로 사용자 속성을 설정합니다[Experiment] <flag_key>. 다른 플래그의 타겟팅 규칙에서 이 사용자 속성을 참조하여 이전 할당을 기반으로 타겟팅할 수 있습니다.
예: on와 같은 경우 대상 사용자를 지정합니다.[Experiment] Flag-A
제한 사항
- 타이밍 문제: Amplitude는 할당 또는 노출 이벤트를 수집할 때
[Experiment]사용자 속성을 설정합니다. 속성을 데이터 동기화하기 전에 종속 플래그를 평가하면 사용자가 타겟팅 규칙과 일치하지 않을 수 있습니다. - 공식적인 종속성 추적 없음: UI는 플래그 대상 구간의 관계를 보여주지 않습니다. 어떤 플래그가 다른 플래그에 의존하는지 수동으로 추적해야 합니다.
- 잠재적 불일치: 속성 동기화와 플래그 평가 대상 구간의 경합 조건은 사용자에게 일관성 없는 경험을 줄 수 있습니다.
플래그 사용의 전제조건
플래그 전제 조건은 플래그 대상 구간의 종속성을 공식적으로 정의합니다. Flag-A를 Flag-B의 전제 조건으로 추가하면 Amplitude는 Flag-A를 먼저 평가하고 그 결과를 사용하여 Flag-B 적격성을 결정합니다.
장점:
- 함께 평가됨: Amplitude는 단일 평가 요청 다음 기간동안 전제 조건을 순서대로 평가하므로 타이밍 문제가 해결됩니다.
- 가시적 종속성: 종속성 카드는 모든 관계를 보여주므로 복잡한 플래그 계층 구조를 쉽게 관리할 수 있습니다.
- 일관된 버킷 설정: 전제 조건의 평가가 원자적으로 이루어지므로 사용자는 일관된 경험을 얻을 수 있습니다.
- 변경 사항 보호: Amplitude는 전제 조건 플래그를 보관하거나 다른 플래그가 의존하는 변형 키를 변경할 수 없도록 방지합니다.
각 접근법을 사용할 시기
| 활용 사례 | 권장되는 접근법 |
|---|---|
| 사용자를 플래그-B를 보게 되기 전에 플래그-A에 할당하십시오. | 플래그 전제조건 |
| 하위 기능을 포함한 릴리스 그룹 구축 | 플래그 전제조건 |
| 상호 배타적 실험 연쇄 | 플래그 전제조건 |
| 며칠 또는 몇 주 전에 플래그에 노출된 대상 사용자 | 사용자 속성 타겟팅 |
| 이전 플래그 노출에 따른 실험 결과 분석 | 사용자 속성 타겟팅 |
| 디버깅을 위해 임시 세그멘테이션 실행 | 사용자 속성 타겟팅 |
일반적인 활용 사례
플래그 전제 조건은 많은 사용 사례를 지원합니다. 일반적인 예는 다음과 같습니다.
릴리스 그룹
플래그 전제 조건을 사용하여 여러 하위 기능이 있는 주요 기능을 빌드합니다. 하위 기능의 코호트가 개별적으로 사용자를 포함하지 않는 한 하위 기능은 기본 기능이 필요합니다On. Amplitude는 기본 기능을 전제 조건으로 나열하는 모든 하위 기능에 기본 기능의 타겟팅 및 버킷팅을 적용합니다. 그렇지 않으면 기본 기능과 하위 기능을 수신하는 사용자가 일치하지 않습니다.
릴리즈 그룹의 일반적인 활용 사례:
- 많은 개발자와 팀에서 대규모 기능 릴리즈 타임라인을 적극적으로 개발합니다.
- 추가 기능을 사용하여 기본 SKU에 사용자를 프로비저닝합니다.
- 코드에서 기능 플래그 논리를 단순화합니다.
이 예제에는 플래그와 기본 기능을 전제 조건으로 나열하는 primary-feature플래그가 포함되어 있습니다sub-feature.
primary-feature이 플래그는 사용자 속성이 premium 인 모든 사용자를 100% 할당된 대상으로 true합니다. 하위 기능은 사용자에게 필요한 사용자 속성이 있고 하위 기능의 기준을 충족하는 경우에만 평가됩니다. 하위 기능에 개별적으로 사용자가 포함되는 경우는 예외이며, 이는 일반적으로 테스트 단계 중에 발생합니다.
sub-feature-1이 플래그는 사용자 속성이beta인 사용자에 대한 타겟팅 기준을 추가합니다true.sub-feature-1를 받으려면 사용자의premium및beta사용자 속성이 모두true와 같아야 합니다.sub-feature-2이 플래그는 사용자의 100%를 할당합니다. Amplitude는premium값이true와 같은 모든 사용자를 이 기능에 할당합니다.sub-feature-3이 플래그는 사용자의 0%를 할당합니다. Amplitude는premium가true인 경우에도 사용자를sub-feature-3에 할당하지 않습니다.
연쇄 상호 배제 그룹
플래그 전제 조건을 사용하여 서로 다른 회에 시작되는 상호 배타적 실험의 복잡한 계층 구조를 구축하십시오. 종속 실험은 off 을 평가하는 기존 활성 실험에 대한 전제 조건을 나열합니다. 이 규칙은 기존 실험에서 할당하지 않은 모든 사용자를 대상으로 합니다. 이전 실험에서 모든 사용자를 할당하지 못한 경우 이 체인을 계속하여 상호 배타적 실험을 더 추가하십시오.
이 예제에서 experiment-1 는 지금 실행되고, experiment-1 와 상호 배타적인 experiment-2 는 나중에 실행됩니다.
- 이
experiment-1실험은 사용자의 20%에게 50/50 대조군/실험군을 할당합니다. - 이
experiment-2실험은experiment-1을(를) 전제 조건으로 나열하고 사용자의 100%에게 50/50 대조군/실험군을 할당합니다.
실험에서는 사용자의 20%를 experiment-1에 할당하고 나머지 80%를 experiment-2에 할당합니다. 실험에서는 experiment-1및 experiment-2의 변형에 사용자를 할당하지 않습니다.
이 내용이 도움이 되었나요?