테스트 쿠키로 원하는 분기 보기

A/B 실험을 운영에서 확인할 때 보통 "내 계정이 A에 걸리길" 기다려야 합니다. 테스트 쿠키를 심으면 그 대기 없이 즉시 원하는 분기(A 또는 B)를 화면에 띄울 수 있어요. QA·미리보기에 쓰는 기능입니다.

1. 어드민에서 쿠키 값 설정

• /experiments에서 실험의 "테스트 쿠키" 컬럼을 클릭하면 variant별 쿠키 값을 입력할 수 있습니다.
• /flags의 플래그는 ON/OFF 각각에 쿠키 값을 둘 수 있어요 (예: ON=flag_on, OFF=flag_off).
• 입력 가능 문자: A-Z a-z 0-9 _ . - (최대 64자)

2. 브라우저에서 쿠키 심기

호스트 앱이 SDK를 사용 중이라면, 그 페이지에서 DevTools Console에 아래를 실행:

// 실험 'checkout-redesign'을 강제로 B로
document.cookie = 'taekcle_checkout-redesign=card_b; path=/; max-age=86400';
// 플래그 'promo-banner'를 강제로 ON
document.cookie = 'taekcle_promo-banner=flag_on; path=/; max-age=86400';
// 새로고침

이름 규칙은 항상 taekcle_<flag-or-experiment-key>, 값은 어드민에 설정한 그 쿠키 값과 정확히 일치해야 합니다.

주의: A/B는 어드민에서 분기를 부르는 이름일 뿐, 쿠키에 넣는 값이 아닙니다. 먼저 어드민에서 각 분기에 별도의 테스트 쿠키 값을 정해두세요 (예: A에는 hero_a, B에는 hero_b). 쿠키에는 이 값을 그대로 넣습니다.

3. 쿠키 제거 (오버라이드 해제)

document.cookie = 'taekcle_checkout-redesign=; path=/; max-age=0';

4. 어떻게 동작하나

• 브라우저용 SDK: 분기를 결정할 때 먼저 쿠키를 보고, 일치하는 값이 있으면 그 분기로 즉시 반환합니다.
• 서버 컴포넌트: 같은 방식으로 쿠키를 먼저 확인합니다.
• 자동 분배 우회: 쿠키가 일치하면 사용자 ID 기반 자동 분배 결과는 무시됩니다.
• 실시간 반영: 어드민에서 쿠키 값을 바꾸면 다음 새로고침부터 적용됩니다.

5. 보안 노트

• 이 쿠키는 클라이언트가 자기 자신에게만 영향을 미칩니다. 다른 사용자의 분배에 영향을 주지 못해요.
• 실험 자체가 OFF여도 쿠키만 있으면 variant가 반환되어 UI를 미리 확인할 수 있어요. 단, 호스트 앱이 Mixpanel 등에 experiment_started 이벤트를 발화하면 그 이벤트도 같이 기록되니, QA 시 이벤트 필터링에 유의하세요 (예: 내부 IP 제외).
• 운영에 영향 없는 안전한 기능이지만, 외부 사용자에게 쿠키 값을 노출하지 않도록 사내 채널에서만 공유하세요.

/demo에서 즉시 실험해볼 수 있어요.