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 분석과 동일한 프로젝트를 사용합니다. 모범 사례로서 각 제품과 각 환경에 대해 프로젝트를 만드는 것이 좋습니다. 플래그, 실험 및 배치는 단일 프로젝트 내에만 존재하므로 동일한 제품에 대해 여러 프로젝트 간에 이러한 객체를 복제하십시오.
다른 프로젝트에 플래그 복사 실험을 통해 새 기능을 개발할 때는
개발 환경 프로젝트에서 실험을 생성하여 구현을 개발하고 테스트하십시오. 그런 다음 실험을 prod 프로젝트에 복사하여 prod에서 실험을 실행하십시오.
배포는 응용 프로그램에서 사용할 플래그 또는 실험 그룹을 제공합니다. 각 프로젝트에는 프로젝트 API 키를 배포 키로 사용하는 배포가 있으며, 이 키는 기본적으로 사용 가능합니다. Amplitude는 배포 키를 무작위로 생성합니다. 생성 시, Amplitude는 각 실험 배포에 관련 배포 키를 할당합니다. 실험은 배치 키를 사용하여 배치를 식별하고 평가 서버에 대한 요청을 승인합니다.
클라이언트 및 서버 배포
배포는 클라이언트 또는 서버 배포입니다. 클라이언트측 배포를 사용하여 클라이언트측 SDK를 초기화하고, 서버측 배포를 사용하여 서버측 SDK를 초기화하거나 평가 API에 대한 요청을 승인합니다.
배포
배포는 분석 프로젝트에 속하며, 하나의 프로젝트에 여러 배포가 있을 수 있습니다. 실험에서 변형을 제공하는 플랫폼(클라이언트측) 또는 서비스(서버측) 이름을 따서 배포에 이름을 지정합니다(예: android, ios, web). 기본 프로젝트 API 키 배포는 시작하는 데 유용합니다. 그러나 각 플랫폼이나 서비스에 대한 명시적 배포는 동일한 애플리케이션에 대해 여러 플랫폼에서 동일한 Amplitude 프로젝트를 공유하는 대규모 조직이나 팀에게 더 효과적입니다.
동일한 프로젝트의 플래그 및 실험에 배치를 추가합니다. 실험의 평가 서버가 사용자를 위해 변형을 가져오라는 요청을 받으면 실험은 배포 키를 사용하여 평가를 위해 관련된 모든 플래그와 실험을 조회합니다.
플래그 및 실험
실험은 기능 플래그와 실험을 사용하여 사용자에게 다양한 경험을 제공합니다. 플래그 키는 플래그와 실험을 식별합니다. 플래그와 실험은 0-n 배포와 연관되어 있으며 1-k 변형을 포함합니다. 평가 모드(로컬 또는 원격)는 플래그 또는 실험이 로컬 평가를 지원하는지 여부를 결정하며, 로컬 모드는 플래그의 타겟팅 기능을 제한할 수 있습니다.
기능 플래그와 실험은 동일한 기본 데이터 모델을 공유하므로 한 쪽에서 다른 쪽으로 소급적으로 마이그레이션할 수 있습니다. 가장 눈에 띄는 차이점은 제품 인터페이스에서 나타납니다. 실험은 실험 생애주기 분석을 안내하며 성공 지표를 정의하고 분석을 수행할 수 있도록 해줍니다. 플래그에는 더 기본적인 기능이 포함되어 있으며 특별한 계획 및 분석 섹션은 포함되어 있지 않습니다.
플래그
사용자 분석 없이 표준 피쳐 플래깅에 플래그를 사용하십시오. 새 플래그는 기본 변형인 on과 함께 제공됩니다.
플래그 사용 사례
- 일부 사용자(예: 베타 고객)에게 기능을 배포하는 작업.
- 행동 코호트(예: 고급 사용자)에 대한 다양한 경험.
실험
사용자에 대한 기능 실험을 위해 실험을 사용하십시오. 새로운 실험에는 두 가지 기본 변형인 control 과 treatment가 제공됩니다.
실험 사용 사례
- 애플리케이션의 새로운 기능에 대해 A/B 테스트를 실행하십시오.
- 서버에서 여러 추천 알고리즘을 실험해 보십시오.
변형
변형은 고객을 위해 변경하는 실험의 일부입니다. 예를 들어 콜 투 액션(CTA) 버튼에 있는 텍스트를 실험해 보면 각 버전의 텍스트가 변형됩니다. 변형은 플래그 또는 실험 첫 사용 후 존재할 수 있습니다. 단일 변형은 단일 플래그와 연관될 수 있고, 여러 변형은 더 큰 실험과 연관될 수 있습니다. 실험에는 변형이 필요합니다. 그러면 실험의 가설을 테스트할 수 있습니다.
SDK 사용
SDK 또는 평가 API에서 변형에 액세스할 때 value 및 payload 만 사용할 수 있습니다.
| 속성 | 요구 사항 | 설명 |
|---|---|---|
value | 필수 | 계측의 변형을 식별하는 문자열입니다. Amplitude는 SDK 또는 평가 API가 변형에 액세스할 때 값 문자열의 동일성을 확인합니다. 형식은 소문자, kebab-case 또는 snake_case여야 합니다. |
payload | 선택 사항 | 변형과 함께 임의의 데이터를 전송하기 위한 동적 JSON 페이로드입니다. 예를 들어 응용 프로그램에서 구성 요소의 색상을 변경하기 위해 16진수 코드를 전송할 수 있습니다. |
name | 선택 사항 | 변형의 이름입니다. 이름은 value과 비슷하지만 형식 제한이 없으며 코드 베이스의 계측을 손상시키지 않고도 이름을 변경할 수 있습니다. |
description | 선택 사항 | 변형에 대한 자세한 설명입니다. 설명을 사용하여 사용자가 변수 경험을 보다 자세히 볼 때 경험하는 것을 설명하십시오. |
사용자
실험 사용자는 Amplitude 분석 내의 사용자에게 매핑됩니다. 플래그 구성 외에도 사용자는 평가에 대한 입력값도 됩니다. 플래그 및 실험 타겟팅 규칙은 사용자 속성에 액세스합니다.
원격 평가를 위해 fetch 요청을 통해 사용자를 평가에 전달하거나, 로컬 평가를 위해 evaluate 기능에 직접 전달합니다.
평가가 성공하려면 사용자 객체에 사용자 ID 또는 장치 ID를 포함하십시오. 예를 들어 사용자 ID와 장치 ID가 모두 null이거나 비어 있거나 누락된 경우 원격 평가는 400 오류를 반환합니다.
| 속성 | 유형 | 설명 |
|---|---|---|
user_id | string | 사용자 ID는 사용자의 기본 식별자입니다. 이 값은 일반적으로 시스템 첫 사용 후 사용자의 ID입니다. 실험은 원격 평가 전에 보강 시 Amplitude ID를 확인할 때 사용자 ID를 사용하며, 여기서 Amplitude ID는 기본 버킷팅 키입니다. |
device_id | string | 장치 ID는 사용자의 보조 식별자입니다. 분석 SDK는 일반적으로 클라이언트 측에서 장치 ID를 임의로 생성하거나 서버 측의 쿠키에 설정합니다. 또한 실험은 원격 평가 전에 보강 시 Amplitude ID를 확인할 때 장치 ID를 사용하며, 여기서 Amplitude ID는 기본 버킷팅 키입니다. |
user_properties | object | 로컬 또는 원격 평가 시 사용자를 평가할 때 사용되는 사용자 정의 속성의 선택적 객체입니다. |
groups | object | 베타. 이 사용자와 연관된 그룹을 나열하는 선택적 객체입니다. 형식은 키가 그룹 유형이고 값이 그룹 값 문자열의 배열인 객체입니다(예: {"org name":["Amplitude"]}). |
group_properties | object | 베타입니다. 이 사용자와 연관된 그룹 속성을 나열하는 선택적 객체입니다. 형식은 중첩된 객체로, 여기서 키는 그룹 유형이고, 값은 객체이며, 여기서 키는 그룹 값이고, 값은 속성의 객체입니다(예: {"org name":{"Amplitude":{"plan":"enterprise"}}}). |
이 기능은 Early Access 버전입니다. 이 기능은 계속 진화할 수 있습니다. 이 문서는 아직 최신 업데이트를 반영하지 않을 수 있습니다.
조직에서 계정 추가 기능을 구입한 경우 사용자가 아닌 그룹에 대해 버킷 설정 및 분석을 수행할 수 있습니다. 액세스를 받으려면 담당자에게 문의하십시오.
가져오기 요청과 함께 전송될 때 사용자와 함께 그룹을 포함시켜야 합니다(권장됨). 또는 그룹 식별 API의 그룹 식별 호출을 통해 사용자와 그룹을 식별하거나 분석 SDK의 를 setGroup()사용하십시오.
모든 실험 SDK는 그룹을 지원합니다. 다음 표에는 최소 버전이 나와 있습니다.
전체 사용자 정의
이 내용이 도움이 되었나요?