Browser Unified SDK 참조

이 참조는 버전 1.1.43에 대해 확인된 @amplitude/unified의 모든 공개 내보내기와 initAll()로 전달할 수 있는 모든 옵션을 설명합니다. 이 버전은 브라우저 SDK 2.48.1(@amplitude/analytics-browser)을 번들로 제공하므로 모든 분석 메서드가 브라우저 SDK 2 참조에 설명된 대로 작동합니다. 버전 간 변경 사항은 @amplitude/unified변경 로그로 이동하십시오.

ts
import * as amplitude from "@amplitude/unified";

최상위 함수는 기본 인스턴스에서 작동합니다. createInstance()의 각 인스턴스에는 동일한 메서드와 init()이 있습니다.

내보내기

최상위 모듈은 init()를 내보내지 않습니다. 대신 initAll()호출하십시오.

설정

initAll

분석을 초기화한 다음 세션 리플레이, 기능 실험, 가이드 및 설문조사를 추가합니다. 각 페이지 로드 시 인스턴스당 한 번씩 호출하십시오.

ts
initAll(apiKey: string, unifiedOptions?: UnifiedOptions): Promise<void>

initAll()는 AmplitudeReturn가 아닌 일반 Promise를 반환하므로 직접 await하십시오. 모든 제품의 설정이 완료된 후 해결됩니다. 해결되기 전에 수행된 호출은 대기열에서 대기하고 이후 순서대로 실행됩니다.

이전 호출이 아직 보류 중인 상태에서 수행된 호출은 동일한 Promise를 반환합니다initAll(). 이전 호출이 해결된 후 수행된 호출은 전체 설정을 다시 실행합니다initAll(). repeat 호출은 분석을 다시 초기화하고, 페이지 뷰 추적이 켜져 있는 경우 다른 페이지 보기를 추적한 다음 세션 리플레이를 다시 시작합니다. 또한 Plugin with name @amplitude/unified-library-plugin already exists, skipping registration를 기록합니다.

ts
await amplitude.initAll("YOUR_API_KEY", {
  serverZone: "EU",
  sessionReplay: { sampleRate: 0.1 },
});

실험

기능 실험 클라이언트를 반환하거나 추가하기 undefined전에 initAll()반환합니다.

ts
experiment(): IExperimentClient | undefined

클라이언트는 실험 JavaScript SDK 클라이언트입니다. 클라이언트는 initAll()동안 플래그를 가져오지 않습니다.fetch() 전에 variant()을 호출하세요.

ts
const experiment = amplitude.experiment();
await experiment?.fetch();
const variant = experiment?.variant("checkout-redesign");

sessionReplay

세션 리플레이 클라이언트를 반환하거나, 전에 initAll() 추가합니다.undefined

ts
sessionReplay(): AmplitudeSessionReplay | undefined
ts
const replay = amplitude.sessionReplay();
replay?.stop();

레코딩 옵션을 보려면 세션 리플레이 플러그인으로 이동하십시오.

createInstance

자체적인 분석 구성, ID, 대기열 및 플러그인을 사용하여 독립적인 인스턴스를 생성합니다.

ts
createInstance(): UnifiedClient
ts
const marketing = amplitude.createInstance();
await marketing.initAll("MARKETING_API_KEY", { instanceName: "marketing" });
marketing.track("Signup Completed");

가이드 및 설문조사는 페이지당 한 번씩 초기화됩니다. 첫 번째 인스턴스 initAll()후에 호출하는 인스턴스는 해당 engagement옵션을 무시합니다.

UnifiedClient

기본 인스턴스가 구현하고 createInstance() 반환하는 인터페이스입니다. 이 멤버들을 포함하여 브라우저 SDK 2BrowserClient를 확장합니다.

UnifiedOptions

initAll()에 전달하는 옵션 객체입니다. 모든 옵션은 선택 사항입니다.

공유 옵션

initAll()는 이러한 옵션을 모든 제품에 전달하고 각 제품 블록의 동일한 이름의 옵션에 병합합니다. 설정되지 않은 공유 옵션은 여전히 같은 이름의 제품 옵션을 undefined로 덮어씁니다.

제품 옵션

실험 옵션

참여 옵션

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

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.

이 페이지에서