실험 평가 API

실험 평가 API는 평가 API를 사용하여 원격 평가를 통해 사용자를 위해 변형 할당 데이터를 검색하거나, 플래그 API를 사용하여 로컬 평가 플래그를 다운로드합니다.

지역

인증

평가 API는 접두사 Api-Key가 붙은 Authorization 헤더에 설정된 배포 키를 사용하여 요청을 인증합니다. 예를 들어 Authorization: Api-Key <deployment_key>.

평가 API

GET /v1/vardata

평가 API를 사용하면 사용자의 변형 할당 데이터를 검색할 수 있습니다. 이 API를 호출하면 Amplitude는 [Experiment] Assignment 이벤트를 추적합니다.

평가 쿼리 매개 변수

평가 헤더

평가 응답

응답 본문은 플래그 키로 키가 지정된 JSON 객체입니다. 각 플래그 키의 값은 사용자에게 할당된 변형입니다. 각 변형 객체에는 다음 필드가 포함됩니다.

예를 들면 다음과 같습니다.

{
  "my-experiment": {
    "key": "treatment",
    "payload": { "price": 99.99, "discount": "25%" },
    "expKey": "exp-1",
    "evaluationId": "224681772811_1760563672659_3681"
  }
  // ...
}

{}

평가 응답 상태 코드

평가 사례

테이블의 필드를 설정한 다음 [전송]을 선택하여 브라우저에서 요청을 생성하거나 curl 명령을 복사하여 직접 요청을 실행하십시오.

1
2
3
curl --request GET \
  --url 'https://api.lab.amplitude.com/v1/vardata' \
  --header 'Authorization: Api-Key deployment_key'

플래그 API

GET /v1/flags

Flags API를 사용하면 로컬 평가를 위한 플래그 구성을 다운로드할 수 있습니다. Flags API를 사용하여 클라이언트측 로컬 평가 SDK를 initialFlags(으)로 부트스트랩하거나, 엣지 환경과 같은 외부 플래그 구성 스토리지를 사용하여 평가를 실행하십시오.

이 API에서 반환되는 데이터 모델은 플래그 및 실험에 대한 실험 API 관리 형식과 다릅니다. Flags API 형식은 평가를 지원하므로 실험 API 관리 형식보다 더 상세하고 사람이 읽기 어려워집니다.

플래그 쿼리 매개변수

플래그 헤더

플래그 응답

Flags API는 객체의 JSON 배열을 반환하며, 여기서 각 객체는 플래그 또는 실험을 나타냅니다. 예를 들어, 다음은 단일 플래그를 사용하는 기본 응답입니다.

[
  {
    "key": "example-flag",
    "metadata": {
      "deployed": true,
      "evaluationMode": "local",
      "flagType": "release",
      "flagVersion": 42
    },
    "segments": [
      {
        "metadata": {
          "segmentName": "All Other Users"
        },
        "variant": "off"
      }
    ],
    "variants": {
      "off": {
        "key": "off",
        "metadata": {
          "default": true
        }
      },
      "on": {
        "key": "on",
        "value": "on"
      }
    }
  }
]

응답 상태 코드에 플래그 지정