이 페이지에서

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.

실험 구성

기능 실험 구성은 두 단계 프로세스입니다.

  • 배포를 생성합니다.
  • 사용하려는 SDK를 설치합니다.

실험을 구성하는 것은 실험을 만드는 것과 같지 않습니다. 실험을 생성하기 전에 실험을 구성하고 작동하는지 확인하십시오. 이 페이지는 기능 실험에 대해 설명합니다. 웹 실험을 구성하려면 웹 실험 구현으로 이동하십시오.

배포를 생성합니다.

실험에서 배포는 코드 실행을 위한 플래그 또는 실험 그룹을 제공합니다. 배포를 생성한 후 실험은 플래그와 실험을 라우팅하는 액세스 키를 생성합니다.

배포는 Amplitude 분석 프로젝트 하에 진행됩니다. 한 프로젝트에 여러 개의 배포가 있을 수 있지만 각 배포는 단일 프로젝트에 연결됩니다.

배치를 작성하려면 다음 단계를 수행하십시오.

  1. 실험 > 배포로 이동한 다음 배포 생성을 클릭합니다.

  2. 배포와 연관시킬 Amplitude 애널리틱스 프로젝트를 선택합니다. 여러 프로젝트에서 배포를 작성하려면 드롭다운 목록에서 관련 프로젝트를 모두 선택합니다.

  3. 배치에 대한 설명적인 이름을 입력합니다.

  4. 유형을 지정합니다.

    • 클라이언트측: 이러한 배포는 웹 브라우저나 모바일 앱과 같은 클라이언트 장치에서 실행됩니다. 클라이언트 배포를 위한 배포 키는 공개적으로 볼 수 있으며 클라이언트측 SDK와 함께 작동합니다.
    • 서버측: 이러한 배포는 웹 서버나 일괄 처리 시스템과 같이 사용자가 제어하는 서버에서 실행됩니다. 서버 배포용 배포 키는 비밀로 유지하고 서버 측 SDK와 함께 사용하십시오. 서버측 키는 플래그 평가를 위해 REST API에 액세스할 수 있습니다. 전체 실험을 실행하는 대신 REST API를 통해서만 플래그를 평가해야 하는 경우에는 서버측 배포를 생성하십시오.
  5. 배포 생성을 클릭합니다. 실험은 배포를 생성하고 복사하여 사용할 키를 생성합니다.

배포 키

각 배포는 데이터 무결성을 보장하는 고유 키를 생성합니다. 키는 실험에서 수집한 모든 데이터를 해당 배포와 연관시켜 결과와 분석을 정확하게 유지합니다. 키에 대한 자세한 내용은 키 및 토큰으로 이동하십시오.

  • 클라이언트측 키: 클라이언트 배포에 대한 배포 키는 공개적으로 볼 수 있습니다.
  • 서버측 키: 서버 배포를 위한 배포 키를 비밀로 유지하고 서버측 SDK에서만 사용하십시오. 서버측 키는 플래그 평가를 위해 API에 액세스합니다.

SDK 설치

API를 사용하지 않는 경우 다음에 실험 SDK를 설치하십시오. 모든 SDK는 사용자에게 서비스를 제공할 플래그 구성을 결정하기 위해 Amplitude 실험에 요청을 보냅니다. 클라이언트측 SDK와 서버측 SDK 대상 구간 차이점은 다음과 같습니다.

엔지니어는 SDK를 설치해야 합니다. 그렇지 않으면 데이터 저장소에 문제가 생길 위험이 있습니다.

클라이언트측 SDK는 최종 사용자 애플리케이션 배포 환경에서 실행됩니다. 클라이언트측 SDK:

  • 단일 사용자 배포를 가정합니다.
  • 클라이언트측 배포 키를 사용하십시오. 이 키는 공용이며 최종 사용자에게 표시됩니다.
  • 지정된 사용자를 위한 변형을 미리 가져옵니다.
  • 오프라인 모드를 위해 변형을 클라이언트에 로컬로 저장합니다.

서버측 SDK는 서버 배포에서 실행됩니다. 서버측 SDK:

  • 다중 사용자 배포를 가정합니다.
  • 서버측 배포 키를 사용하십시오. 이 키는 비공개로 유지해야 합니다.
  • 각 요청에 대한 변형을 가져옵니다.

사용자 컨텍스트

변형을 할당할 때 평가 엔진은 개별 사용자의 ID를 나타내는 사용자 컨텍스트 객체에 타겟팅 규칙을 적용합니다. 클라이언트측 SDK에서 SDK는 초기화 시 이 객체를 설정하고 모든 변형 요청에 따라 이를 서버에 전달합니다. 서버측 SDK에서는 사용자가 변경될 수 있으며 SDK는 모든 요청에 대해 사용자를 설정합니다.

개별 사용자를 대상으로 변형을 할당할 때 실험은 user_id 및 device_id와 같이 나열된 사용자 식별자 중 하나라도 일치하면 매칭합니다. 규칙 기반 사용자 세그먼트를 사용하면 사용자는 미리 정의된 속성(국가, 플랫폼 등)이나 user_properties 객체의 사용자 지정 속성과 일치하게 됩니다. 실험 사용자 정의에 대해 자세히 알아보십시오.

분석으로 데이터를 전송하는 데 사용하는 것과 동일한 사용자 식별자를 Amplitude 실험에 사용하십시오. 이를 통해 ID가 올바르게 확인되고 분석은 생성된 데이터를 동일한 사용자와 연결합니다.

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