Browser SDK 2 릴리즈 노트

@amplitude/analytics-browser(브라우저 SDK 2)의 릴리즈 노트입니다. 전체 엔지니어링 변경 로그를 보려면 GitHub의 analytics-browser CHANGELOG로 이동하십시오.

2.48.0

2026년 10월 15일 릴리즈됨.

기능

  • 실험 커넥터 이벤트에서 track로 그룹 정보를 전달하여 노출 이벤트에 그룹 컨텍스트가 표시되도록 합니다(#2039).

수정

  • 커넥터 및 실험 의존성을 업데이트하여 통합 SDK에서 노출 그룹 동작을 수정하십시오(#2060).

2.45.9

2026년 9월 16일 릴리즈됨.

수정

  • 빈 문자열 인스턴스 이름이 일관되게 처리되도록 빈 인스턴스 이름을 정규화합니다(#1956).

2.45.7

2026년 8월 24일에 릴리즈되었습니다.

수정

  • 배열이 아닌 반환 유형이 자동 캡처에서 예외를 발생시키지 않도록 합니다(#1919)querySelectorAll. 이는 JS가 반환 유형을 NodeList 이외의 것으로 변경하는 함수로 document.querySelectorAll재정의하는 웹사이트에만 적용됩니다.

2.45.0

2026년 7월 14일 릴리즈됨.

기능

  • 기본적으로 이벤트 속성 어트리뷰션을 활성화하면 캠페인 매개 변수가 사용자 속성과 이벤트 속성 모두에 적용됩니다. 사용자 속성 어트리뷰션만 유지하도록 autocapture.attribution.trackingMethod명시적으로 설정합니다(#1860).
ts
amplitude.init(API_KEY, {
  autocapture: {
    attribution: {
      trackingMethod: "userProperty", // opts out of the default event property attribution
    },
  },
});

2.44.1

2026년 6월 11일 릴리즈됨.

수정

  • JSON 직렬화를 수정하여 원격 구성에서 순환적 오류를 방지합니다(#1826).

2.44.0

2026년 6월 11일 릴리즈됨.

기능

  • 가져오기 트랜스포터referrerPolicy에서 구성 가능한 옵션을 만듭니다 (#1805).
ts
amplitude.init(API_KEY, {
  transport: {
    type: "fetch",
    referrerPolicy: "no-referrer", // sets this referrerPolicy on outgoing Amplitude network requests
  },
});

수정

  • 브라우저가 실제로 오프라인에서 온라인으로 전환될 때 큐에 대기 중인 이벤트를 플러시합니다(#1812).
  • 오류를 발생시키는 대신 trackVideo에서 오류를 반환합니다(#1804).

2.43.0

2026년 6월 5일 릴리즈됨.

기능

  • 페이지 언로드 시 손실되는 이벤트 요청을 줄이도록 기본적으로 가져오기 요청에 keepalive를 활성화하십시오(#1781).

2.42.1

2026년 5월 5일 릴리즈됨.

수정

  • SDK가 Chrome 확장 프로그램 내에서 실행될 때 자동 캡처를 옵트인으로 설정하십시오. 이는 Chrome 확장 프로그램이 사용자의 브라우징 기록에 액세스할 수 있고, 자동 캡처 기능이 개인정보 보호에 영향을 미칠 수 있기 때문입니다(#1710).

2.42.0

2026년 4월 28일 릴리즈됨.

기능

  • 기본적으로 요청 본문을 압축합니다(프록시 URL이 설정된 경우 제외). 이는 SDK의 네트워크 요청의 대역폭을 줄이기 위한 것입니다(#1699).

2.41.0

2026년 4월 21일 릴리즈됨.

기능

ts
amplitude.init(API_KEY, {
  autocapture: {
    ...otherAutocaptureOptions,
    performanceTracking: true,
  },
});

2.40.0

2026년 4월 14일 릴리즈됨.

기능

  • 캠페인 어트리뷰션 데이터를 "event_properties"에 적용하는 구성을 추가합니다. 이를 통해 쿼리 시 영구 속성을 통해 캠페인 데이터를 추론할 수 있습니다(#1628).
ts
amplitude.init(API_KEY, {
  autocapture: {
    attribution: {
      trackingMethod: "eventProperty",
    },
  },
});

2.39.0

2026년 4월 9일 릴리즈되었습니다.

기능

  • 실험용 비디오 트래킹을 추가합니다trackVideo(#1652).

수정

  • 원격 구성에서 활성화된 경우에도 사용자 지정 보강 플러그인을 비활성화할 수 있도록 합니다(#1638).

2.38.0

2026년 3월 26일 릴리즈됨.

기능

  • 원격 구성(#1621)을 통해 자동 캡처를 지원합니다viewportContentUpdated.

2.37.0

2026년 3월 20일 릴리즈됨.

기능

  • 원격 구성 설정에 의해 작동하는 사용자 지정 보강 플러그인을 추가하십시오(#1586).

2.36.4

2026년 3월 12일 릴리즈됨.

수정

  • 최상위 도메인을 확인하는 동안 localhost 및 단일어 도메인을 건너뛰십시오(#1584).
  • 대부분의 클라이언트측 오류가 발생하면 원격 구성 요청 재시도를 중단하십시오(HTTP 429에서 여전히 재시도됨)(#1590).

2.36.3

2026년 3월 9일 릴리즈됨.

수정

  • Safari 쿠키 쓰기 과정의 경합 조건을 수정하고 쿠키 관련 예외 처리를 개선합니다(#1578).
  • 최상위 도메인 검사 중에 알려진 두 번째 도메인을 건너뛰십시오(#1575).

2.36.2

2026년 3월 5일 릴리즈됨.

수정

  • 최상위 도메인과 쿠키 활성화 검사를 동기화하여 재입력 오류를 방지하십시오(#1564).

2.36.0

2026년 3월 3일 릴리즈됨.

기능

  • 내부 추천자를 어트리뷰션에서 제외하려면 attribution.excludeInternalReferrers를 추가하십시오(#1548).
  • 요청 본문에 대해 gzip 압축을 지원합니다(opt-in)(#1542, #1568).

수정

  • 기본 excluded-referrer 동작을 개선합니다(#1559).

2.35.1

2026년 2월 19일에 릴리즈되었습니다.

수정

  • 브라우저 옵션을 기록할 때 순환 참조를 방지하십시오(#1537).

2.35.0

2026년 2월 17일에 릴리즈되었습니다.

기능

  • setIdentity()한 번의 호출에서 사용자 ID를 설정하기 위해 추가하십시오(#1517).

2.34.1

2026년 2월 10일 릴리즈됨.

수정

  • optOut가 "true"인 경우 session_start 및 어트리뷰션을 연기합니다(#1509).
  • form Autocapture가 동일한 양식을 두 번 바인딩하지 못하도록 합니다(#1527).

2.34.0

2026년 1월 26일 릴리즈됨.

기능

  • 양식 제출 전 사용자 지정 유효성 검사를 적용할 수 있도록 추가하십시오. 자동 캡처는 이벤트를 추적합니다(#1500)shouldTrackSubmit.

2.33.3

2026년 1월 14일 릴리즈됨.

수정

  • 쿠키 가용성 확인의 재진입 오류를 수정했습니다(#1493).

2.33.2

2026년 1월 14일 릴리즈됨.

수정

  • SDK가 충돌하는 쿠키를 작성하거나 읽을 수 있는 경우를 해결합니다(#1490).

2.33.0

2025년 12월 24일에 릴리즈되었습니다.

기능

  • 전송 공급자에서 사용자 지정 헤더를 설정합니다(#1444).

2.32.2

2025년 12월 16일에 릴리즈되었습니다.

수정

  • 원격 구성 가져오기가 다시 작동하도록 고정했습니다(#1434)remoteConfig.fetchRemoteConfig.

2.32.1

2025년 12월 12일 릴리즈됨.

수정

  • 진단 추적에 사용자 에이전트를 포함하십시오(#1428).

2.32.0

2025년 12월 9일 릴리즈됨.

기능

  • 스크립트 로더를 사용하여 SDK를 설치할 때 진단에서 발견되지 않은 SDK 오류를 캡처하십시오(#1419).

2.31.4

2025년 12월 8일 릴리즈됨.

수정

  • identify호출에서 경합 조건을 수정했습니다(#1424).

2.31.1

2025년 11월 17일에 릴리즈되었습니다.

수정

  • 실패한 네트워크 응답을 진단 프로그램에 기록합니다(#1405).

2.31.0

2025년 11월 17일에 릴리즈됨.

기능

  • SDK가 ID를 재설정할 때 반응할 수 있도록 reset 리스너 API를 추가하십시오(#1393).
  • 진단을 위해 원격 구성 지원을 추가합니다(#1397).

2.30.0

2025년 10월 29일에 릴리즈되었습니다.

기능

  • SDK가 수집하는 진단 지표를 확장합니다(#1371).

2.29.0

2025년 10월 23일에 릴리즈되었습니다.

기능

  • 기본적으로 페이지 URL Enrichment 플러그인을 활성화하십시오(#1287).

2.28.0

2025년 10월 23일에 릴리즈되었습니다.

기능

  • 원격 구성 요청을 프록시할 수 있도록 원격 구성 서버 URL 옵션을 추가하십시오(#1348).

2.27.0

2025년 10월 17일에 릴리즈되었습니다.

기능

  • Web Vitals 자동 캡처를 정식 출시로 승격합니다(#1347).

2.26.0

2025년 10월 14일에 릴리즈되었습니다.

기능

  • 자동 캡처가 true인 경우 기본적으로 네트워크 추적을 활성화합니다(#1333).

수정

  • 별도의 analytics-remote-config 의존성을 제거합니다(#1336).

2.25.3

2025년 10월 6일 릴리즈됨.

수정

  • 실험 이벤트에 대해 타임스탬프 재정의를 허용하십시오(#1317).
  • frustrationInteractions구성 시 복수화를 수정하십시오(#1320).

2.25.2

2025년 10월 3일 릴리즈됨.

수정

  • 자동 캡처 계층 구조 조회 타이밍에 대한 진단을 추가합니다(#1312).
  • 불필요한 URL 경고를 억제합니다(#1315).
  • 실험 이벤트에 대한 타임스탬프 재정의를 지원합니다.

2.25.0

2025년 9월 25일 릴리즈됨.

기능

  • SDK 구성에 identify옵션을 추가하십시오(#1303).

2.24.1

2025년 9월 18일 릴리즈됨.

수정

  • 네트워크 추적에 원격 구성 헤더를 적용합니다(#1288).

2.24.0

2025년 9월 12일 릴리즈됨.

기능

  • 네트워크 추적을 위한 원격 캡처 규칙에 추가하십시오(#1284)urlsRegex.
  • Frustration Interactions Autocapture를 정식 출시로 승격하십시오(#1286).

2.23.6

2025년 9월 5일 릴리즈됨.

수정

  • 리디렉션 전에 Web 실험에서 설정한 원래 마케팅 쿠키를 사용하십시오(#1280).

2.23.3

2025년 8월 25일에 릴리즈되었습니다.

수정

  • public 유형 표면에 누락된 BrowserClient 속성을 추가합니다(#1272).

2.23.1

2025년 8월 22일 릴리즈됨.

수정

  • Reddit 클릭 ID 속성 이름을 수정합니다(#1267).

2.23.0

2025년 8월 21일에 릴리즈되었습니다.

기능

  • 네트워크 캡처 규칙에 실험용 URL 일치를 추가합니다(#1252).

2.22.1

2025년 8월 8일 릴리즈됨.

수정

  • 원격 구성 값을 로컬 SDK 구성으로 변환하는 것을 개선합니다(#1232).

2.22.0

2025년 8월 5일 릴리즈됨.

기능

  • 이전 페이지 (#1238)를 포함하여 추가 페이지 URL 속성을 위해 Page URL Enrichment 플러그인을 추가하십시오.

수정

  • 새로운 원격 구성 클라이언트로 전환하십시오(#1191).

2.21.1

2025년 7월 30일 릴리즈됨.

수정

  • 교차 도메인 추적을 위한 평가 창을 지원합니다(#1227).

2.21.0

2025년 7월 29일에 릴리즈되었습니다.

기능

  • analytics-core에서 통합 AmplitudeContext 및 AnalyticsClient 항목을 노출하십시오(#1222).

2.20.1

2025년 7월 18일 릴리즈됨.

수정

  • Autocapture가 부울로 설정된 경우 Frustration Interactions 및 Web Vitals를 비활성화된 true상태로 유지하십시오(대신 명시적으로 활성화하십시오)(#1214).

2.20.0

2025년 7월 17일 릴리즈됨.

기능

  • Web Vitals(autocapture.webVitals)에 대한 자동 캡처 지원을 추가합니다(#1195).

2.19.0

2025년 7월 15일 릴리즈됨.

기능

  • 실험적인 Frustration Interactions Autocapture(autocapture.frustrationInteractions)를 추가합니다(#1209).

2.18.0

2025년 6월 30일 릴리즈됨.

기능

  • getOptOut()및 getIdentity() 헬퍼를 추가합니다(#1174).

2.17.10

2025년 6월 16일 릴리즈됨.

수정

  • 글로벌 범위에서 addEventListener를 사용할 수 없는 환경에 대해 보호하십시오(#1154).

2.17.7

2025년 5월 27일 릴리즈됨.

수정

  • autocapture.networkTracking를 구성 객체로 지원합니다(#1095).

2.17.3

2025년 5월 5일 릴리즈됨.

수정

  • 보다 정확한 네트워크 캡처 타이밍을 위해 performance.now()를 사용하십시오(#1060).

2.17.0

2025년 5월 2일 릴리즈됨.

기능

  • 자동 캡처 네트워크 오류 (#1050).

2.16.1

2025년 4월 30일 릴리즈됨.

수정

  • fetchRemoteConfig기본값을 true로 설정하여 끄지 않는 한 SDK가 원격 구성을 가져옵니다. 이전 버전에서는 사용자가 활성화하지 않는 한 원격 구성이 꺼집니다(#1048).
ts
amplitude.init(API_KEY, {
  fetchRemoteConfig: false, // opts out of remote configuration
});

2.10.0

2024년 8월 2일 릴리즈됨.

기능

  • 원격 구성을 추가하여 데이터 > 설정 > 자동 캡처의 자동 캡처 설정이 로컬 구성과 병합되도록 합니다. 원격 값이 우선합니다. 이 버전에서는 원격 구성이 기본적으로 꺼져 있습니다(#832).
ts
amplitude.init(API_KEY, {
  fetchRemoteConfig: true, // enables remote configuration in versions before 2.16.1
});

2.8.0

2024년 5월 21일 릴리즈됨.

기능

  • ampSessionId URL 매개 변수에서 세션 ID를 읽고, ampDeviceId URL 매개 변수에서 장치 ID를 읽어 교차 도메인 링크가 하나의 세션 및 장치를 유지하도록 하십시오. SDK는 여전히 기존 deviceId URL 매개변수를 읽지만 ampDeviceId 우선합니다(#753).

2.4.0

2024년 1월 24일에 릴리즈되었습니다.

기능

  • 오프라인 모드를 추가합니다. SDK는 브라우저가 오프라인인 동안 이벤트를 스토리지에 저장하고 다시 연결되면 이벤트를 플러시합니다(#644).

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

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.

이 페이지에서