Browser Unified SDK 계측 및 구성
이 가이드에서는 브라우저 통합 SDK(@amplitude/unified)와 관련된 작업에 대해 설명합니다. 제품 구성, 기능 실험 및 세션 리플레이 사용, 가이드 및 설문조사 해제. 이벤트 추적, 사용자 식별, 자동 캡처 및 업로드 동작은 번들로 제공되는 브라우저 SDK 2에서 제공되며 동일하게 작동합니다. 이러한 작업을 위해서는 계측기로 이동하여 브라우저 SDK 2를 구성하십시오. 서명을 보려면 브라우저 통합 SDK 참조로 이동하십시오. 버전 간 변경 사항은 @amplitude/unified변경 로그로 이동하십시오.
각 제품 구성
initAll이 각 제품을 설정하는 방법
initAll() 다음 단계를 순서대로 실행하며, 마지막 단계가 끝난 후에 해결됩니다.
analytics옵션을 사용하여 분석(브라우저 SDK 2)을 초기화합니다.sessionReplay옵션과 함께 세션 리플레이 플러그인을 추가합니다.experiment옵션과 함께 기능 실험 플러그인을 추가합니다.engagement옵션과 함께 가이드 및 설문조사 플러그인을 추가합니다.
모든 단계에서 공유 옵션을 제품의 자체 옵션 위에 initAll()병합합니다serverZone.instanceName 설정하지 않은 경우에도 공유 값이 항상 우선합니다. 최상위 수준에서 설정되지 않으면 analytics.serverZone대체되며, undefined제품은 기본값으로 serverZone돌아갑니다US.
최상위 수준에서 공유 옵션 설정
옵션 객체의 최상위 수준에 설정하고, 제품 블록 내부에는 절대로 설정하지 serverZone마십시오instanceName:
amplitude.initAll("YOUR_API_KEY", {
serverZone: "EU",
instanceName: "storefront",
});
최상위 수준에 serverZone: "EU" 이(가) 있으면 모든 제품은 EU 데이터 센터를 사용합니다. 분석 기능을 api.eu.amplitude.com로 업로드합니다. 세션 리플레이는 sr-client-cfg.eu.amplitude.com에서 구성을 읽고, 기능 실험은 api.lab.eu.amplitude.com에서 가져옵니다.
EU 프로젝트는
initAll("KEY", { analytics: { serverZone: "EU" } })분석 내부의 데이터 센터 설정을 잃게 되며, 이벤트를 미국 데이터 센터로 전송합니다. serverZone최상위 수준으로 이동합니다.
각 제품에 옵션을 전달합니다
각 제품 블록은 해당 제품의 옵션을 받습니다:
amplitude.initAll("YOUR_API_KEY", {
serverZone: "EU",
analytics: {
autocapture: { elementInteractions: true },
identityStorage: "localStorage",
},
sessionReplay: {
sampleRate: 0.1,
},
experiment: {
deploymentKey: "YOUR_CLIENT_DEPLOYMENT_KEY",
},
engagement: {
skip: true,
},
});
| 블록 | 허용 |
|---|---|
analytics | 모든 브라우저 SDK 2 옵션. |
sessionReplay | 세션 리플레이 플러그인 옵션(공유 옵션을 제외함). |
experiment | 실험 JavaScript SDK 옵션, Plus deploymentKey. |
engagement | 가이드 및 설문조사 옵션, Plus skip. |
기능 실험 사용
플래그 가져오기 및 변형 읽기
기능 실험 클라이언트는 initAll()동안 플래그를 가져오지 않습니다. 변형을 읽기 전에 fetch()를 호출하고 기다립니다. 첫 번째 가져오기가 완료되기 전에 variant()는 빈 객체를 반환합니다.
await amplitude.initAll("YOUR_API_KEY", {
experiment: { deploymentKey: "YOUR_CLIENT_DEPLOYMENT_KEY" },
});
const experiment = amplitude.experiment();
await experiment?.fetch();
const variant = experiment?.variant("checkout-redesign");
if (variant?.value === "treatment") {
// Show the new checkout.
}
fetch() 는 분석에서 사용자 ID와 장치 ID를 전송하므로 사용자를 알고 있는 경우 fetch()전에 setUserId()를 호출하십시오. 클라이언트의 다른 메서드의 경우 exposure(), all()및 clear()와 같이 실험 JavaScript SDK로 이동하십시오.
배포 키 설정
Amplitude 실험의 클라이언트 배포 키로 experiment.deploymentKey설정합니다. 이를 생략하면 플러그인이 프로젝트 API 키를 배포 키로 사용합니다.
Unified SDK 1.1.43에는 실험 플러그인이 베타 릴리즈 @amplitude/plugin-experiment-browser1.0.0-beta.51로 포함됩니다.
세션 리플레이 사용
샘플 속도 선택
세션 리플레이는 기본적으로 0로 설정되므로 기본적으로 아무것도 기록하지 않습니다. sessionReplay.sampleRate``0와 사이의 값을 설정하십시오. 1는 모든 세션을 기록하며, 1는 10개의 세션 중 약 1개의 세션을 0.1기록합니다. 테스트를 수행하는 동안 1을 사용한 다음 프로덕션 전에 낮춰야 합니다.
amplitude.initAll("YOUR_API_KEY", {
sessionReplay: { sampleRate: 0.1 },
});
Amplitude의 원격 구성에서도 프로젝트에 대해 캡처를 해제할 수 있습니다. 캡처가 꺼져 있으면 로그에 표시됩니다. Session ... not being captured due to capture being disabled for project or because the remote config could not be fetched.
코드에서 레코딩 제어
amplitude.sessionReplay()가 해결되면 세션 리플레이 클라이언트를 initAll()반환합니다.
await amplitude.initAll("YOUR_API_KEY", { sessionReplay: { sampleRate: 1 } });
const replay = amplitude.sessionReplay();
replay?.stop(); // Pause recording, for example on a page with sensitive data.
await replay?.flush(false); // Upload recorded data now, without retries.
replay?.start(); // Resume recording.
start() 는 여전히 샘플 속도, 타겟팅 및 옵트아웃을 존중합니다. 페이지의 나머지 부분에 대해 기록을 중지하고 세션 리플레이 리스너를 제거하려면 shutdown()를 호출하십시오.
마스킹, 개인정보 보호 및 플러그인의 다른 옵션을 보려면 세션 리플레이 플러그인으로 이동하십시오.
가이드 및 설문조사 끄기
가이드 및 설문조사는 기본적으로 초기화됩니다. initAll()중에 번들을 cdn.amplitude.com에서 gs.amplitude.com 다운로드하고 를 호출합니다. 가이드 및 설문조사를 사용하지 않는 경우 skip: true:
amplitude.initAll("YOUR_API_KEY", {
engagement: { skip: true },
});
skip: true가 있으면 가이드 및 설문조사는 아무것도 다운로드하지 않으며, 요청을 생성하지 않으며, amplitude.engagement.*에localStorage 키를 기록하지 않습니다. 콘솔은 로그를 Engagement SDK init skipped via `skip: true`. The SDK bundle will not be loaded. 기록합니다. skip 옵션을 사용하려면 통합 SDK 1.1.11 이상이 필요합니다.
가이드 및 설문조사를 켜려면 initAll()호출에서 제거하고 배포하십시오skip: true. 동일한 페이지에서 두 번째로 호출하여 켜지 initAll()마십시오. 두 번째 호출은 분석을 다시 초기화하고, 모든 플러그인을 다시 설치하며, 다른 페이지 뷰를 추적한 다음 세션 리플레이를 다시 시작합니다.
둘 이상의 인스턴스 실행
두 번째 프로젝트로 데이터를 전송하려면 createInstance()로 인스턴스를 생성하고 별도의 instanceName를 지정하십시오.
await amplitude.initAll("PRODUCTION_API_KEY");
const marketing = amplitude.createInstance();
await marketing.initAll("MARKETING_API_KEY", {
instanceName: "marketing",
});
amplitude.track("Signup Completed");
marketing.track("Signup Completed");
각 인스턴스는 자체 분석, 세션 리플레이 및 기능 실험을 초기화합니다. 가이드 및 설문조사는 initAll()를 실행하는 첫 번째 인스턴스에 대해 페이지당 한 번 초기화됩니다. 이후 인스턴스는 해당 engagement 옵션을 무시하고 Engagement SDK has already been initialized. Ignoring additional init call. 을 기록합니다. 가이드 및 설문조사 옵션은 먼저 초기화되는 인스턴스에 넣으십시오. 인스턴스가 ID를 분리하는 방법을 확인하려면 Browser SDK 2에서 둘 이상의 프로젝트로 이벤트 보내기로 이동하십시오.
데이터 전송
콘텐츠 보안 정책에서 Amplitude 허용
사이트에서 Content-Security-Policy헤더를 전송하는 경우 Amplitude의 도메인을 허용하십시오.
script-src https://*.amplitude.com;
connect-src https://*.amplitude.com;
npm에서 설치된 브라우저 SDK 2와는 달리, 가이드 및 설문조사는 cdn.amplitude.com에서 번들을 다운로드하기 때문에 번들로 구성할 때에도 통합 SDK는 script-src 필요합니다. engagement: { skip: true }를 설정한 경우 connect-src만 있으면 됩니다.
업로드, 배치, 프록시 및 오프라인 동작을 보려면 브라우저 SDK 2에서 데이터 전달로 이동하십시오.
이 내용이 도움이 되었나요?
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.