이 페이지에서
3.12.1 (2026-11-05)
Changed
뒤로가기 판정(isHistoryBack)에 deprecated된 performance.navigation.type 대신 Navigation Timing Level 2(getEntriesByType('navigation')) 사용 (미지원 환경은 기존 방식으로 폴백, 동작 변화 없음)
Fixed
단일 형태(광고 슬롯 없는) 네이티브 광고 클릭 시 bounce-back이 발생하지 않던 문제 수정
3.12.0 (2026-10-20)
Changed
중복 제어 적용 광고 슬롯을 최대 10개로 제한 (maxDedupReqCount 상한 9, -1·음수·미지정 시 9로 처리)
Fixed
EMPTY 이벤트 리스너가 모든 ERROR 발생 시 호출되던 문제 수정 (빈 광고 응답일 때만 호출)
광고 iframe 및 AD 마크의 스크린리더 읽기 개선 (iframe title을 '광고'로 변경, AD 마크 대체 텍스트를 '광고 숨기기'에서 '광고 옵션'으로 변경)
3.11.0 (2026-10-07)
Changed
광고 슬롯 설정 속성 에 context 추가 — 컨텍스추얼 타겟팅 스크립트(ctx-sdk.js)의 recommend() 응답 res.context를 전달하면 광고 요청 ck 파라미터로 전송 (AdSlot.getContext()로 조회)
광고 슬롯 설정 속성 에 keyword 추가 — 매체가 직접 주입한 키워드 를 광고 요청 sk 파라미터로 전송 (AdSlot.getKeyword()로 조회)
광고 슬롯 설정 속성 에 enablePersistAd 추가 — 광고 슬롯 단위로 Persist 적용 여부 설정 (미지정 시 전역 설정을 따름). React SDK의 <AdSlotElement>도 adSlotOptions.enablePersistAd 지원
restoreAd() 시그니처를 restoreAd(adSlot?: AdSlot)로 변경. 이미 광고를 요청한 광고 슬롯도 저장된 광고가 있으면 해당 광고로 교체하며, 저장된 광고가 없으면 현재 광고를 유지
Fixed
restoreAd(adSlot)가 전달한 광고 슬롯 대신 전체 광고 슬롯을 복원하던 문제 수정
production 빌드의 광고 뮤트 라이브러리(glad-admute.js) 로드 경로가 stg로 설정되어 있던 문제 수정
structuredClone 미지원 환경에서 customParam에 string[] 값을 설정하면 p 파라미터가 [object Object]로 전송되던 문제 수정
세로형 광고의 privacy 확인 화면에서 "이 광고가 보이는 이유" 버튼 텍스트가 박스를 넘치던 문제 수정
3.10.7 (2026-07-23)
Changed
RevisedNativeMeta의 deprecated assets/slotAssets 필드 및 관련 hydration·post-process 코드 제거
3.10.6 (2026-06-23)
Fixed
TCF v2.2 TC String 조회 방식을 __tcfapi addEventListener로 변경
3.10.5 (2026-06-10)
Fixed
getStructuredUserAgent에서 "Not"으로 시작하는 placeholder 브랜드 필터를 제거하여 fullVersionList의 모든 브랜드를 그대로 노출하도록 수정
3.10.4 (2026-05-27)
Fixed
naverappapi.checkNetworkStatus() 호출 시 native bridge 에러가 getNetworkType/checkIsWIFI까지 전파되지 않도록 try-catch 처리
Lit visual 클릭 이벤트에서 anchor의 _$GfpLink를 safeframe에서 NDA native adapter로 전달하여 assetKey 없이도 link 정보 사용 가능하도록 수정
TOUCHSTART_IN_AOS_NAVERAPP 이벤트 리스너 누수 방지 (재호출 시 이전 리스너 정리)
3.10.2 (2026-05-07)
Changed
AdSlot에 setFrameless API 추가 — iFrame 격리 없이 페이지와 같은 창 내에서 광고를 렌더링할지 여부를 슬롯 단위로 설정 (네이티브 광고 타입 한정)
NdaLitNativeAdapter TOUCHSTART_IN_AOS_NAVERAPP 이벤트 지원
Fixed
Shadow DOM 내부 a 태그 클릭 처리 버그 수정
JsBanner/LitNative adapter privacy click 처리 버그 수정
3.10.0 (2026-04-30)
Changed
glog logger 연동 및 Sentry 관련 로직 제거
광고 요청 시 앱 SDK bridge의 av를 우선 사용하도록 변경
3.9.0 (2026-04-07)
Changed
UA-CH API를 통한 Structured User Agent(sua) 파라미터 수집 및 광고 요청 전달 지원
setGlobalEnv 파라미터 타입을 DeepPartial로 변경하여 중첩 객체의 일부 필드만 전달 가능하도록 개선
3.8.0 (2026-03-18)
Changed
Topics API 제거
Privacy Manager GPP CMI API 지원 추가
3.7.1 (2026-01-27)
Changed
unifiedIdMap 파라미터 추가
display-sdk-react 패키지 신규 추가
3.7.0 (2025-12-30)
Changed
gladsdk.restoreAd API 신규 추가
gladsdk.getAdCallQuery API ua 파라미터 추가
gladsdk.refresh API 실행 조건 버그 수정 (에러 상태 확인)
3.6.0 (2025-11-19)
Changed
슬롯별 activateIframeEvent 설정 메소드(setActivateIframeEvent) 추가
3.5.1 (2025-11-11)
Changed
3.5.0 (2025-10-21)
Changed
광고 로드 발생 이전 로드 에러 발생 시 중복 adError 호출되는 이슈 수정
슬롯별 setForceSafeFrame 동작하지 않던 문제 수정
네이티브 소재 클릭 처리 처리 조건 수정
3.4.4 (2025-10-21)
Changed
3.4.3 (2025-09-25)
Changed
3.4.2 (2025-09-09)
Changed
3.4.1 (2025-09-09)
Changed
beacon API 사용 시 blob 객체 사용
3.4.0 (2025-09-04)
Changed
SF 기반 어댑터에 clickHandler 설정 시 safeframe 내부에서 이를 반영할 수 있도록 코드 수정
unclickable 속성이 true인 clickableAsset인 경우 해당 에셋에 포함된 하위 link 에셋을 삭제
AdRequestBuilder.build() 함수 시그니처 변경 / cancelSource 획득 내재화
3.3.2 (2025-07-31)
Changed
Iframe 렌더링 시 setTimeout 삭제
3.3.1 (2025-07-08)
Fixed
3.3.0 (2025-07-02)
Changed
광고 이벤트 전달 시 광고 메타 정보(adContext, slotIndex) 전달
logger 리팩토링 및 Devtools 연동
3.2.0 (2025-06-11)
Changed
Skadn 통신 및 이벤트 전달 추가
AdRendered, Empty 이벤트 추가
LOADED 이후 에러 발생은 START_ERROR 처리
VideoController.removeEventListener 추가
Fixed
3.1.0 (2025-05-08)
Changed
ThirdPartyAdapter 타입 강화 (AdapterClass 타입 추가)
Fixed
SafeFrame 렌더링 타이밍 수정
jindo.js 적용 서비스에서 발생하는 전역 객체 관련 버그 수정
3.0.0 (2025-04-17)
BREAKING CHANGES
IE 11 지원 종료
callNativeBounce API 제거
Changed
setPhase API 추가
setGlobalConfig 속성 deprecate: debug, phase
setGlobalConfig 설정 가능 속성 추가: yob, gender, uct, uid, ai, iv
defineAdSlot 속성 deprecate: yob, gender, uct, uid, ai, iv
내부 코드 리팩토링
2.37.0
2.36.0
Release Date
Feature
VideoController.getVolume, VideoController.setVolume 추가
2.35.0
2.34.2
2.34.1
2.34.0
Release Date
Feature
Adslot.getNativeAdVisualId 인터페이스 추가
Fix
2.33.0
2.32.1
Release Date
Feature
adDeduplicationManager.restoreAds API 호출 시 비정상적인 iframe height 값으로 복원 방지
2.32.0
Release Date
Feature
removeEventListener 인터페이스 추가
바운스백 로그 시 bbt 파라미터 추가
2.31.0
Release Date
Feature
RevisedNativeMeta 타입 재정의 및 RevisedNativeMeta 생성 로직 수정
2.30.2
Release Date
Fix
internalAPI.activateTouchStartInAosNaverApp API 수정
2.30.1
Release Date
Feature
nativeData 관련 신규 타입 및 부가 스타일 속성 추가
Fix
Teads nofill의 경우 stat 코드 추가
2.30.0
Release Date
Feature
setContentId 인터페이스 추가
bounceback 지원 범위 확대
2.29.0
Release Date
Feature
네이티브 adm에 대해 encoded 설정된 값일 경우 decodeURIComponent 처리 추가
2.28.0
Release Date
Feature
nac module 스크립트 로드 및 파라미터 획득
NdaPreviewer 미리보기 모듈 safeFrame 설정 API 추가
2.27.0
Release Date
Feature
광고 서버 도메인 및 URL path 변경 대응
2.26.0
Release Date
Feature
adListener에 AD_MUTE_STATE_CHANGED 이벤트 추가
2.25.1
2.25.0
Release Date
Features
크롬 Topics API 지원
Iframe 내 렌더링 방식 수정
캐로셀 광고 지원
2.24.1
2.24.0
Release Date
Features
Teads 어댑터 추가
VideoController 메서드 userAction 전달
Fix
2.23.1
2.23.0
Release Date
Feature
sfAPI.getData에 crid 추가
데모 플레이그라운드에 crid 별로 광고를 로드하는 페이지 추가
Fix
lads admute 처리 로직을 데코로 이관하기 위한 수정
2.22.2
Release Date
Fix
GFP admin 광고 미리보기 기능 수정
네이티브 광고 유형에 대해 adSlot.initEvent() API 지원
2.22.1
Release Date
Features
아동 사용자에 대해서는 ADID(ai) 파라미터 전송되지 않도록 수정
gladsdk.setPrivacySettings(privacySettingsConfig) API로 전달된 underAgeOfConsent(tfua) 또는 childDirectedTreatment(tfcd) 값이 'true'인 경우에 해당
2.22.0
Release Date
Features
iframe keyboard, mouse, wheel 이벤트 전달 추가
네이티브 광고 'ctaBgColor', 'promotion2BgColor' 속성 참조 수정
'Empty render type' / 'No ad' 케이스에 대한 에러 메시지 분리
Fix
AD_LOADED 이벤트 발생 이후 iframe 로드 에러가 발생할 경우 다음 광고를 처리하지 못하는 버그 수정
2.21.1
2.21.0
Release Date
Features
displayAdWithResponse API 추가
getAdCallQuery API 추가
VideoController 기능 추가
Fix
iFrame에서 에러 발생 시 이벤트리스너 & adMute를 삭제하지 않도록 수정
Native Simple 파싱 로직 제거
2.20.0
Release Date
Features
ABTest 지원 (gladsdk.setSegmentForABT)
2.19.2
Release Date
Features
2.19.1 버전에 추가된 Adapter 광고 응답 validation 수정사항 제거
Empty 광고 처리 validation 추가
pickedAdapter를 접근할 수 없는 에러 수정
2.19.1
Release Date
Fix
Adapter 광고 응답 validation 수정
2.19.0
Release Date
Features
sfAPI.addAdMuteEventListener API 추가
2.18.0
Release Date
Features
Fix
nullish-coalescing-operator 오사용 수정
2.17.1
Release Date
Fix
모든 adapter에서 adContainer.innerHTML을 빈 스트링("")으로 초기화
2.17.0
Release Date
Features
Safeframe 기능 바인딩 시점 변경
Safeframe 아웃스트림 유효노출 자동재생 스펙 변경 지원
SKAdNetwork RegisterSKADNetwork API 적용
Sentry Integration 설정 변경
CustomParam 전역 인터페이스 추가
2.16.1
Release Date
Features
특정 웹뷰에서 instanceof 연산 오류 수정
2.16.0
2.15.0
Release Date
Features
데모페이지에 waterfall / ad / adcall 렌더링 기능 추가
Fix
Refactoring
2.14.1
Release Date
Fix
native header, footer 관련 로직 삭제
PostMessage parInfo 속성 추가
2.14.0
2.13.0
Release Date
Features
BridgeJS 리뉴얼 버전 신규 인터페이스 스펙 추가
2.12.1
Release Date
Features
Fix
2.12.0
Release Date
Fix
js 어댑터 클릭 처리 수정
광고 슬롯 p / hb / hc 파라미터 처리 로직 수정
native의 media 에셋을 optional으로 수정
2.11.1
Release Date
Fix
toggleExposureChanged를 사용할 경우 viewable impression 측정 시점이 달라지는 이슈 수정
2.11.0
Release Date
Features
iFrame 내부에서 발생한 touch event를 전달 스펙 구현
iFrame wrapper 요소 line-height:0 스타일 추가
Refactoring
iFrame 내부 element 요소 선택자 이름 수정
2.10.1
Release Date
Feature
Legacy AD Mark 노출 기준 변경
EXPOSURE_CHANGED 이벤트 전달 시 exposedPercentage 파라미터 추가 전달
Staging Phase Adcall URL 설정 변경
Refactoring
2.10.0
Release Date
Feature
유효노출 발화 시 focus 여부를 확인할 수 있는 t1 파라미터 추가
도메인에 상관없이 똑같은 UUID 값 획득
Refactoring
Gfp error message
Ad Interface
2.9.1
Release Date
Feature
local, test, demo 빌드 시 latest 디렉토리 빌드
eslint 버전 업데이트, eslint 규칙 추가
commitlint subject-case 규칙 무시하도록 설정
sonarqube codesmell 제거 리팩토링
clickHandler 클릭 타입 추가
Bug Fix
sf-ext ResourceLoader css 로딩 처리 조건 수정
2.9.0
Release Date
Feature
WF 유효노출 설정 처리 스펙 구현
광고 iframe 내부 영역 탭 포커싱 지원
axios 버전 업 & promise 전역 폴리필 삭제
ban-ts-ignore 사용시 eslint 에러가 발생하지 않도록 수정
pre-commit 명령어 수정, eslint max-warnings 옵션 추가
Bug Fix
sf-ext ResourceLoader css 로딩 처리 조건 수정
2.8.0
Release Date
Feature
iv 값이 비어있을 때 uuid 생성
webAppVersion 설정 값 추가
lerna version up 명령어 추가 & commitlint & changelog 자동화
Bug Fix
2.7.1
Release Date
Features
stage gfp 광고 요청 롤백
쇼핑 소식 광고 스펙 지원
2.7.0
Release Date
Features
[BridgeJS] DESTROYED 이벤트 유형 신규 지원 - 카타르월드컵 광고 대응
피드형 웹데코 CTA 버튼 색상값(ctaBgColor) 에셋 변경 대응
tivan 이벤트 트래킹 sendBeacon 사용 기준 변경
로컬/세션 스토리지 스코프 수정
Native Composite skadn 소재 storekit 랜딩 지원 -
2.6.0
Features
클릭 처리 로직 수정
outstream 기능 추가
2.5.0
Features
매체 커스텀 파라미터 (k:v) 에 대한 validation 추가
NativeData.desc3 에셋 처리 추가
네이티브 광고 리소스 파일 로딩 방식 개선
Bug Fix
exposureChanged 이벤트 지원 로직 수정
uuid 로컬스토리지 저장 센트리 에러 리포팅
2.4.1
2.4.0
Features
setClickHandler 적용 범위 추가
admute privacy 버튼 클릭 시에도 이벤트 핸들러 발화
gfp 식별자 uuid 추가
adcall 요청 시 Network Type 추가
2.3.0
2.2.0
Features
피드형 데코 지원 (exposure changed 기능 추가)
Bug Fix
postMessage origin 로직 오류 수정
2.1.0
Features
NAM Ad Unit Id 분기
ba/bx 파라미터 인코딩
postMessage validation 로직 수정
2.0.0
Features
Sentry 로깅 시 adSlot별 데이터 저장 및 Sentry 로깅 데이터 수정
adblock 대응 광고 요청 URL path 수정
광고 요청 네트워크 에러 요청 파라미터 추가
웹 SDK major 버전 업데이트 (0.6.0 -> 2.0.0)
Bug Fix
ResizeObserver loop limit 이슈 수정
센트리 소스맵 배포서버 emtpy map 파일 대체
commitHash 읽기 실패 시 에러 처리
0.6.0
Features
Sentry Tracing SDK 적용
ResizeObserver 도입, iframe document.body 기준 사이즈 변경 감지
광고 요청 파라미터 appName 기본값 설정
0.5.2
Features
Beacon API 방식으로 광고 로깅 파라미터 전송 시 특정 브라우저 하위 버전에서 URLSearchParams.prototype.toString() 함수 미구현으로 인한 파라미터값 누락 이슈 대응
0.5.1
Features
Beacon API 방식으로 광고 로깅 파라미터 전송 시 Blob 객체 타입 값으로 Content-Type 헤더 명시하여 전달하도록 수정
0.5.0
Features
광고 로그 발화 Beacon API 및 Axios 비동기 호출 방식 적용
광고 요청 network error 발생 시 에러 로그 발화 적용
웹 접근성 대응 광고 <iframe> title 속성값(AD) 추가
Native image/icon alt값 처리 로직 추가
Github Actions 실행을 위한 sonarqube.yaml 추가
toothless 보안 취약점 정적분석 이슈 대응 npm 의존성 버전 업데이트, jest 설정 코드 수정
bug fix
0.4.1
Features
웹 SDK 버전별 빌드된 module 파일들을 개별 버전 디렉토리로 분리 적용
staging 광고 요청 URL 리얼 기준으로 수정
0.4.0
Features
postMessage 전송/수신 시 validation 적용
네이티브 데코 클릭 처리 (ad-element-unit 없는 경우 처리)
Bug Fix
0.3.4
Bug Fix
AdDeduplicationManager.restoreAds 로직 수정
0.3.1
Bug Fix
Admute State의 persist 동작 오류 수정
0.3.0
Features
Ad Mute 기능 지원
adMuteCompleted 이벤트 리스너 추가
0.2.4
Features
라인 다크모드 대응 css(gfp-native-common.css) 수정
Bug fix
UAM 소재 center 정렬 설정 이슈 대응
SDK iframe inline style에 설정된 'display:block' 속성 제거
0.2.3
Bug fix
Inmobi 배너 랜더링 이슈 대응
responseSize.force 1 인 경우 iFrameHeight를 responseSize.height로 설정
empty 광고 유효노출 체크 해제 추가 대응
gladsdk.clearActiveViews 호출 시 unobserveEmptyAd 처리
0.2.2
Features
Bug fix
adSlot 신규 생성 시 기존에 설정된 hostMeta 정보 추가
0.2.1
Bug fix
부동산 iOS앱 서비스 장애 대응으로 인한 safeFrame 설정 임시 해제
0.2.0
Features
웹 SDK SKAdNetwork 2.0 스펙 처리 지원
safeFrame 설정 적용
PC 네이티브 광고 대응 반영
desc2, notice 항목 추가 및 네이티브 에셋 옵셔널 처리 수정
IE 브라우저 NodeList.prototype.forEach 미지원 대응
RenderType.NDA_BANNER_JS 처리 추가
promise-polyfill 적용(IE11 대응)
Bug fix
네이버앱 UA 판별 정규식 수정
퍼시스트 광고 초기화 시 체크 조건 버그 수정
0.1.12
Bug fix
composite ad LADS e100 로그 호출 관련 이전 버전 호환 로직 제거
0.1.11
Features
sonarqube 이관 및 code analysis fail 내역 수정
safeFrame resource 파일(r.html) 경로 설정 변경
Bug fix
LADS e100 로그 트래킹 1px viewable 유효 노출 기준으로 트래킹 반영
0.1.10
Bug fix
adSlot.refresh API 호출 시 google GPT destroySlots 정상 처리 안되는 이슈 대응
0.1.9
Bug fix
package.json browserslist 설정 추가
Webpack5 runtime code es5 지원
0.1.8
Features
M메인 개편 광고 적용 스펙 대응
scrollTarget 설정 인터페이스 추가
AdMediator, NdaBannerAdapter 비동기 처리 방어 코드 추가
iv(identifierForVendor) 파라미터 설정 추가
Webpack5 적용
0.1.7
Features
미리보기 SDK 추가
Native 광고 advertiser mute 추가
Bug fix
adSlot.setHostMeta boolean type 값 허용
ad-deduplication-chunk restoreAd 조건 체크 시 오류 수정
0.1.6
Features
google GPT 라이브러리 url 변경
OptimizeCSSAssetsPlugin minimizer 설정 추가
Bug fix
axios 인스턴스 생성 시 'x-xsrf-token' 요청 헤더 추가되지 않도록 처리
nda-js 서비스 iframe 내부 광고 랜더링 시 클릭 target 설정 조건 추가
0.1.5
Features
SafeFrame 소재 가운데 정렬 추가 스타일 적용
0.1.4
0.1.3
Bug fix
google GPT googletag 변수 참조 수정
ad element 가 DOM tree에 존재하지 않을 경우 googletag 변수 선언 전
GptBannerAdapter.destroy() 처리 시 googletag 변수 참조 에러 발생하는 이슈 대응
0.1.2
0.1.1
Bug fix
GPT library 로딩 실패 시 googletag 변수 참조 에러 처리 및 stat 값 수정 반영
0.1.0
Features
GFP SDK S2S 네이티브 광고 스펙 지원