이 페이지에서

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.

기능 플래그 작성

Amplitude 아카데미

Amplitude를 사용하여 기능 플래그 및 롤아웃 관리

기능 플래그를 관리하고 이를 대상 고객에게 릴리스하는 방법을 알아보십시오. Amplitude를 사용하여 제품 기능을 생성, 롤아웃, 모니터링 및 롤백할 수 있습니다.

시작하기

Amplitude 실험에서 플래그는 코드를 재롤아웃하지 않고도 제품의 기능이나 특징을 활성화하거나 비활성화합니다. 플래그는 실험과 기능 롤아웃을 모두 촉진합니다. 플래그를 사용하여 실험을 시작하고 충분한 데이터를 수집한 후 실험을 종료하거나, 새로운 기능을 출시한 후 필요할 때 신속하게 롤백할 수 있습니다.

Amplitude는 모든 요금제의 사용자에게 이 기능을 제공합니다.

이 문서에서는 기능 롤아웃을 위한 플래그를 만드는 방법을 설명합니다. 실험에서 플래그를 사용하는 방법에 대한 자세한 내용은 사용자에게 실험 롤아웃을 참조하십시오.

Optimizely에서 플래그 마이그레이션

Optimizely에서 Amplitude로 플래그를 마이그레이션하십시오. 프로세스를 시작하려면 Amplitude 담당자 또는 Amplitude 고객지원에 문의하십시오.

새 플래그 만들기

플래그를 생성하기 전에 롤아웃을 생성하고 SDK를 설치하거나 평가 REST API를 구성하십시오. 그런 다음 다음 단계를 수행하십시오.

  1. 왼쪽 사이드바에서 실험 > 기능 플래그로 이동한 다음 기능 플래그 만들기를 클릭합니다.
  2. 플래그 만들기 모달의 프로젝트 드롭다운 메뉴에서 이 플래그에 대한 프로젝트를 선택합니다. 플래그의 이름을 입력하십시오. 실험은 이름에서 플래그 키를 생성합니다. 플래그 키는 코드베이스의 플래그를 식별합니다.
  3. 실험의 평가 모드를 원격(Amplitude는 Amplitude 서버의 플래그를 평가합니다) 또는 로컬로 지정하십시오. 그런 다음 이 실험의 버킷 단위를 지정합니다.

가장 효율적인 버킷 설정 단위는 일반적으로 사용자입니다. 일부 B2B 사용 사례에서는 회사 ID 또는 도시를 버킷 설정 단위로 사용할 수 있습니다. 예를 들어 회사 ID별로 버킷화하면 회사의 모든 사용자가 동일한 경험을 할 수 있습니다. 선택한 단위에 대해 안정적인 단위 처리 값 가정이 적용되는지 확인합니다.

  1. 생성을 클릭합니다. 실험을 통해 플래그에 대한 빈 템플릿이 열립니다.
  2. 롤아웃 드롭다운 메뉴에서 실험에 사용할 롤아웃을 선택합니다. 롤아웃에 대한 자세한 내용은 Amplitude 실험 구성을 참조하십시오.
  3. 고급 설정을 클릭하여 버킷 솔트를 변경합니다.

버킷 솔트를 변경하면 사용자가 실험에서 변형 간에 전환할 수 있습니다. Amplitude는 지침 없이 버킷 솔트를 변경하지 말 것을 권장합니다. 자세한 내용은 Amplitude 실험에서 무작위화가 작동하는 방식을 참조하십시오.

  1. 설정 섹션의 변형 섹션에서 추가 아이콘을 클릭하여 변형을 추가합니다. 플래그는 하나 이상의 변형을 가져야 합니다. 변형은 사용자가 사용할 수 있도록 롤아웃하는 새로운 기능이나 제품 경험입니다. 기능 플래그에 필요한 만큼 변형을 추가할 수 있습니다.
  2. 변형에 대한 이름, 값 및 설명을 입력합니다. Amplitude 실험은 이름으로부터 변형 값을 생성합니다. 변형 값은 코드베이스에서 플래그로 사용하는 문자열입니다. 적용을 클릭합니다.

변형에 이름을 지정하지 마십시오 OFF. Amplitude 실험에서는 이 이름을 대체용으로 예약합니다(예: 실험에 포함되지 않은 사용자 세그먼트).

새로운 기능 출시

플래그를 생성한 후 이를 사용하여 새 기능을 롤아웃하십시오.

  1. 할당 패널에서 새 기능을 수신할 사용자 세그먼트를 정의하고 롤아웃 비율을 지정합니다.

    사용자 세그먼트를 정의하여 특정 지리적 위치에 있는 사용자, 특정 인구통계 그룹의 사용자 또는 특정 사용 임계값을 충족하는 사용자(예: 고급 사용자)로 롤아웃을 제한하십시오.

    사용자 세그먼트를 정의하려면 규칙 기반 사용자 세그먼트 섹션으로 스크롤하여 세그먼트 1을 클릭하십시오. Amplitude 애널리틱스에서 사용자 세그먼트를 구축하는 데 사용하는 것과 동일한 단계를 따르십시오.

    모든 Amplitude 사용자 속성과 코호트는 사용자 세그먼트를 정의하는 데 사용할 수 있습니다. 사용자 세그먼트를 전체 개수만큼 포함할 수 있습니다.

  2. 이 기능에 대한 롤아웃 비율을 설정합니다. 이 값은 플래그의 사용자 세그먼트에서 새 기능을 받는 사용자의 비율입니다. 사용자 세그먼트의 모든 사용자에게 액세스 권한을 부여하려면 이 값을 100%로 설정하십시오.

  3. 각 변형에 대한 백분율을 설정하여 각 변형을 수신하는 사용자 수를 정의합니다. 백분율의 합계는 100%여야 합니다. 예를 들어 변형 A를 20%로, 변형 B를 80%로 설정하면 변형 A를 수신하는 사용자보다 변형 B를 수신하는 사용자 수가 4회나 많습니다.

  4. 생성한 전체 세그먼트에 포함되지 않는 사용자에 대해 별도의 규칙을 설정하십시오. 예를 들어 목표로 설정한 코호트로 롤아웃을 제한하려면 기타 모든 사용자 섹션으로 이동한 다음 롤아웃 비율을 0으로 설정하십시오.

  5. 플래그를 활성으로 설정하기 전에 플래그를 저장하고 수행하십시오. 자세한 내용은 실험을 시작하기 전에 QA를 참조하십시오. 선택한 사용자 세그먼트에 기능이 활성화되었습니다.

이 내용이 도움이 되었나요?