at.js 버전 세부 사항

마지막 업데이트: 2025년 5월 5일
  • 주제:

작성 대상:

  • 개발자

Adobe Target at.js JavaScript 라이브러리의 각 버전 변경 내용에 대한 세부 사항입니다.

중요
Adobe Target은(는) at.js 1을 모두 지원합니다.x ​와 at.js 2 모두에 있는 Hide Body(본문 숨기기) 및 Show Body(본문 표시) 호출을 보여줍니다.x.
at.js 1.x ​이(가) 유지 관리 모드로 들어갔습니다. Target 팀은 필요한 경우 버그 수정 및 보안 패치를 릴리스합니다.
Target 팀은 at.js 2에 대한 모든 지원을 제공합니다.x ​을(를) 통해 버그 수정, 보안 패치, 기능 및 성능 최적화를 지속적으로 릴리스할 수 있습니다.
둘 중 하나의 최신 버전으로 업그레이드해야 합니다.x 또는 2.x ​을(를) 통해 해당 주 버전의 이전 부 버전에서 발견된 문제에 대한 버그 수정 및 보안 패치를 얻을 수 있습니다.

Adobe Experience Platform의 태그는 at.js를 업그레이드하는 기본 방법입니다. 확장 개발자는 확장에 새로운 기능을 지속적으로 추가하고 버그를 자주 수정합니다. 이러한 업데이트는 새로운 버전의 확장에 패키지화되어 Adobe Experience Platform 카탈로그에서 업그레이드로 사용할 수 있습니다. 자세한 내용은 태그 개요 안내서에서 확장 업그레이드를 참조하십시오.

at.js 버전 2.11.8(2025년 3월 31일)

  • 크기 조정 및 이동 작업 중 에지 사례를 방지하기 위해 문자열 접미사 유효성 검사에서 CodeQL로 식별된 취약성이 해결되었습니다. (TNT-51516)

at.js 버전 2.11.7(2025년 2월 26일)

  • localStorage을(를) 사용할 수 없을 때 원격 분석 로깅을 수정했습니다. 원격 분석으로 인해 일부 고객의 브라우저에서 localStorage을(를) 사용하지 않도록 설정한 문제가 발생했습니다.

at.js 버전 2.11.6(2024년 9월 29일)

  • Visual Experience Composer​(VEC) 또는 Form-Based Experience Composer 내의 리디렉션 오퍼에서 Target이(가) 올바르게 작동하지 않는 문제를 해결했습니다.

at.js 버전 2.11.5(2024년 8월 14일)

  • 쿠키 읽기 및 쓰기 작업을 위한 캐싱을 구현하여 반복되고 많은 비용이 드는 문자열 구문 분석 및 조작의 오버헤드를 줄였습니다.
  • 문자열을 수동으로 구문 분석하고 조작하는 것보다 빠르기 때문에 가능한 경우 최신 URL 검색 매개변수 API를 구현했습니다.

at.js 버전 2.11.4 (2024년 1월 24일 목요일)

  • 잘못된 지역 데이터가 배달 API로 전송되지 않도록 at.js가 업데이트되었습니다.

at.js 버전 2.11.3(2023년 11월 21일)

  • at-content-rendering-failed개 이벤트에서 응답 토큰을 보낼 수 없는 문제를 해결했습니다.

at.js 버전 2.11.2(2023년 10월 26일)

  • 사용자 지정 이벤트에서 전송된 응답 토큰에 불일치가 발생하는 문제를 해결했습니다.

at.js 버전 2.11.1(2023년 10월 13일)

  • at.js를 실행하는 페이지가 quirks 모드에 있는 동안 확인할 수 없는 오류가 발생하는 문제를 해결했습니다.

at.js 버전 2.11.0(2023년 10월 10일)

  • getOffer/getOffers 호출 시 배달 API로 전달되는 targetGlobalSettings의 사용자 지정 Adobe Experience Platform​(AEP) sandboxId 및 sandboxName 설정에 대한 지원이 추가되었습니다.
  • 선택기에서 :eq()을(를) 연결하는 섀도 DOM 수정.

at.js 버전 2.10.3(2023년 9월 12일)

  • 렌더링되는 오퍼가 없을 때 at-content-rendering-succeeded 사용자 지정 이벤트를 잘못 트리거하는 문제를 해결했습니다. 올바른 이벤트 at-content-rendering-no-offers이(가) 트리거되었습니다.
  • at-content-rendering-failed 사용자 지정 이벤트에 대한 오류 개체에 eventToken 및 responseTokens을(를) 추가했습니다.

at.js 버전 2.10.2 (2023년 3월 7일)

  • trackEvent 함수가 항상 오류를 반환하는 문제가 해결되었습니다.

at.js 버전 2.10.1 (2023년 2월 2일)

  • 이름에 점이 있는 매개변수를 포함하는 대상자 규칙과 관련된 활동이 온디바이스 결정을 위해 예상되는 경험을 반환하지 않는 버그가 수정되었습니다.
  • mboxDisable이 활성화된 경우에도 at.js가 게재 호출을 실행하는 at.js 2.6.0에서 도입된 버그를 수정했습니다.

at.js 버전 2.10.0(2022년 9월 19일 화요일)

  • 서드파티 쿠키 지원이 추가되었습니다.

at.js 버전 2.9.0(2022년 5월 27일)

at.js 버전 2.8.1 (2022년 1월 28일)

  • pageLoad이(가) ODD(On Device Decisioning) 하이브리드 실행 모드에서 target-global-mbox에 매핑되지 않는 문제를 해결했습니다.
  • mbox 요청에 대한 분석 세부 정보 관련 문제가 해결되었습니다.
  • 보안 취약성을 해결하기 위해 개발 종속성이 업그레이드되었습니다.

at.js 버전 2.8.0 (2022년 1월 7일)

이제 Target at.js JavaScript 라이브러리가 기능 사용 및 성능 원격 분석 데이터를 수집합니다. 개인 데이터는 수집되지 않습니다. 이 기능은 targetGlobalSettings에서 telemetryEnabled를 false로 설정하여 옵트아웃할 수 있습니다. 자세한 내용은 telemetryEnabled in targetGlobalSettings를 참조하십시오.

at.js 버전 2.7.0(2021년 10월 28일)

이번 릴리스에는 다음과 같은 개선 사항이 포함됩니다.

  • 웹 구성 요소에 대한 지원이 추가되었습니다. 이 버전의 at.js는 맞춤형 요소 및 맞춤형 요소 내부의 요소에 대한 개인화된 경험과 오퍼를 만들고 테스트하는 데 필요합니다. 이 기능은 Target Standard/Premium 21.10.5 릴리스에 포함되어 있습니다.

at.js 1.8.3 (2021년 9월 21일)

이번 릴리스에는 다음과 같은 변경 사항이 포함됩니다.

  • window.default 또는 document-default을(를) 설정한 고객에 대해 Platform Launch 빌드가 올바르게 작동하도록 reactor-window 및 reactor-document Adobe Experience Platform Launch 모듈을 제거했습니다.
  • 이제 at.js 1.8.3은 서드파티 도메인 쿠키가 제대로 설정되었는지 확인하기 위해 Samesite=None 및 Secure을(를) 명시적으로 설정합니다.

at.js 2.6.1 (2021년 8월 16일)

  • 온디바이스 의사 결정 사용 시 “하이브리드 모드에 대해 사용 가능한 아티팩트 없음” 버그가 수정되었습니다.

at.js 2.6.0 (2021년 7월 16일)

  • at.js settings secureOnly가 true로 설정될 때마다 쿠키에 보안 속성이 추가됩니다.
  • 이제 triggerView()를 사용할 때 응답 토큰을 사용할 수 있습니다.
  • CONTENT_RENDERING_NO_OFFERS 이벤트와 관련된 문제가 해결되었습니다. 이제 Target에서 반환되는 내용이 없을 때 이 이벤트가 정상적으로 트리거됩니다.
  • prefetch 요청을 사용할 때 Analytics for Target (A4T) 클릭 메트릭 세부 사항이 정상적으로 반환됩니다.
  • UUID 생성이 더 이상 Math.random()을 사용하지 않고 window.crypto를 사용합니다.
  • 모든 네트워크 호출에서 sessionId 쿠키 만료가 정상적으로 연장됩니다.
  • 이제 SPA(단일 페이지 애플리케이션) 보기 캐시 초기화가 올바르게 처리되며 viewsEnabled 설정이 적용됩니다. viewsEnabled을(를) false 값으로 설정하면 이제 triggerView() 함수가 비활성화됩니다. 초기 페이지 로드 작업 순서를 참조하세요.

at.js 2.5.0 (2021년 5월 13일)

이 at.js의 릴리스에는 다음과 같은 개선 사항 및 변경 사항이 포함되어 있습니다.

이 릴리스는 또한 Microsoft Internet Explorer 10 이상의 버전에 대한 지원을 제거합니다.

at.js 2.4.1(2021년 3월 23일)

at.js 유지 관리 릴리스이며, 다음과 같은 개선 기능 및 수정 사항이 포함되어 있습니다.

  • mbox 요청에 포함되는 targetPageParams에 관한 문제가 해결되었습니다. targetPageParams은 pageLoad 요청에만 포함되어야 합니다. (TNT-40247)
  • Adobe Experience Platform 확장에서 를 참조하는 최적화된 창 및 문서 전역 (TNT-37124)

at.js 2.4.0(2021년 1월 14일)

at.js 유지 관리 릴리스이며, 다음과 같은 수정 사항이 포함되어 있습니다.

  • 통합 프로필/플랫폼 ID에 대한 지원을 배달 API customerIds에 추가합니다.
  • 잘못된 스타일 태그 삽입을 해결합니다.

at.js 2.3.3 (2020년 11월 13일)

at.js 유지 관리 릴리스이며, 다음과 같은 수정 사항이 포함되어 있습니다.

  • mbox 클릭 추적 및 A4T와 관련된 문제가 해결되었습니다. 0n-클릭으로 Target에서 올바른 mbox 및 mbox 매개 변수를 사용하여 배달 API 호출을 실행했습니다. 그러나 SDID가 Analytics 호출의 SDID와 일치하지 않으므로 히트 결합과 전환이 없습니다. (TNT-38372)

at.js 2.3.2(2020년 7월 24일)

at.js 유지 관리 릴리스이며, 다음과 같은 수정 사항이 포함되어 있습니다.

  • 스크립트 또는 코드가 창 또는 문서에 기본 속성을 추가할 때의 버그를 해결했습니다.

at.js 1.8.2 (2020년 6월 15일)

at.js 유지 관리 릴리스이며, 다음과 같은 수정 사항이 포함되어 있습니다.

  • CNAME 및 에지 재정의 at.js 1을 사용할 때 문제를 해결했습니다.x 가 서버 도메인을 잘못 만들어 Target 요청에 실패할 수 있습니다. (TNT-35064)

at.js 2.3.1 릴리스(2020년 6월 15일)

at.js 유지 관리 릴리스이며, 다음과 같은 개선 기능 및 수정 사항이 포함되어 있습니다.

  • targetGlobalSettings를 통해 deviceIdLifetime 설정을 재정의할 수 있게 했습니다. (TNT-36349)
  • CNAME 및 에지 재정의 at.js 2를 사용할 때 문제를 해결했습니다.x 가 서버 도메인을 잘못 만들어 Target 요청에 실패할 수 있습니다. (TNT-35065)
  • Target 확장 v2 및 Adobe Analytics Launch 확장을 사용할 때 Target이(가) Analytics sendBeacon 호출을 지연시키는 문제를 해결했습니다. (TNT-36407, TNT-35990, TNT-36000)

at.js 버전 2.3.0 (2020년 3월 25일 목요일)

at.js 유지 관리 릴리스이며, 다음과 같은 개선 기능 및 수정 사항이 포함되어 있습니다.

  • 전달된 Target 오퍼를 적용할 때 페이지 DOM에 추가되는 SCRIPT 및 STYLE 태그에 대한 콘텐츠 보안 정책 임시 설정을 지원합니다. at.js에서 적용된 오퍼에 해당 스크립트 및 스타일 태그 주석을 설정할 수 있도록 고객은 targetGlobalSettings.cspScriptNonce 및 targetGlobalSettings.cspStyleNonce을(를) 설정할 수 있습니다. 자세한 내용은 targetGlobalSettings를 참조하십시오.
  • Google Tag Manager 배포용 Google Closure 컴파일러로 at.js를 컴파일할 때 발생하는 문제를 수정했습니다.
  • 고객 구현과 충돌을 방지하기 위해 at.js 검사 쿠키의 이름을 check에서 at_check(으)로 변경했습니다.

at.js 버전 1.8.1 (2020년 3월 25일 목요일)

at.js 유지 관리 릴리스이며, 다음과 같은 개선 기능 및 수정 사항이 포함되어 있습니다.

  • 고객 구현과 충돌을 방지하기 위해 at.js 검사 쿠키의 이름을 check에서 at_check(으)로 변경했습니다.

at.js 버전 2.2.0(2019년 10월 10일)

이번 at.js 릴리스에는 다음과 같은 개선 사항 및 수정 사항이 포함되어 있습니다.

  • 페이지 요소에 Adobe Analytics 코드가 없을 때 클릭 추적이 Analytics for Target​(A4T)에서 전환을 보고하지 않는 문제를 해결했습니다.
  • 웹 페이지에서 ECID(Experience Cloud ID Service) v4.4와 at.js 2.2를 모두 사용할 때 성능이 향상되었습니다.
  • 이전에는 at.js가 경험을 가져오기 전에 ECID가 두 번의 차단 호출을 했습니다. 이것이 한 번의 호출로 줄어들어 성능이 크게 향상되었습니다.
  • 기본 오퍼의 이벤트 토큰이 전송된 알림에 포함되지 않던 잘못된 프리페치된 보기 처리가 수정되었습니다.
노트
ECID 확장을 v4.4로 업그레이드하여 향상된 성능을 이용해 보십시오.
  • at.js 버전 2.2에서는 serverState이라는 새 설정도 제공합니다. 이 설정은 Target의 하이브리드 통합이 구현될 때 페이지 성능을 최적화하는 데 사용할 수 있습니다. 하이브리드 통합은 클라이언트측에서 at.js v2.2+를 사용하고 있으며, 서버측에서 배달 API 또는 Target SDK을 모두 사용하고 있음을 의미합니다. serverState은(는) at.js v2.2+에서 서버측에서 가져온 콘텐츠에서 직접 경험을 적용하고 서비스되는 페이지의 일부로 클라이언트에 반환할 수 있는 기능을 제공합니다. 자세한 내용은 targetGlobalSettings의 "serverState"를 참조하십시오.

at.js 버전 1.8.0(2019년 10월 10일)

이번 at.js 릴리스에는 다음과 같은 개선 사항 및 수정 사항이 포함되어 있습니다.

  • 웹 페이지에서 ECID(Experience Cloud ID Service) v4.4와 at.js 1.8을 모두 사용할 때 성능이 향상되었습니다.
  • 이전에는 at.js가 경험을 가져오기 전에 ECID가 두 번의 차단 호출을 했습니다. 이것이 한 번의 호출로 줄어들어 성능이 크게 향상되었습니다.
노트
ECID 확장을 v4.4로 업그레이드하여 향상된 성능을 이용해 보십시오.

at.js 버전 2.1.1(2019년 7월 24일)

at.js 유지 관리 릴리스이며, 다음과 같은 개선 기능 및 수정 사항이 포함되어 있습니다.

(괄호로 묶인 문제 번호는 내부 Adobe용입니다.)

  • Visual Experience Composer(VEC)의 목표 및 설정 페이지에서 클릭 추적 지표를 사용할 때 여러 개의 비콘이 실행되는 문제를 해결했습니다. (TNT-32812)
  • triggerView() 이 오퍼를 두 번 이상 렌더링하지 않는 문제를 해결했습니다. (TNT-32780)
  • triggerView() 이 요청에서 MCID(Marketing Cloud ID) 정보가 포함되어 있는지 확인하는 문제를 해결했습니다. (TNT-32776)
  • 저장된 보기가 없는 경우에도 triggerView() 알림이 실행되지 않는 문제를 해결했습니다. (TNT-32614)
  • URL에 잘못된 형식의 쿼리 문자열 매개 변수가 포함되어 있을 때 decodeURIcomponent를 사용하여 오류가 발생하는 문제를 해결했습니다. (TNT-32710)
  • 이제 Navigator.sendBeacon() API를 통해 전송된 배달 요청의 컨텍스트에서 비콘 플래그가 'true'로 설정됩니다. (TNT-32683)
  • 일부 고객의 웹 사이트에서 추천 오퍼가 표시되지 않는 문제를 해결했습니다. 고객이 배달 API 호출에서 오퍼 콘텐츠를 볼 수 있지만 오퍼가 웹 사이트에 적용되지 않았습니다. (TNT-32680)
  • 여러 경험에서 클릭 추적이 예상대로 작동되지 않는 문제를 해결했습니다. (TNT-32644)
  • 첫 번째 지표 렌더링이 실패한 후 at.js에서 두 번째 지표를 적용하지 못했던 문제를 해결했습니다. (TNT-32628)
  • 요청 페이로드가 쿼리 매개 변수 또는 요청 페이로드에 존재하지 않는 mbox3rdPartyId 함수를 사용하여 targetPageParams을 전달할 때 발생하는 문제를 해결했습니다. (TNT-32613)
  • Chromium 기반 브라우저(Google Chrome 포함)에서 디스플레이 및 클릭 알림 응답이 차단되는 문제를 해결했습니다. (TNT-32290)

at.js 버전 2.1.0(2019년 6월 3일)

이 릴리스에는 다음과 같은 기능 및 개선 사항이 포함되었습니다.

  • Adobe 옵트인(Opt-in) 지원: Adobe 옵트인(Opt-in)은 동의 관리 플랫폼과 Adobe 솔루션과의 통합을 간소화하는 방법입니다. Adobe 옵트인에 대한 자세한 내용은 개인 정보 및 GDPR(일반 데이터 보호 규정)을 참조하십시오.

  • 업계 표준 CSP 준수: at.js는 더 이상 eval()을 사용하여 JavaScript를 실행하지 않습니다.

  • 클라이언트 측 분석 로깅: 클라이언트 측이든 아니면 서버측이든 간에 분석 데이터를 Adobe Analytics에 보내는 방법을 고객이 완벽하게 제어할 수 있도록 합니다.

    자세한 내용은 클라이언트측 Analytics 로깅을 참조하십시오.

  • 알림 보내기: 경험이 applyOffer() 또는 applyOffers() 대신 코드로 렌더링될 때 개발자가 알림을 전송할 수 있습니다.

    자세한 내용은 adobe.target.sendNotifications(options)를 참조하십시오.

  • at.js 크기가 24%까지 줄어듦: at.js의 크기가 24%까지 줄어듭니다. 파일 크기가 작을수록 페이지 로드 성능이 향상되고 페이지의 at.js 다운로드 시간이 줄어듭니다.

at.js 버전 2.0.1(2019년 3월 19일)

유지 관리 릴리스이며, 다음과 같은 개선 기능 및 수정 사항이 포함되어 있습니다.

(괄호로 묶인 문제 번호는 내부 Adobe용입니다.)

  • 특정 고객에 대해 JavaScript 예외가 발생한 DOM 폴링 코드의 경합 조건을 수정했습니다. (TNT-31869)
  • 보기가 렌더링되었다는 알림이 클릭 추적 이벤트 핸들러에서 분리되었습니다. 처음에는 렌더링된 보기에 속하는 클릭 이벤트 처리기를 연결할 수 없는 경우 Target에서 알림을 보내지 않았습니다. 이제 클릭 요소를 찾을 수 없는 경우에도 Target에서 보기 알림을 보냅니다. (TNT-31969)
  • request-succeeded 이벤트 리디렉션 플래그가 항상 true로 설정되는 문제가 해결되었습니다. (TNT-31907)
  • 요소가 누락된 경우에도 VEC 재정렬 작업이 성공으로 기록되는 문제가 해결되었습니다. (TNT-31924)
  • 특정 고객에 대한 알림에 엔터프라이즈 권한 속성 토큰이 포함되지 않는 문제가 해결되었습니다. (TNT-31999)

at.js 버전 1.7.1(2019년 3월 19일)

유지보수 릴리스이며, 다음과 같은 수정 사항이 포함되어 있습니다.

(괄호로 묶인 문제 번호는 내부 Adobe용입니다.)

  • 특정 고객에 대해 JavaScript 예외가 발생한 DOM 폴링 코드의 경합 조건을 수정했습니다. (TNT-31869)

at.js 버전 2.0.0

at.js 2에서는 차세대 클라이언트측 기술에 대한 개인화를 실행하도록 기업을 지원하는 다양한 기능 세트를 제공합니다. 이 새로운 버전은 단일 페이지 애플리케이션(SPA)과 조화로운 상호 작용을 하도록 at.js를 업그레이드하는 데 주력하고 있습니다.

at.js 2.x를 사용하면 이전 버전에서 사용할 수 없는 다음과 같은 몇 가지 이점이 있습니다.

  • 페이지 로드 시 모든 오퍼를 캐시하여 여러 서버 호출을 하나의 서버 호출로 줄일 수 있습니다.
  • 오퍼가 기존 서버 호출로 인해 초래되는 지연 없이 캐시를 통해 즉시 표시되므로 사이트에서 최종 사용자의 경험을 크게 향상시킬 수 있습니다.
  • 간단한 1줄의 코드 및 일회용 개발자 설정으로 마케터가 단일 페이지 애플리케이션에서 시각적 경험 작성기(VEC)를 통해 A/B 및 경험 타기팅 (XT) 활동을 만들고 실행할 수 있도록 할 수 습니다.

at.js 2.x에서는 다음과 같은 새로운 기능을 도입했습니다.

  • getOffers()
  • applyOffers()
  • triggerView()

다음 함수는 at.js 2.x의 도입으로 더 이상 사용되지 않습니다.

  • mboxCreate()
  • mboxDefine
  • registerExtension()

자세한 내용은 at.js 1.x에서 at.js 2.x로 업그레이드 및 at.js 함수를 참조하십시오.

노트
일반 데이터 보호 규정(GDPR)에 대한 Adobe 옵트인 지원이 필요한 경우, 현재 at.js 1.7.0 또는 at.js 2.1.0 이상을 사용해야 합니다.

at.js 버전 1.7.0

at.js 1.7.0에서는 Adobe 옵트인을 지원합니다. Adobe 옵트인(Opt-in)은 동의 관리 플랫폼과 Adobe 솔루션과의 통합을 간소화하는 방법입니다.

Adobe 옵트인에 대한 자세한 내용은 개인 정보 보호 및 일반 데이터 보호 규정(GDPR)을 참조하십시오.

또한 이 릴리스에서는 Target이(가) 리디렉션 URL에서 발생하는 매개 변수로 리디렉션 URL 매개 변수를 무시할 수 있는 문제를 수정합니다.

노트
GDPR에 대한 Adobe 옵트인 지원이 필요한 경우 현재 at.js 1.7.0 또는 at.js 2.1.0 이상을 사용해야 합니다.

at.js 버전 1.6.4

at.js 1.6.4는 유지보수 릴리스이며 다음 문제를 해결합니다.

  • Microsoft Internet Explorer 11에서 중복된 오퍼가 적용되는 경합 조건 매니페스트를 수정했습니다.

at.js 버전 1.6.3

at.js 버전 1.6.3에는 다음의 수정 사항과 개선 사항이 포함되어 있습니다.

  • 이제 선택기는 십진수, 하이픈 두 개 또는 뒤에 십진수가 있는 하이픈(예: #-123)으로 시작하는 ID 또는 CSS 클래스를 포함하는 경우 CSS가 이스케이프 처리됩니다. (TNT-31061)
  • 동일한 CSS 선택기에 적용되는 서로 다른 활동의 시각적 경험 작성기(VEC) 오퍼가 활동 우선순위를 준수하지 않는 at.js 1.6.2에서 발생하는 문제를 수정했습니다. (TNT-31052)
  • 약속에 대한 기본 지원이 없는 환경에서 약속 시간 제한 관련 문제를 해결했습니다. (TNT-30974)
  • 이제 콘텐츠 렌더링 실패 이벤트를 통해 문제가 올바로 캡처되고 보고됩니다. 이전에는 사실이 아님에도 불구하고 JavaScript가 성공적으로 실행된 것으로 보고되었습니다. (TNT-30599)