Release Notes

v2.4.0 - 2025년 12월 8일

새로운 기능

• 카드형 배너 표준형 광고: 복수개의 광고를 표시하는 카드형 배너 표준형 광고를 요청할 수 있습니다.

• minWidth 옵션 추가: 변동 사이즈(FLUID) 배너에 최소 너비를 설정할 수 있는 minWidth 옵션이 추가되었습니다. 이미지 배너, 프리미엄 배너 이미지형, 프리미엄 배너 동영상형에서 사용할 수 있습니다.

• resizeDebounce 옵션 추가: 변동 사이즈(FLUID) 배너에서 리사이즈 이벤트의 debounce 시간을 설정할 수 있는 resizeDebounce 옵션이 추가되었습니다. 이미지 배너, 프리미엄 배너 이미지형, 프리미엄 배너 동영상형에서 사용할 수 있습니다.

• backgroundOpacity, expandedBackgroundOpacity, ctaBackgroundOpacity 옵션 추가: 광고의 배경 불투명도를 설정할 수 있는 ~Opacity 옵션이 추가되었습니다. 같은 역할을 하는 기존의 ~Transparency 옵션은 3.X.X 버전에서 deprecated 될 예정입니다.

• beginOcclusion / endOcclusion 메소드 추가: 팝업이나 모달이 열릴 때 광고를 가림 처리하고, 닫힐 때 가림을 해제할 수 있는 beginOcclusion / endOcclusion 메소드가 추가되었습니다. 특정 슬롯 또는 모든 슬롯에 대해 광고 가림 처리를 할 수 있습니다.

기타

• 팝업 N개 성과 수집 관련 기능이 개선되었습니다.

• nestads.dismiss() 메소드의 동작 방식이 단순 display 설정 변경에서 detach로 변경되었습니다.

---

v2.3.1 - 2025년 11월 19일

새로운 기능

• 어드민에 PC/Mobile 단일 게재 위치 기능이 추가되었습니다. 이에 따라 SDK에서도 광고 요청이 발생한 환경(PC 또는 Mobile)에 맞는 레이아웃이 자동으로 적용됩니다.

버그 수정

• 게재위치 고정 사이즈가 배너의 크기보다 작을 때 배너가 일부 잘리는 현상을 수정하였습니다.

• 프리미엄 배너 동영상형이 한 페이지에 여러 개 일 때 나오는 버그를 수정하였습니다.

기타

• 프리미엄 배너의 힌트에셋이 중복 인정 여부에 상관없이 항상 집계되도록 개선되었습니다.

• 짧은 동영상일 때 발생할 수 있는 잠재적 재생 로깅 버그를 수정하였습니다.

• 프리미엄 배너의 배경색을 설정하지 않았을 때 기본 배경색을 수정하였습니다.

  • 확장 전 배너: 색상: 소재 이미지 좌표 내 1px 색상 (구할 수 없는 경우 #fff), 불투명도 80%

  • 확장 후 배너: 소재 이미지 좌표 내 1px 색상 (구할 수 없는 경우 #000), 불투명도 80%

---

v2.3.0 - 2025년 8월 18일

새로운 기능

• 팝업 N개 배너 표준형 광고: 팝업 배너 표준형 광고를 요청할 때 여러 개의 광고를 동시에 요청할 수 있는 기능이 추가되었습니다.

• 팝업 배너 광고 옵션에 radius옵션이 추가되었습니다.

• 프리미엄 배너 옵션에 힌트에셋 사이즈가 추가되었습니다. 이제 프리미엄 배너 힌트에셋의 사이즈를 선택할 수 있습니다.

버그 수정

• 화면에 배너가 안 보이는 초기 상태에서 slotVisibilityChanged 이벤트의 inViewPercentage property 가 100 으로 반환되는 버그를 수정하였습니다.

• 화면에 배너가 로딩되기 전 setAdIframeTitle 을 호출하면 title이 적용되지 않는 버그를 수정하였습니다.

기타

• 광고 옵션에 maxNumberOfAds 옵션이 추가되었습니다.

• 광고 옵션에 creativeSpecCode 옵션이 추가되었습니다.

• 광고 옵션에 carousel 옵션이 추가되었습니다.

• 광고 옵션에 adList 옵션이 추가되었습니다.

• 이벤트 객체에 PopupBannerListViewClickedEvent 이벤트가 추가되었습니다.

---

v2.2.6 - 2025년 7월 31일

새로운 기능

• 새로운 터치 기반 이벤트 4종이 추가되었습니다. 광고 슬롯에 대한 사용자의 터치 동작을 실시간으로 감지하고 추적할 수 있습니다.

  • 이미지 배너, 프리미엄 배너 광고에서 동작합니다.

추가된 이벤트

이벤트 이름	설명
slotTouchStart	슬롯에 터치가 시작될 때 발생
slotTouchMove	터치한 손가락이 움직일 때 발생
slotTouchEnd	터치가 끝나고 손가락이 떨어질 때 발생
slotTouchCancel	시스템 또는 브라우저에 의해 터치가 취소될 때 발생

---

v2.2.5 - 2025년 7월 24일

기타

• 매체 맞춤 타겟팅 값 타입(string[])이 추가되었습니다.

---

v2.2.4 - 2025년 7월 15일

새로운 기능

• nestads.destroySlot 함수가 추가되었습니다.

버그 수정

• Slot에 해당하는 Element가 DOM에서 떨어진 후 다시 display() 했을 때 광고가 표기되지 않는 현상을 수정하였습니다.

---

v2.2.3 - 2025년 7월 15일

버그 수정

• 광고 Element가 DOM에서 떨어진 후 다시 display() 했을 때 광고가 표기되지 않는 현상을 수정하였습니다.

---

v2.2.2 - 2025년 7월 8일

버그 수정

• 변동 사이즈 적용 시 배너의 height이 150px 미만인 경우 150px 로 설정되는 버그를 수정하였습니다.

---

v2.2.1 - 2025년 7월 2일

새로운 기능

• 이미지 배너 광고에 변동 (FLUID) 사이즈를 설정할 수 있는 기능이 추가되었습니다.

기타

• 이미지 배너 광고의 radius 값이 default: 0, max: 30 으로 변경되었습니다.

버그 수정

• window.nestads.cmd 초기화 전 스크립트 로드가 완료되면 발생하는 버그를 수정했습니다.

---

v2.2.0 - 2025년 5월 29일

새로운 기능

• 광고상품별 중복 인정 성과 상태 값에 따라 트래킹 횟수를 조절하는 기능이 추가되었습니다.

버그 수정

• 프리미엄 배너에서 특정 레이아웃, 특정 사이즈 일 때 렌더링 버그를 수정하였습니다.

• 프리미엄 배너에서 확장 후 배너 노출된 후 닫기 버튼 클릭 시 힌트에셋 모션이 정지되어 있는 현상을 수정하였습니다.

• 프리미엄 배너의 특정 레이아웃에서 광고주명 클릭시 랜딩이 현재탭으로 이동되는 현상을 수정하였습니다.

기타

• 프리미엄 배너의 동영상형의 확장형 노출 트래킹 시점을 수정하였습니다. (동영상 노출 -> 썸네일 노출 시)

• 프리미엄 배너의 동영상형의 재생조건이 수동재생일 때 재생버튼이 나오는 시점을 수정하였습니다.

• 프리미엄 배너의 일부 스타일 및 터치 영역을 수정하였습니다.

• 알 수 없는 에러 발생시 에러 메세지를 "Unknown" 이 아닌 본 메세지로 내려주도록 수정하였습니다.

---

v2.1.3 - 2025년 5월 8일

새로운 기능

• 팝업 배너 표준형 광고: 팝업 배너 표준형 광고를 요청할 수 있습니다.

---

v2.1.2 - 2025년 4월 30일

새로운 기능

• 프리미엄 배너 이미지 광고 옵션에 radius옵션이 추가되었습니다. 확장 전 이미지와 확장 후 이미지의 radius를 조정할 수 있습니다.

• 프리미엄 배너 동영상 광고 옵션에 radius옵션이 추가되었습니다. 확장 전 이미지와 확장 후 동영상의 radius를 조정할 수 있습니다.

---

v2.1.1 - 2025년 4월 18일

새로운 기능

• 오디언스 파라미터: 광고 요청시 오디언스 파라미터를 setTargeting에 추가하여 요청할 수 있습니다.

• 커스텀형 광고: 광고 로더를 사용해 커스텀 광고를 요청할 수 있습니다.

버그 수정

• 에러 로그를 보낼 때 발생하는 버그를 수정하였습니다.

---

v2.1.0 - 2025년 4월 15일

새로운 기능

• 프리미엄 배너 표준형 광고: 프리미엄 배너 표준형 광고를 요청할 수 있습니다.

기타

• 이미지 배너 광고의 애드뱃지 위치를 수정하였습니다.

---

v2.0.5 - 2025년 2월 3일

버그 수정

• 에러 로그 전송 시 발생할 수 있는 버그를 수정하였습니다.

• 에러 로그 전송 필드를 추가하였습니다.

기타

• 내부 코드가 타입 스크립트로 전환되었습니다.

---

v2.0.4 - 2024년 9월 11일

버그 수정

• 에러 로그 전송 시 발생할 수 있는 버그를 수정하였습니다.

---

v2.0.3 - 2024년 8월 16일

버그 수정

• 노출로그 전송 시 발생할 수 있는 버그를 수정하였습니다.

기타

• ResizeObserver, IntersectionObserver 를 지원하지 않는 브라우저를 위한 Polyfill 을 추가하였습니다.

• 이미지 배너의 새로운 미디어 스펙 지원(애드뱃지)을 위한 사전 코드를 적용하였습니다.

---

v2.0.2 - 2024년 8월 8일

기타

• 통신 에러 발생시 로그 강화를 하였습니다.

---

v2.0.1 - 2024년 8월 5일

버그 수정

• 광고 요청시 디스크 캐시를 사용하는 버그를 수정하였습니다.

---

v2.0.0 - 2024년 7월 26일

새로운 기능

• NestAds Web SDK 가 새로운 구조로 개발되었습니다.