이 페이지는 Cloud Translation API를 통해 번역되었습니다.

GPT 출시 노트

이 페이지에서는 Google 게시자 태그(GPT) 라이브러리의 프로덕션 업데이트에 관해 설명합니다. 이 페이지를 정기적으로 확인하여 새로운 기능이나 업데이트된 기능, 버그 수정, 알려진 문제, 지원 중단된 기능에 대한 공지를 볼 수 있습니다.

업데이트를 받으려면 이 페이지의 URL을 원하는 피드 리더에 추가하거나 Atom 1.0 또는 RSS 2.0 형식의 출시 노트 피드 직접 링크를 사용하세요.

출시일 이해하기

GPT 라이브러리의 모든 변경사항은 출시 전에 철저한 테스트를 거칩니다. 또한 출시는 예기치 않은 회귀로부터 더욱 안전하게 보호하기 위해 사용자에게 점진적으로 출시됩니다. 출시 중 어느 시점에서든 회귀가 발견되면 모든 사용자에게 도달하기 전에 전체 버전이 빠르게 폐기될 수 있습니다.

이로 인해 출시 날짜가 정확하지는 않습니다. 버전이 완전히 출시되는 데 며칠에서 몇 주까지 걸릴 수 있습니다. 즉, 사용자는 서로 다른 시점에 변경사항을 경험하게 됩니다. 아래에 제공된 날짜는 변경사항 적용이 모든 사용자에게 완료된 주의 시작을 반영합니다.

2024년 2월 19일이 포함된 주

사용자가 브라우저 탐색 메뉴와 상호작용할 때 GPT 관리 전면 광고를 표시할 수 있는 navBar 전면 광고 트리거가 추가되었습니다. 이 기능은 데스크톱 전용입니다.

예시는 웹 전면 광고 표시를 참고하세요.

2024년 2월 12일이 포함된 주

게시자 제공 신호 (PPS) 구성에 관한 지원을 추가했습니다.

GPT의 새로운 기능
객체	`googletag.config.PublisherProvidedSignalsConfig` `googletag.config.TaxonomyData`
속성	`googletag.config.PageSettingsConfig.pps` `googletag.config.PublisherProvidedSignalsConfig.taxonomies` `googletag.config.TaxonomyData.values`
유형	`googletag.config.Taxonomy`

SlotRenderEndedEvent.slotContentChanged가 항상 true이었던 버그가 수정되었습니다. 앞으로 이 속성은 슬롯의 콘텐츠가 변경된 경우에만 true이고 그렇지 않은 경우 (예: 광고가 채워지지 않은 경우) false입니다.

2024년 1월 29일이 포함된 주

광고 요청에 대한 네트워크 실패는 true로 설정된 isEmpty로 googletag.events.SlotRenderEndedEvent가 실행되어 게재 안 됨을 모방합니다. 이 이벤트를 수신하는 방법의 예는 광고 이벤트 리스너를 참고하세요. 변경사항에는 collapseEmptyDivs 사용 시 슬롯을 자동으로 접는 것이 포함됩니다.

데스크톱/태블릿 및 모바일 웹 (부분 화면)에서 광고 확장을 구성하기 위한 지원이 추가되었습니다.

GPT의 새로운 기능
객체	`googletag.config.AdExpansionConfig`
속성	`googletag.config.AdExpansionConfig.enabled` `googletag.config.PageSettingsConfig.adExpansion` `googletag.config.SlotSettingsConfig.adExpansion`

2023년 12월 11일이 포함된 주

사이드 레일 앵커 광고에 대한 지원이 추가되었습니다.

GPT의 새로운 기능
enum	`OutOfPageFormat.LEFT_SIDE_RAIL` `OutOfPageFormat.RIGHT_SIDE_RAIL`

2023년 11월 13일이 포함된 주

게시자 개인 정보 보호 처리 구성에 관한 지원을 추가했습니다.

GPT의 새로운 기능
함수	`googletag.setConfig()`
객체	`googletag.config.PageSettingsConfig` `googletag.config.PrivacyTreatmentsConfig`
속성	`googletag.config.PageSettingsConfig.privacyTreatments` `googletag.config.PrivacyTreatmentsConfig.treatments`
유형	`googletag.config.PrivacyTreatment`

Chrome 사전 렌더링 지원이 추가되었습니다. GPT가 페이지가 사전 렌더링 상태에 있음을 감지하면 페이지가 사용자에게 표시될 때까지 광고 요청이 지연됩니다.

2023년 10월 23일이 포함된 주

선택적 웹 전면 광고 트리거에 대한 지원이 추가되었습니다.

GPT의 새로운 기능
객체	`googletag.config.InterstitialConfig`
속성	`googletag.config.SlotSettingsConfig.interstitial`
유형	`googletag.config.InterstitialTrigger`

2023년 7월 24일이 포함된 주

Protected Audience API(이전의 FLEDGE)는 Chrome의 7월 출시와 함께 정식 버전으로 전환됩니다. 따라서 이제 GPT의 구성요소 입찰 관련 기능이 안정적인 것으로 간주됩니다.

실험용에서 안정화 버전으로 이동됨
객체	`googletag.config.ComponentAuctionConfig`
속성	`googletag.config.SlotSettingsConfig.componentAuction`

2023년 6월 19일이 포함된 주

업데이트: 2023년 7월 5일부터 GPT에서는 더 이상 오래된 버전의 자바스크립트 라이브러리를 게재하지 않으며, 해당 버전에 광고를 게재하지 않습니다. 자세한 내용은 이전 공지사항을 참고하세요.

www.googletagservices.com/tag/js/gpt.js에서 게재하는 게시자는 이 방식을 계속 사용할 수 있습니다. 하지만 선호 도메인으로 전환하면 향후 www.googletagservices.com에서 gpt.js의 성능과 게재가 개선될 수 있으므로 선호 도메인으로 전환하는 것이 좋습니다.

2023년 6월 둘째 주

2023년 7월 5일부터 GPT는 더 이상 오래된 버전의 자바스크립트 라이브러리를 게재하지 않습니다. 공식 URL에서 GPT를 로드하는 게시자에게는 영향을 미치지 않습니다. 캐시된 버전의 gpt.js, pubads_impl.js 또는 자신이 로드하는 라이브러리를 게재하는 게시자는 공식 URL을 사용하도록 페이지를 업데이트해야 합니다. 자세한 내용은 시작하기 가이드를 참조하세요.

2023년 5월 22일이 포함된 주

googletag.defineSlot() 및 SizeMappingBuilder.addSize()에 제공된 음수 및 0 크기 값은 이제 유효하지 않으므로 자동으로 삭제됩니다. 따라서 이러한 잘못된 값을 제공하는 기존 통합에서는 게시자 콘솔 메시지가 증가할 수 있습니다. 하지만 이렇게 해도 기존의 유효한 광고 요청에는 영향을 미치지 않습니다.

2023년 5월 18일이 포함된 주

이제 GPT의 보안 처리된 신호 입찰자 스크립트를 GPT 실행 초기에 설치할 예정입니다. 이렇게 하면 광고 요청 전반에서 신호 노출 범위가 개선될 수 있습니다.

2023년 5월 1일이 포함된 주

여러 크기의 앵커 슬롯을 새로고침할 때 광고 소재가 잘려 표시되는 버그가 수정되었습니다.

2023년 3월 27일이 포함된 주

GPT는 기본적으로 Intersection Observer API를 지원하지 않는 브라우저에서는 더 이상 조회가능성 기반 기능을 지원하지 않습니다. 지원되는 모든 브라우저에서 기본적으로 이 API를 지원합니다.

메서드 또는 이벤트
`googletag.events.ImpressionViewableEvent`
`googletag.events.SlotVisibilityChangedEvent`
`googletag.pubads().enableLazyLoad()`

2023년 2월 6일이 포함된 주

보안 처리된 신호 공유에 대한 지원이 추가되었습니다.

GPT의 새로운 기능
객체	`BidderSignalProvider` `PublisherSignalProvider` `SecureSignalProvidersArray`
유형	`SecureSignalProvider`
변수	`googletag.secureSignalProviders`

2023년 1월 30일이 포함된 주

이벤트가 발생하면 연결된 모든 리스너가 이후 이벤트를 처리하기 전에 실행되도록 Service.addEventListener()의 동작이 변경되었습니다. 이 변경 이전에는 동일한 슬롯의 슬롯 렌더링 시작 및 종료 이벤트 리스너가 순서대로 실행되지 않았습니다.

2022년 8월 15일이 포함된 주

Service.removeEventListener()의 반환 유형이 boolean에서 void로 변경되었습니다.

2022년 7월 25일이 포함된 주

FLEDGE 구성요소 입찰에 관한 실험용 지원을 추가하여 여러 판매자와 함께 FLEDGE를 조기 테스트할 수 있습니다.

GPT의 새로운 기능
메서드	`Slot.setConfig()`
객체	`ComponentAuctionConfig` `SlotSettingsConfig`

2022년 7월 18일이 포함된 주

ContentService API가 지원 중단되었습니다. 이제 googletag.content().setContent를 호출하면 경고를 로깅하는 것 외에는 아무런 효과가 없습니다. googletag.content 속성이 곧 완전히 삭제됩니다. 그 후에 이 속성을 호출하려고 하면 예외가 발생합니다. 대신 브라우저에 내장된 DOM API를 사용하여 콘텐츠를 div 요소에 직접 추가합니다.

2022년 5월 23일이 포함된 주

광고 요청 트래픽 소스 구성에 대한 지원이 추가되었습니다.

트래픽 소스에 대한 GPT 지원
enum	`TrafficSource.ORGANIC` `TrafficSource.PURCHASED`
속성	`PrivacySettingsConfig.trafficSource`

2022년 3월 7일 주간

웹용 보상형 광고가 출시되었습니다. 자세한 내용은 Ad Manager 고객센터를 방문하세요.

웹용 보상형 광고에 대한 GPT 지원
enum	`OutOfPageFormat.REWARDED`
이벤트	`RewardedSlotClosedEvent`
이벤트	`RewardedSlotGrantedEvent`
이벤트	`RewardedSlotReadyEvent`
객체	`RewardedPayload`

2022년 2월 28일이 포함된 주

이제 CommandArray.push가 제공된 함수를 자체 arguments 객체 대신 globalThis에 명시적으로 바인딩합니다.

2021년 12월 8일이 포함된 주

이제 Enums는 TypeScript enum의 동작을 일치시키기 위해 키에 대한 역방향 매핑도 노출합니다. enum 값을 사용하는 API는 변경되지 않고 그대로 유지되며 이러한 새로운 역방향 매핑을 사용해서는 안 됩니다.

2021년 8월 9일이 포함된 주

removeEventListener 메서드를 추가했습니다.

이제 동일한 eventType 및 콜백 함수 인스턴스를 사용하여 addEventListener 를 여러 번 호출하면 노옵스(no-ops)입니다. 즉, 단일 콜백 함수 인스턴스가 동일한 이벤트 유형에 n번 등록된 경우 n번이 아니라 이벤트가 발생할 때 한 번만 실행됩니다.

2021년 7월 29일이 포함된 주

이제 GPT의 조회가능성 이벤트: ImpressionViewableEvent 및 SlotVisibilityChangedEvent가 긴 페이지 세션에서 계속 실행됩니다. 이전에는 페이지 로드 후 1시간 후에 종료되었습니다.

2021년 5월 3일이 포함된 주

GPT는 광고를 가져오기 전에 더 이상 슬롯을 위한 공간을 설정하지 않습니다. 이 변경사항으로 인해 CSS를 사용하여 공간을 예약하지 않은 사이트의 레이아웃 변경 횟수 (CLS)가 줄어듭니다. 사이트의 CLS를 더 줄이려면 CSS를 사용하여 광고에 0이 아닌 영역을 예약하는 것이 좋습니다. 자세히 알아보기

2021년 3월 22일이 포함된 주

백그라운드 탭에서 스크롤해야 볼 수 있는 부분의 렌더링도 지연하도록 enableLazyLoad()의 동작을 업데이트했습니다.

2021년 2월 23일이 포함된 주

이제 googletag.pubads().set 및 Slot.set 메서드는 display 또는 refresh 전에 언제든지 호출할 수 있습니다. 이전에는 set가 googletag.enableServices 이전에 호출될 때만 적용되었습니다.

2021년 2월 16일이 포함된 주

이제 언제든지 googletag.pubads().setPublisherProvidedId API를 호출할 수 있습니다. 이전에는 googletag.enableServices 이전에 호출된 경우에만 작동했습니다.

2021년 1월 둘째 주

이제 googletag.pubads().collapseEmptyDivs API를 반복적으로 호출하여 설정을 변경할 수 있습니다. 이전에 반복된 호출은 무시됩니다.

2020년 10월 12일이 포함된 주

웹 전면 광고 공개 베타 버전이 출시되었습니다. 고객센터를 참고하세요.

2020년 8월 셋째 주

definePassback() 및 defineOutOfPagePassback()가 지원 중단되었습니다. 패스백을 올바르게 만드는 방법은 패스백 문서를 참고하세요.

2020년 6월 셋째 주

collapseEmptyDivs(true)와 호환되도록 enableLazyLoad()의 동작을 업데이트했습니다.

2020년 5월 25일이 포함된 주

GPT는 게시자가 설정한 정확한 GPS 위치를 더 이상 지원하지 않습니다. 구체적으로는 googletag.pubads().setLocation()에서 더 이상 위도, 경도 또는 반경 매개변수를 지원하지 않지만 대신 자유 형식 주소를 사용하게 됩니다.

2020년 4월 27일이 포함된 주

GPT 렌더링 로직은 더 이상 별도의 파일로 모듈화되지 않습니다. 즉, GPT가 실행 시 가져오는 파일 수가 적어지므로 지연 시간이 약간 줄어들지만 사용자 대역폭에는 영향을 미치지 않습니다.

googletag.display() 또는 googletag.pubads().refresh()를 호출하여 요청이 GPT에서 트리거되면 이제 요청이 전송되기 전에 변경할 수 없도록 모든 게시자 제공 상태가 내부적으로 고정됩니다. 따라서 요청이 트리거되면 해당 시점까지 추가된 상태만 해당 요청에 사용됩니다. 이후 수정되는 상태는 다음 요청에만 적용됩니다.

2019년 11월 셋째 주

GPT 패스백을 만들기 위한 새로운 권장 스니펫이 추가되었습니다. definePassback() 및 defineOutOfPagePassback()는 사용하지 않는 것이 좋습니다. 이러한 함수가 동기식으로 작동하고 특정 브라우저에 의해 차단될 수 있기 때문입니다. 자세히 알아보기

Slot.updateTargetingFromMap() 메서드를 추가했습니다.

개인 정보 보호 설정을 사용 설정하는 새로운 방법으로 PubAdsService.setPrivacySettings()를 추가했습니다. 향후 여기에서 추가 설정을 사용할 수 있습니다.

2019년 3월 25일이 포함된 주

이제 Pubads 서비스가 비동기식으로 초기화되지 않고 googletag.enableServices() 호출 후 즉시 정상적으로 작동합니다. 즉, 이제 googletag.pubadsReady가 googletag.enableServices()를 호출한 직후 true가 됩니다. googletag.pubadsReady 값을 확인하는 폴링이 더 이상 필요하지 않습니다.

2019년 2월 4일이 포함된 주

enableServices()를 호출한 후 지연 로드 구성을 변경할 수 있도록 enableLazyLoad()의 동작을 업데이트했습니다. 해당 슬롯이 표시될 때 각 슬롯의 지연 로드 구성이 고정됩니다.

2019년 1월 둘째 주

슬롯에 대한 광고 응답이 수신될 때 실행되는 새로운 지원되는 이벤트 SlotResponseReceived가 추가되었습니다.

새 필드 creativeTemplateId를 googleTag.ResponseInformation에 추가했습니다.

2019년 1월 셋째 주

슬롯에 광고 요청이 있을 때 실행되는 새로운 지원되는 이벤트 SlotRequestedEvent가 추가되었습니다.

2018년 8월 27일이 포함된 주

googletag.display()가 googletag.Slot를 인수로 허용하도록 수정되었습니다.

2018년 8월 셋째 주

GPT에서 지연 로드 광고를 위한 googletag.PubAdsService.enableLazyLoad()를 추가합니다.

2018년 6월 셋째 주

googletag.events.SlotOnloadEvent가 트리거되지 않는 버그가 수정되었습니다.

2018년 4월 셋째 주

동의 연령 미만 사용자의 광고를 제어하는 googletag.PubAdsService.setTagForUnderAgeOfConsent() 및 패스백 슬롯을 동의 연령 미만 사용자로부터 오는 것으로 표시하는 googletag.PassbackSlot.setTagForUnderAgeOfConsent()를 추가합니다.

2018년 4월 23일이 포함된 주

광고 개인 최적화를 관리하기 위한 googletag.PubAdsService.setRequestNonPersonalizedAds()를 추가합니다.

2018년 3월 셋째 주

GPT에 의해 콘텐츠가 배치되지 않은 경우 새로고침하기 전에 슬롯 내부의 기존 콘텐츠 삭제를 중지한 변경사항을 롤백했습니다. 이제 콘텐츠가 지워집니다.

2018년 2월 19일이 포함된 주

비동기 렌더링 모드를 사용하는 경우: 가능한 경우 모든 광고 요청에 대해 최대 8,192자(영문 기준)의 HTTP GET 메서드와 함께 XMLHttpRequest를 사용하여 광고를 요청합니다. 이전에는 4,096자(영문 기준)를 초과하여 최대 8,192자(영문 기준)로 제한하는 광고 요청에 HTTP POST 메서드가 사용되었습니다.

GPT에 의해 콘텐츠가 배치되지 않은 경우 새로고침하기 전에 슬롯 내 기존 콘텐츠 삭제를 중지했습니다. 이 메모가 잘못되었습니다. 2018년 3월 12일이 포함된 주 항목을 참조하세요.

2018년 1월 둘째 주

여러 크기 배열 내에서 [..., ['fluid'], ...]의 대체 문법을 NamedSized로 지원합니다. 이전에는 [..., 'fluid', ...]만 유효한 것으로 간주되었습니다.

2017년 7월 셋째 주

googleTag.ResponseInformation에서 labelIds 필드가 삭제되었습니다.

2017년 6월 다섯째 주

googletag.display() 및 googletag.pubads().display가 div 요소 및 div ID를 허용하도록 수정되었습니다. 이렇게 하면 Shadow DOM에 있는 div 내부의 슬롯을 렌더링할 수 있습니다.

2017년 2월 27일이 포함된 주

sourceAgnosticCreativeId 및 sourceAgnosticLineItemId을 SlotRenderEndedEvent에 추가했습니다.

2016년 11월 셋째 주

서비스에 연결된 슬롯 목록을 검색하는 서비스의 getSlots() API가 출시되었습니다.

2016년 10월 셋째 주

Slot.clearTargeting() 및 PubAdsService.clearTargeting()가 모두 선택적 키 매개변수를 취하도록 수정되었습니다.

2016년 9월 다섯째 주

googletag.cmd.push()에서 포착된 오류는 더 이상 표시되지 않으며 콘솔에 출력됩니다.

2016년 8월 셋째 주

광고 소재 로드 완료를 위해 리슨할 수 있는 SlotOnloadEvent API가 출시되었습니다.

2016년 7월 25일이 포함된 주

맞춤 서비스 수준 타겟팅 매개변수를 검색하기 위한 PubAdsService에서 getTargeting() 및 getTargetingKeys() API가 출시되었습니다.

2016년 6월 둘째 주

페이지를 새로고침하지 않고도 Google 게시자 콘솔을 열 수 있는 openConsole() API가 출시되었습니다.

2016년 6월 둘째 주

맞춤 타겟팅 매개변수를 검색하기 위한 getTargeting() 및 getTargetingKeys() API가 출시되었습니다.

Safeframe에서 콘텐츠를 푸시하여 확장을 허용해야 하는 구성 옵션 추가: allowPushExpansion

2016년 5월 셋째 주

여러 크기의 광고 요청에서 유동적인 크기를 지원합니다.

2016년 4월 셋째 주

광고 슬롯에 대한 광고 응답 정보를 반환하는 getResponseInformation API가 출시되었습니다.

이후에 생성되는 모든 광고 컨테이너 iframe의 제목으로 입력을 설정하는 setAdIframeTitle API가 출시되었습니다.

2016년 4월 둘째 주

HTTP GET 광고 요청의 최대 길이가 4,096자로 늘어났습니다.

2016년 3월 다섯째 주

Safeframe에서 콘텐츠를 오버레이하여 확장을 허용해야 하는 구성 옵션 추가: allowOverlayExpansion

상위 수준 탐색을 방지하기 위해 SafeFrame에서 HTML5 샌드박스 속성을 사용해야 하는 구성 옵션(sandbox)이 추가되었습니다.

2016년 2월 다섯째 주

광고 컨테이너 iframe의 제목을 설정하는 기능(setAdIframeTitle())이 추가되었습니다.

페이지 및 슬롯 수준에서 SafeFrame 속성을 구성하기 위한 API 추가: setSafeFrameConfig()

2016년 2월 셋째 주

슬롯을 삭제하고 div: destroySlots()를 재사용할 수 있는 기능이 추가되었습니다.

세분화된 제어 기능을 사용하여 광고 슬롯에 SafeFrame을 강제로 사용하도록 API 추가: setForceSafeFrame()

2015년 12월 셋째 주

슬롯 공개 상태 이벤트 추가 (SlotVisibilityChangedEvent)

2015년 10월 26일이 포함된 주

노출 조회가능성을 추가하는 중입니다 (ImpressionViewableEvent).

JSON 맵 (Passback.updateTargetingFromMap())에서 패스백 타겟팅을 업데이트합니다.

패스백 슬롯에 set() 및 get() 애드센스 속성 page_url이 지원됩니다.

2015년 10월 셋째 주

페이지 외부 패스백 지원

2015년 8월 셋째 주

GPT 아키텍처를 씬 로더와 더 큰 구현으로 재구성

GPT에서 유동적인 크기를 지원합니다.