2024년 Google 게시자 태그 개발자 설문조사에서 의견을 공유하여 Google 게시자 태그 개발자 환경을 개선하도록 도와주세요.

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

GPT 출시 노트

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

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

출시일 이해하기

GPT 라이브러리의 모든 변경사항은 출시 전에 철저히 테스트됩니다. 또한 예기치 않은 회귀를 방지하기 위해 출시 버전이 사용자에게 점진적으로 출시됩니다. 출시 중에 회귀가 발견되면 모든 사용자에게 도달하기 전에 전체 출시를 빠르게 중단할 수 있습니다.

따라서 출시일은 정확하지 않습니다. 출시가 완전히 배포되기까지 며칠에서 몇 주가 걸릴 수 있습니다. 즉, 사용자는 서로 다른 시점에 변경사항을 경험하게 됩니다. 아래에 제공된 날짜는 변경사항이 모든 사용자에게 출시가 완료된 주가 시작되는 날짜를 나타냅니다.

2025년 1월 27일 주

Protected Audience API 사양에 맞게 다음 ComponentAuctionConfig.auctionConfig 속성의 이름이 변경되었습니다.

이전 숙박 시설 이름	새 속성 이름
`decisionLogicUrl`	`decisionLogicURL`
`trustedScoringSignalsUrl`	`trustedScoringSignalsURL`

2024년 10월 21일 주

가능한 경우 Scheduler.postTask 대신 Scheduler.yield를 사용하도록 threadYield를 수정합니다. 자세한 내용은 수확량 문서를 참고하세요.

GPT에서 업데이트됨
속성	`googletag.config.PageSettingsConfig.threadYield`

2024년 9월 2일 주간

게임 전면 광고에 대한 지원을 추가했습니다.

GPT의 새로운 기능
열거형	`OutOfPageFormat.GAME_MANUAL_INTERSTITIAL`
이벤트	`GameManualInterstitialSlotClosedEvent` `GameManualInterstitialSlotReadyEvent`
메서드	`GameManualInterstitialSlotReadyEvent.makeGameManualInterstitialVisible()`
속성	`EventTypeMap.gameManualInterstitialSlotClosed` `EventTypeMap.gameManualInterstitialSlotReady`

2024년 8월 19일 주간

광고 수익을 최적화하는 것이 아니라 JS 스레드의 산출에 중점을 두고 있는 기능임을 명확히 하기 위해 GPT 스레드 산출 동작을 제어하는 설정의 이름이 adYield에서 threadYield로 변경되었습니다. 기능 및 연결된 API의 동작 (이름 제외)은 변경되지 않습니다. adYield 속성은 향후 GPT 출시에서 삭제될 예정입니다.

기본 스레드 양보 동작은 googletag.setConfig({threadYield: 'DISABLED'});를 사용하여 사용 중지하거나 googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'});를 사용하여 뷰포트에 대한 상대 위치와 관계없이 모든 슬롯에 적용할 수 있습니다.

GPT에서 업데이트됨
속성	`googletag.config.PageSettingsConfig.threadYield`

2024년 7월 29일 주간

이제 GPT는 광고 소재 렌더링 직전에 우선순위: 'user-blocking'으로 Scheduler.postTask(제공되는 경우)를 사용하여 JS 스레드를 생성합니다. 이로 인해 노출수에 미치는 영향은 매우 미미한 반면 Core Web Vitals에는 상당한 이점이 있는 것으로 나타났습니다. 기본적으로 GPT는 슬롯이 표시 영역 외부에 있는 경우에만 결과를 제공합니다.

기본 동작은 googletag.setConfig({adYield: 'DISABLED'});를 사용하여 사용 중지하거나 googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'});를 사용하여 뷰포트에 대한 상대 위치와 관계없이 모든 슬롯에 적용할 수 있습니다.

GPT의 새로운 기능
속성	`googletag.config.PageSettingsConfig.adYield`

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일 주

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

데스크톱/태블릿 및 모바일 웹 (부분 화면)에서 광고 확장을 구성할 수 있는 지원을 추가했습니다.

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

2023년 12월 11일 주

사이드 레일 앵커 광고 지원을 추가했습니다.

GPT의 새로운 기능
열거형	`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)가 7월 Chrome 출시와 함께 정식 버전으로 전환됩니다. 이제 GPT의 구성요소 입찰 관련 기능이 안정적인 것으로 간주됩니다.

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

2023년 6월 19일 주간

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

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

2023년 6월 6일 주

2023년 7월 5일부터 GPT는 더 이상 오래된 버전의 JavaScript 라이브러리를 제공하지 않습니다. 공식 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 지원
열거형	`TrafficSource.ORGANIC` `TrafficSource.PURCHASED`
속성	`PrivacySettingsConfig.trafficSource`

2022년 3월 7일 주간

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

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

2022년 2월 28일 주

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

2021년 12월 8일 주

이제 enum은 TypeScript enum의 동작과 일치하도록 값을 키에 역매핑합니다. enum 값을 사용하는 API는 변경되지 않으며 이러한 새로운 역 매핑은 사용해서는 안 됩니다.

2021년 8월 9일 주간

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

이제 동일한 eventType 및 콜백 함수 인스턴스로 addEventListener 를 여러 번 호출해도 아무 일도 일어나지 않습니다. 즉, 단일 콜백 함수 인스턴스가 동일한 이벤트 유형에 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월 4일 주

이제 설정을 변경하기 위해 googletag.pubads().collapseEmptyDivs API가 반복적으로 호출될 수 있습니다. 이전에는 반복된 호출이 무시되었습니다.

2020년 10월 12일 주간

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

2020년 8월 31일 주간

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

2020년 6월 15일 주간

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

2020년 5월 25일 주간

GPT는 더 이상 게시자가 설정한 정확한 GPS 위치를 지원하지 않습니다. 특히 googletag.pubads().setLocation()는 더 이상 위도, 경도 또는 반경 매개변수를 지원하지 않고 대신 자유 형식 주소를 사용합니다.

2020년 4월 27일 주간

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

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

2019년 11월 11일 주간

GPT 패스백을 만드는 데 사용할 새로운 권장 스니펫이 있습니다. definePassback() 및 defineOutOfPagePassback() 함수는 동기식으로 동작하여 특정 브라우저에서 차단될 수 있으므로 사용하지 않는 것이 좋습니다. 자세히 알아보기

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

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

2019년 3월 25일 주간

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

2019년 2월 4일 주간

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

2019년 1월 21일 주간

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

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

2019년 1월 14일 주간

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

2018년 8월 27일 주간

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

2018년 8월 6일 주

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

2018년 6월 18일 주

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

2018년 4월 30일 주

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

2018년 4월 23일 주

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

2018년 3월 12일 주간

GPT가 해당 콘텐츠를 배치하지 않은 경우 새로고침하기 전에 슬롯 내에서 기존 콘텐츠를 삭제하지 않도록 하는 변경사항을 롤백했습니다. 이제 콘텐츠가 삭제됩니다.

2018년 2월 19일 주간

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

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

2018년 1월 8일 주

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

2017년 7월 10일 주

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

2017년 6월 5일 주간

div ID뿐만 아니라 div 요소도 허용하도록 googletag.display() 및 googletag.pubads().display를 수정했습니다. 이렇게 하면 shadow DOM에 있는 div 내에서 슬롯을 렌더링할 수 있습니다.

2017년 2월 27일 주간

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

2016년 11월 7일 주

서비스와 연결된 슬롯 목록을 검색하기 위한 서비스에 getSlots() API를 출시했습니다.

2016년 10월 17일 주

선택적 키 매개변수를 사용하도록 Slot.clearTargeting() 및 PubAdsService.clearTargeting()를 모두 수정했습니다.

2016년 9월 5일 주

googletag.cmd.push()에서 포착된 오류가 더 이상 보이지 않고 콘솔에 출력됩니다.

2016년 8월 8일 주

광고 소재의 로드가 완료될 때까지 수신 대기할 수 있는 SlotOnloadEvent API를 출시했습니다.

2016년 7월 25일 주간

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

2016년 6월 20일 주

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

2016년 6월 6일 주

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

Safeframe에서 콘텐츠를 푸시하여 확장을 허용해야 하는 구성 옵션(allowPushExpansion)을 추가했습니다.

2016년 5월 16일 주

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

2016년 4월 18일 주

광고 슬롯의 광고 응답 정보를 반환하는 getResponseInformation API를 출시했습니다.

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

2016년 4월 4일 주

HTTP GET 광고 요청 최대 길이를 4,096자(영문 기준)로 늘렸습니다.

2016년 3월 28일 주간

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

SafeFrame이 HTML5 sandbox 속성을 사용하여 최상위 수준 탐색을 방지해야 하는 구성 옵션(sandbox)을 추가했습니다.

2016년 2월 22일 주간

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

페이지 및 슬롯 수준에서 SafeFrame 속성을 구성하는 API(setSafeFrameConfig())를 추가했습니다.

2016년 2월 15일 주간

슬롯을 소멸하고 div를 재사용하는 기능을 추가했습니다. destroySlots()

세분화된 제어 기능이 있는 광고 슬롯에서 SafeFrame을 강제로 사용하도록 하는 API를 추가했습니다. setForceSafeFrame()

2015년 12월 7일 주

슬롯 표시 이벤트 추가 (SlotVisibilityChangedEvent)

2015년 10월 26일 주

노출 조회가능성 추가 (ImpressionViewableEvent)

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

패스백 슬롯에 set() 및 get() 애드센스 속성 page_url 지원

2015년 10월 12일 주

페이지 외부 패스백을 지원합니다.

2015년 8월 31일 주

GPT 아키텍처를 씬 로더 및 더 큰 구현으로 재구성합니다.

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