본문으로 건너뛰기

Release Note

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​

  • 네이티브 link 클릭 처리 로직 수정

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​

  • Release Date
    • 2025-03-12
  • Feature
    • 내부 코드 리팩토링 및 로깅 설정 변경

2.36.0​

  • Release Date
    • 2025-02-26
  • Feature
    • VideoController.getVolume, VideoController.setVolume 추가

2.35.0​

  • Release Date
    • 2025-02-20
  • Feature
    • br 광고 요청 파라미터 추가

2.34.2​

  • Release Date
    • 2025-02-13
  • Feature
    • 내부 설정 변경

2.34.1​

  • Release Date
    • 2025-02-12
  • Feature
    • 내부 설정 변경

2.34.0​

  • Release Date
    • 2025-02-12
  • Feature
    • Adslot.getNativeAdVisualId 인터페이스 추가
  • Fix
    • 광고 복원 시 버그 수정

2.33.0​

  • Release Date
    • 2024-11-20
  • Feature
    • 광고 복원 시 슬롯 이벤트 중복 발화 검증

2.32.1​

  • Release Date
    • 2024-10-29
  • Feature
    • adDeduplicationManager.restoreAds API 호출 시 비정상적인 iframe height 값으로 복원 방지

2.32.0​

  • Release Date
    • 2024-09-27
  • Feature
    • removeEventListener 인터페이스 추가
    • 바운스백 로그 시 bbt 파라미터 추가

2.31.0​

  • Release Date
    • 2024-09-25
  • Feature
    • RevisedNativeMeta 타입 재정의 및 RevisedNativeMeta 생성 로직 수정

2.30.2​

  • Release Date
    • 2024-08-29
  • Fix
    • internalAPI.activateTouchStartInAosNaverApp API 수정

2.30.1​

  • Release Date
    • 2024-08-13
  • Feature
    • nativeData 관련 신규 타입 및 부가 스타일 속성 추가
  • Fix
    • Teads nofill의 경우 stat 코드 추가

2.30.0​

  • Release Date
    • 2024-08-07
  • Feature
    • setContentId 인터페이스 추가
    • bounceback 지원 범위 확대

2.29.0​

  • Release Date
    • 2024-07-09
  • Feature
    • 네이티브 adm에 대해 encoded 설정된 값일 경우 decodeURIComponent 처리 추가

2.28.0​

  • Release Date
    • 2024-06-04
  • Feature
    • nac module 스크립트 로드 및 파라미터 획득
    • NdaPreviewer 미리보기 모듈 safeFrame 설정 API 추가

2.27.0​

  • Release Date
    • 2024-05-28
  • Feature
    • 광고 서버 도메인 및 URL path 변경 대응

2.26.0​

  • Release Date
    • 2024-05-16
  • Feature
    • adListener에 AD_MUTE_STATE_CHANGED 이벤트 추가

2.25.1​

  • Release Date
    • 2024-05-02
  • BugFix
    • 광고 랜더링 로직 버그 픽스

2.25.0​

  • Release Date
    • 2024-04-23
  • Features
    • 크롬 Topics API 지원
    • Iframe 내 렌더링 방식 수정
    • 캐로셀 광고 지원

2.24.1​

  • Release Date
    • 2024-04-16
  • Fix
    • 로그 에러 수정

2.24.0​

  • Release Date
    • 2024-04-16
  • Features
    • Teads 어댑터 추가
    • VideoController 메서드 userAction 전달
  • Fix
    • 중복제어 광고 노출 시 내부 버그 수정

2.23.1​

  • Release Date
    • 2024-02-22
  • Fix
    • 인모비 광고 버그 수정

2.23.0​

  • Release Date
    • 2024-02-06
  • Feature
    • sfAPI.getData에 crid 추가
    • 데모 플레이그라운드에 crid 별로 광고를 로드하는 페이지 추가
  • Fix
    • lads admute 처리 로직을 데코로 이관하기 위한 수정

2.22.2​

  • Release Date
    • 2024-01-09
  • Fix
    • GFP admin 광고 미리보기 기능 수정
    • 네이티브 광고 유형에 대해 adSlot.initEvent() API 지원

2.22.1​

  • Release Date
    • 2023-12-19
  • Features
    • 아동 사용자에 대해서는 ADID(ai) 파라미터 전송되지 않도록 수정
      • gladsdk.setPrivacySettings(privacySettingsConfig) API로 전달된 underAgeOfConsent(tfua) 또는 childDirectedTreatment(tfcd) 값이 'true'인 경우에 해당

2.22.0​

  • Release Date
    • 2023-12-12
  • Features
    • iframe keyboard, mouse, wheel 이벤트 전달 추가
    • 네이티브 광고 'ctaBgColor', 'promotion2BgColor' 속성 참조 수정
    • 'Empty render type' / 'No ad' 케이스에 대한 에러 메시지 분리
  • Fix
    • AD_LOADED 이벤트 발생 이후 iframe 로드 에러가 발생할 경우 다음 광고를 처리하지 못하는 버그 수정

2.21.1​

  • Release Date
    • 2023-11-07
  • Fix
    • dispatchTouchEvent 로직 수정

2.21.0​

  • Release Date
    • 2023-11-06
  • Features
    • displayAdWithResponse API 추가
    • getAdCallQuery API 추가
    • VideoController 기능 추가
  • Fix
    • iFrame에서 에러 발생 시 이벤트리스너 & adMute를 삭제하지 않도록 수정
    • Native Simple 파싱 로직 제거

2.20.0​

  • Release Date
    • 2023-10-10
  • Features
    • ABTest 지원 (gladsdk.setSegmentForABT)

2.19.2​

  • Release Date
    • 2023-09-07
  • Features
    • 2.19.1 버전에 추가된 Adapter 광고 응답 validation 수정사항 제거
    • Empty 광고 처리 validation 추가
    • pickedAdapter를 접근할 수 없는 에러 수정

2.19.1​

  • Release Date
    • 2023-09-05
  • Fix
    • Adapter 광고 응답 validation 수정

2.19.0​

  • Release Date
    • 2023-08-01
  • Features
    • sfAPI.addAdMuteEventListener API 추가

2.18.0​

  • Release Date
    • 2023-07-27
  • Features
    • SDK 개발자 도구 추가
  • Fix
    • nullish-coalescing-operator 오사용 수정

2.17.1​

  • Release Date
    • 2023-07-13
  • Fix
    • 모든 adapter에서 adContainer.innerHTML을 빈 스트링("")으로 초기화

2.17.0​

  • Release Date
    • 2023-06-29
  • Features
    • Safeframe 기능 바인딩 시점 변경
    • Safeframe 아웃스트림 유효노출 자동재생 스펙 변경 지원
    • SKAdNetwork RegisterSKADNetwork API 적용
    • Sentry Integration 설정 변경
    • CustomParam 전역 인터페이스 추가

2.16.1​

  • Release Date
    • 2023-06-15
  • Features
    • 특정 웹뷰에서 instanceof 연산 오류 수정

2.16.0​

  • Release Date
    • 2023-06-15
  • Features
    • CMP 적용 지원 관련 인터페이스 구현

2.15.0​

  • Release Date
    • 2023-06-01
  • Features
    • 데모페이지에 waterfall / ad / adcall 렌더링 기능 추가
  • Fix
    • iframe uuid 기능 삭제
  • Refactoring
    • SafeFrame 패키지 리팩토링

2.14.1​

  • Release Date
    • 2023-05-16
  • Fix
    • native header, footer 관련 로직 삭제
    • PostMessage parInfo 속성 추가

2.14.0​

  • Release Date
    • 2023-05-09
  • Features
    • 포커스 유효노출 기능 추가

2.13.0​

  • Release Date
    • 2023-04-25
  • Features
    • BridgeJS 리뉴얼 버전 신규 인터페이스 스펙 추가

2.12.1​

  • Release Date
    • 2023-04-18
  • Features
    • 커뮤니케이션 광고 컨텐츠 정보 파라미터 추가
  • Fix
    • 광고 슬롯 요소가 null일 경우 에러 처리

2.12.0​

  • Release Date
    • 2023-04-11
  • Fix
    • js 어댑터 클릭 처리 수정
    • 광고 슬롯 p / hb / hc 파라미터 처리 로직 수정
    • native의 media 에셋을 optional으로 수정

2.11.1​

  • Release Date
    • 2023-03-13
  • Fix
    • toggleExposureChanged를 사용할 경우 viewable impression 측정 시점이 달라지는 이슈 수정

2.11.0​

  • Release Date
    • 2023-03-02
  • Features
    • iFrame 내부에서 발생한 touch event를 전달 스펙 구현
    • iFrame wrapper 요소 line-height:0 스타일 추가
  • Refactoring iFrame 내부 element 요소 선택자 이름 수정

2.10.1​

  • Release Date
    • 2023-02-14
  • Feature
    • Legacy AD Mark 노출 기준 변경
    • EXPOSURE_CHANGED 이벤트 전달 시 exposedPercentage 파라미터 추가 전달
    • Staging Phase Adcall URL 설정 변경
  • Refactoring
    • GfpError 기본값 설정 방식 수정

2.10.0​

  • Release Date
    • 2023-02-07
  • Feature
    • 유효노출 발화 시 focus 여부를 확인할 수 있는 t1 파라미터 추가
    • 도메인에 상관없이 똑같은 UUID 값 획득
  • Refactoring
    • Gfp error message
    • Ad Interface

2.9.1​

  • Release Date
    • 2023-01-20
  • Feature
    • local, test, demo 빌드 시 latest 디렉토리 빌드
    • eslint 버전 업데이트, eslint 규칙 추가
    • commitlint subject-case 규칙 무시하도록 설정
    • sonarqube codesmell 제거 리팩토링
    • clickHandler 클릭 타입 추가
  • Bug Fix
    • sf-ext ResourceLoader css 로딩 처리 조건 수정

2.9.0​

  • Release Date
    • 2022-12-13
  • 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
    • 2022-12-01
  • Feature
    • iv 값이 비어있을 때 uuid 생성
    • webAppVersion 설정 값 추가
    • lerna version up 명령어 추가 & commitlint & changelog 자동화
  • Bug Fix
    • ivt 값 ios / aos 변경

2.7.1​

  • Release Date
    • 2022-11-22
  • Features
    • stage gfp 광고 요청 롤백
    • 쇼핑 소식 광고 스펙 지원

2.7.0​

  • Release Date
    • 2022-11-17
  • 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​

  • Features
    • setClickHandler 로직 오류 수정

2.4.0​

  • Features
    • setClickHandler 적용 범위 추가
      • admute privacy 버튼 클릭 시에도 이벤트 핸들러 발화
    • gfp 식별자 uuid 추가
    • adcall 요청 시 Network Type 추가

2.3.0​

  • Features
    • setClickHandler 인터페이스 구현

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
    • hostMeta 전달 오류 수정

0.4.1​

  • Features
    • 웹 SDK 버전별 빌드된 module 파일들을 개별 버전 디렉토리로 분리 적용
    • staging 광고 요청 URL 리얼 기준으로 수정

0.4.0​

  • Features
    • postMessage 전송/수신 시 validation 적용
    • 네이티브 데코 클릭 처리 (ad-element-unit 없는 경우 처리)
  • Bug Fix
    • gfp sdk 미리보기 처리 오류 수정

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) 수정
      • mute 버튼 스타일 및 이미지 URI 변경
  • 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
    • safeFrame 설정 인터페이스 추가
      • 전역 혹은 개별 슬롯 단위로 설정 지원
  • 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​

  • Features
    • GFP adcall 응답 시간 측정

0.1.3​

  • Bug fix
    • google GPT googletag 변수 참조 수정
      • ad element 가 DOM tree에 존재하지 않을 경우 googletag 변수 선언 전 GptBannerAdapter.destroy() 처리 시 googletag 변수 참조 에러 발생하는 이슈 대응

0.1.2​

  • Bug fix
    • SDK 내부 누적시간 측정 오류 수정

0.1.1​

  • Bug fix
    • GPT library 로딩 실패 시 googletag 변수 참조 에러 처리 및 stat 값 수정 반영

0.1.0​

  • Features
    • GFP SDK S2S 네이티브 광고 스펙 지원