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 실험 목적지로 데이터 동기화합니다. 동적 코호트의 경우 이 동기화는 기본적으로 매시간 실행됩니다. 원격 평가에서 대상으로 삼는 동적 코호트는 실시간으로 업데이트되지 않습니다. 예를 들어 Sign Up 이벤트를 수행한 사용자 코호트를 타겟팅하는 경우 Amplitude는 이벤트 발생 후 1시간 이내에 해당 사용자를 타겟팅합니다.
원격 평가의 대상이 되는 코호트는 차이의 크기에 따라 초기 동기화 시 또는 큰 변경 이후에 전파 지연을 가질 수 있습니다. 예를 들어 1천만 명의 사용자 코호트의 첫 번째 동기화는 이후의 데이터 동기화보다 더 오래 걸립니다.
원격 평가는 최대 1천만 명의 사용자 코호트를 지원합니다.
원격 평가 코호트 타겟팅 활용 사례
- 실험 타겟팅 세그먼트에서 사용할 수 없는 사용자 행동이나 속성을 기반으로 사용자를 타겟팅하고 있습니다.
- 코호트 동기화 간격의 타겟팅 지연은 프로세스를 방해하지 않습니다.
다음과 같은 경우에는 원격 평가 코호트 타겟팅을 사용하지 마십시오.
- 사용자를 실시간으로 타겟팅해야 합니다.
지역 평가
최신 서버측 SDK에 배포된 로컬 평가 플래그와 실험도 코호트를 대상으로 삼을 수 있습니다. 로컬 평가 플래그에서 코호트를 대상으로 설정하면 Amplitude는 해당 코호트를 실험 로컬 평가 목적지로 데이터 동기화합니다. 동적 코호트의 경우 이 동기화는 매시간 실행됩니다. 로컬 평가에서 타겟팅된 동적 코호트는 실시간으로 업데이트되지 않습니다. 예를 들어 Sign Up 이벤트를 수행한 사용자 코호트를 타겟팅하는 경우 Amplitude는 해당 사용자를 이벤트 직후가 아니라 이벤트 발생 후 1시간 이내에 타겟팅합니다.
로컬 평가는 최대 5천만 명의 사용자 코호트를 지원합니다.
코호트는 사용자 ID만 지원합니다
로컬 평가 코호트는 사용자 ID만 SDK에 동기화합니다. 로컬 평가 플래그에서 코호트를 대상으로 지정하려면 evaluate 함수에 전달된 사용자 객체에 사용자 ID를 포함하십시오.
SDK 지원
서버측 SDK는 사용자가 코호트를 대상으로 하도록 구성할 경우 이를 대상으로 설정할 수 있습니다. 클라이언트측 SDK는 로컬 평가 코호트 타겟팅을 지원하지 않습니다.
초기화 시, 프로젝트 API 및 비밀 키를 사용하여 코호트 동기화 구성을 구성하여 로컬 평가 코호트 다운로드 및 대상 설정을 활성화합니다.
const experiment = Experiment.initializeLocal('DEPLOYMENT_KEY', {
// (Recommended) Enable local evaluation cohort targeting.
cohortSyncConfig: {
apiKey: 'API_KEY',
secretKey: 'SECRET_KEY'
}
});
문제 해결
동적 코호트와 코호트 데이터 동기화가 비동기적이기 때문에 코호트 타겟팅은 문제 해결이 어려울 수 있습니다. 실험이 대상 코호트에 속해야 하는 사용자를 대상으로 하지 않는 경우 다음을 시도해 보십시오.
- 로컬 평가의 경우 SDK 버전이 로컬 평가 코호트 타겟팅을 지원하는지, 그리고 초기화 시 코호트 동기화 구성을 설정했는지 확인하십시오.
- 코호트가 필요한 동기화를 갖추고 있는지 확인하십시오(원격 평가용 Amplitude 실험, 로컬 평가용 실험 로컬 평가).
- 코호트에 예상된 사용자가 포함되어 있는지 확인하십시오. 사용자가 현재 코호트에 속해 있는 경우 해당 코호트의 동기화 기록을 확인하십시오. 사용자가 평가가 발생한 후 동기화에서 코호트에 추가되었을 수 있습니다.
fetch또는evaluate에 전달된 사용자 정보가 올바른지 확인하십시오.
이 내용이 도움이 되었나요?