Skip to main content
처리군은 트래픽의 고정된 비율 범위를 차지하고 나머지는 모두 대조군이 되므로, 할당을 늘려도 기존 사용자가 다른 그룹으로 이동하지 않습니다. Experiments API를 사용하여 초안을 생성하고, 가중치, 타기팅, 리소스 바인딩을 구성한 다음 활성화, 일시 중지 또는 종료하고, 사용자, 계정 또는 익명 방문자가 어떤 그룹에 배정되는지 평가할 수 있습니다. 실험을 관리하려면 experiment:read 또는 experiment:manage가 필요하며, 평가는 인증 없이 작동합니다.

엔드포인트

속성

string
필수
실험의 고유 식별자로, 접두사는 expt_입니다.
string
필수
소유 계정 ID입니다.
string
필수
배정은 UTF-8 시드 + 대상 ID를 CRC32로 해시한 값을 100으로 나눈 나머지로 계산하며, 저장된 범위(끝 미포함)를 선택합니다.
string | null
무작위 배정 단위입니다. user는 각 사용자를 독립적으로 버킷에 배정하고, account는 계정 전체를 버킷에 배정합니다(계정의 모든 사용자가 같은 그룹에 배정됨). 기능 플래그의 경우 null입니다.사용 가능한 옵션: user, account, anonymous
integer
필수
제공 구성의 리비전입니다. 구성이 변경될 때마다 증가하므로, 더 낮은 리비전의 캐시된 정의는 오래된 것입니다. 배정 시드는 변경되지 않습니다.
object
필수

속성

속성

string
필수
참조된 리소스 태그로, 실험 소유자에게 속합니다.
string
필수
사용 가능한 옵션: app, app_build, product, plan
string | null
실험이 생성된 시점으로, ISO 8601 타임스탬프입니다.
string | null
실험을 생성한 사용자의 ID로, 접두사는 user_입니다. 생성자가 기록되기 전에 생성된 실험은 null입니다.
string | null
실험이 데이터 수집을 중단한 시점으로, ISO 8601 타임스탬프입니다. 아직 실행 중이면 null입니다.
string | null
실험이 종료될 때 기록된, 얻은 교훈과 이 결과가 나온 이유입니다. 그 전까지는 null입니다.
string
필수
코드에서 참조하는 개발자 지정 핸들입니다. API가 실험 식별자를 받는 모든 곳에서 expt_ ID와 flag_key는 서로 바꿔 사용할 수 있습니다.
string | null
이 실험의 가설입니다. 설정되지 않은 경우 null이며, 기능 플래그는 항상 null입니다.
object
실험 생성 시 첨부된 키-값 쌍입니다. 설정되지 않은 경우 비어 있습니다.
string
필수
사람이 읽을 수 있는 표시 이름입니다.
이 실험이 바인딩된, 계정이 소유한 리소스입니다(예: 앱 또는 상품). 바인딩되지 않은 경우 null입니다. 실험이 처음 활성화되면 고정됩니다.

속성

string
필수
참조된 리소스 태그로, 실험 소유자에게 속합니다.
string
필수
사용 가능한 옵션: app, app_build, product, plan
string | null
실험이 데이터 수집을 시작한 시점으로, ISO 8601 타임스탬프입니다. 초안은 null입니다.
string
필수
수명 주기 상태입니다. draft는 아직 시작되지 않음, active는 현재 실행 중, paused는 트래픽 일시 중지, ended는 종료됨을 의미합니다.사용 가능한 옵션: draft, active, paused, ended
string | null
필수
object[]
필수
처리군입니다. 어떤 그룹의 할당에도 속하지 않는 사용자는 암묵적인 control 그룹을 형성합니다. 가중치는 증가하기만 하고 그룹은 절대 제거되지 않으므로, 사용자는 대조군에서 처리군으로 최대 한 번만 이동합니다.

속성

string
필수
처리군 식별자입니다. control은 예약되어 있으며, 암묵적인 나머지 그룹입니다.
integer[][]
이 그룹의 할당 이력을 기록하는 부여된 버킷 범위(1% 단위, 끝 미포함)입니다. 서버에서 관리하며, 범위는 추가되기만 하므로 배정이 영구적으로 유지됩니다.

속성

string
필수
참조된 리소스 태그로, 실험 소유자에게 속합니다.
string
필수
사용 가능한 옵션: app, app_build, product, plan
integer
필수
이 처리군에 배정된 전체 사용자 비율로, 1–100입니다. 모든 가중치의 합은 최대 100이며, 나머지는 대조군입니다.
string | null
실험이 종료될 때 설정되는 우승 처리군입니다. 설정되면 모든 평가는 타기팅이나 할당과 관계없이 모든 호출자에게 이 그룹을 반환하며, 더 이상 노출이 기록되지 않습니다. null은 대조군이 우승했음을 의미합니다. 우승 그룹이 없는 종료된 실험은 모든 사용자에게 control로 평가됩니다. 기능 플래그는 종료되면 단순히 비활성화로 평가되므로 항상 null입니다.
Experiment