Ta strona zawiera informacje o aktualizacjach produkcyjnych biblioteki tagów wydawcy Google (GPT). Sprawdzaj ją okresowo, aby na bieżąco obserwować ogłoszenia na temat nowych i zaktualizowanych funkcji, poprawek błędów, znanych problemów oraz wycofanych funkcji.
Aby otrzymywać powiadomienia, dodaj adres URL tej strony do wybranego czytnika kanałów. Możesz też użyć bezpośredniego linku do kanału z informacjami o wersji w formacie Atom 1.0
lub RSS 2.0.
Informacje o datach premiery
Wszystkie zmiany w bibliotece GPT są dokładnie testowane przed opublikowaniem. Dodatkowo wersje są wprowadzane stopniowo, aby jeszcze lepiej chronić użytkowników przed nieoczekiwanymi regresjami. Jeśli w którymkolwiek momencie podczas wdrażania zauważysz regresję, możesz szybko zrezygnować z całej wersji, zanim dotrze do wszystkich użytkowników.
Z tego powodu daty premiery nie są dokładne. Wdrożenie może potrwać od kilku dni do kilku tygodni. Oznacza to, że użytkownicy mieją do czynienia ze zmianami w różnym czasie. Podane daty wskazują początek tygodnia, w którym zmiana została wdrożona dla wszystkich użytkowników.
Tydzień zaczynający się 21 października 2024 r.
Zmodyfikuj zasadę threadYield, aby w miarę możliwości używała Scheduler.yield zamiast Scheduler.postTask. Szczegółowe informacje znajdziesz w dokumentacji dotyczącej rentowności.
| Zaktualizowano w GPT | |
|---|---|
| Właściwość |
googletag.config.PageSettingsConfig.threadYield
|
Tydzień zaczynający się 2 września 2024 r.
Dodaliśmy obsługę reklam pełnoekranowych w grach.
Tydzień 19 sierpnia 2024 r.
Ustawienie służące do kontrolowania zachowania zysku z wątku GPT zmieniliśmy z adYield na threadYield, aby było jasne, że funkcja ta koncentruje się na uzyskiwaniu zysku z wątku JS, a nie na optymalizacji zysku z reklam. Zachowanie tej funkcji i powiązanego z nią interfejsu API (z wyjątkiem nazwy) pozostaje bez zmian. Właściwość adYield zostanie usunięta w przyszłej wersji GPT.
Domyślne zachowanie przydziału wątków można wyłączyć za pomocą parametru googletag.setConfig({threadYield: 'DISABLED'}); lub zastosować do wszystkich boksów niezależnie od ich położenia względem widoku za pomocą parametru googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'});.
| Zaktualizowano w GPT | |
|---|---|
| Właściwość |
googletag.config.PageSettingsConfig.threadYield
|
Tydzień od 29 lipca 2024 r.
GPT zwraca teraz wątek JS za pomocą funkcji Scheduler.postTask (jeśli jest dostępna) z priorytetem „blokowanie użytkownika” tuż przed renderowaniem kreacji. Wykazano, że ma to bardzo niewielki wpływ na wyświetlenia, a jednocześnie przynosi znaczne korzyści w zakresie podstawowych wskaźników internetowych. Domyślnie GPT będzie zwracać wartość tylko wtedy, gdy slot znajduje się poza widocznym obszarem.
Domyślne działanie można wyłączyć za pomocą funkcji googletag.setConfig({adYield: 'DISABLED'}); lub zastosować do wszystkich boksów niezależnie od ich lokalizacji względem widocznego obszaru za pomocą funkcji googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'});.
| Nowości w GPT | |
|---|---|
| Właściwość |
googletag.config.PageSettingsConfig.adYield
|
Tydzień zaczynający się 12 lutego 2024 r.
Dodaliśmy obsługę konfigurowania sygnałów dostarczanych przez wydawcę.
Naprawiliśmy błąd polegający na tym, że właściwość SlotRenderEndedEvent.slotContentChanged zawsze miała wartość true. Od tej pory właściwość ta będzie true wskazana tylko w przypadku zmiany
zawartości boksu, a false w innym przypadku (jeśli na przykład reklama nie została wypełniona).
Tydzień zaczynający się 29 stycznia 2024 r.
Błędy sieci w przypadku żądań reklam będą symulować brak możliwości wypełnienia, wywołując googletag.events.SlotRenderEndedEvent z wartością isEmpty ustawioną na true. Aby dowiedzieć się, jak nasłuchiwać to zdarzenie, zapoznaj się z artykułem Detektory zdarzeń reklamowych. Zmiana obejmuje automatyczne zwijanie boksu podczas korzystania z collapseEmptyDivs.
Dodaliśmy obsługę konfigurowania rozwijania reklam na komputerach i tabletach oraz w internecie mobilnym (na części ekranu).
Tydzień zaczynający się 11 grudnia 2023 r.
Dodaliśmy obsługę reklam zakotwiczonych w kolumnie bocznej.
| Nowości w GPT | |
|---|---|
| Typ wyliczeniowy |
OutOfPageFormat.LEFT_SIDE_RAILOutOfPageFormat.RIGHT_SIDE_RAIL
|
Tydzień zaczynający się 13 listopada 2023 r.
Dodano obsługę konfigurowania działań związanych z ochroną prywatności wydawców.
Dodaliśmy obsługę wstępnego renderowania w Chrome. Gdy GPT wykryje, że strona jest w stanie przedrenderowania, żądanie reklamy zostanie opóźnione, dopóki strona nie stanie się widoczna dla użytkownika.
Tydzień zaczynający się 23 października 2023 r.
Dodaliśmy obsługę opcjonalnych reguł dotyczących reklam pełnoekranowych w internecie.
| Nowości w GPT | |
|---|---|
| Obiekt |
googletag.config.InterstitialConfig
|
| Właściwość |
googletag.config.SlotSettingsConfig.interstitial
|
| Typ |
googletag.config.InterstitialTrigger
|
Tydzień zaczynający się 24 lipca 2023 r.
W lipcowej wersji Chrome interfejs Protected Audience API (wcześniej FLEDGE) staje się ogólnie dostępny. Dzięki temu funkcje związane z aukcją komponentów w GPT są już uważane za stabilne.
| Przeniesiono z wersji eksperymentalnej na stabilną | |
|---|---|
| Obiekt |
googletag.config.ComponentAuctionConfig
|
| Właściwość |
googletag.config.SlotSettingsConfig.componentAuction
|
Tydzień zaczynający się 19 czerwca 2023 r.
Aktualizacja: od 5 lipca 2023 r. tag GPT nie będzie już obsługiwał przestarzałych wersji biblioteki JavaScript ani nie będzie wyświetlać reklam w tych wersjach. Więcej informacji znajdziesz w poprzednim ogłoszeniu.
Wydawcy, którzy wyświetlają tagi z domeny www.googletagservices.com/tag/js/gpt.js, mogą nadal to robić. Zalecamy jednak przejście na preferowaną domenę, ponieważ może to poprawić wydajność, a wyświetlanie tagu gpt.js w domenie www.googletagservices.com może zostać w przyszłości wyłączone.
Tydzień zaczynający się 6 czerwca 2023 r.
Od 5 lipca 2023 r. tag GPT nie będzie już obsługiwał nieaktualnych wersji biblioteki JavaScript. Nie ma to wpływu na wydawców wczytujących bibliotekę GPT z oficjalnego adresu URL. Wydawcy, którzy korzystają z wersji w pamięci podręcznej biblioteki gpt.js, pubads_impl.js lub innych bibliotek, muszą zaktualizować swoje strony, aby używać oficjalnych adresów URL. Więcej informacji znajdziesz w przewodniku Pierwsze kroki.
Tydzień rozpoczynający się 22 maja 2023 r.
Wartości ujemne i zerowe podane w parametrach googletag.defineSlot() i SizeMappingBuilder.addSize() są teraz automatycznie usuwane, ponieważ są nieprawidłowe. W rezultacie dotychczasowe integracje, które podają takie nieprawidłowe wartości, mogą częściej wyświetlać komunikaty w konsoli wydawcy.
Nie będzie to jednak miało wpływu na istniejące, prawidłowe żądania reklam.
Tydzień zaczynający się 18 maja 2023 r.
Instalacja skryptów oferencera Secure Signals przez GPT będzie teraz wykonywana wcześniej w ramach wykonywania GPT. Może to poprawić zasięg sygnałów w przypadku żądań reklamy.
Tydzień zaczynający się 1 maja 2023 r.
Rozwiązanie problemu polegającego na tym, że podczas odświeżania boksów kotwicy o różnych rozmiarach kreacja mogła być wyświetlana w sposób niepełny.
Tydzień zaczynający się 27 marca 2023 r.
GPT nie obsługuje już funkcji opartych na widoczności w przypadku przeglądarek, które nie obsługują natywnie interfejsu Intersection Observer API. Pamiętaj, że wszystkie obsługiwane przeglądarki obsługują ten interfejs API natywnie.
| Metoda lub zdarzenie | |
|---|---|
googletag.events.ImpressionViewableEvent
|
|
googletag.events.SlotVisibilityChangedEvent
|
|
googletag.pubads().enableLazyLoad()
|
|
Tydzień zaczynający się 6 lutego 2023 r.
Dodaliśmy obsługę udostępniania bezpiecznych sygnałów.
| Nowości w GPT | |
|---|---|
| Obiekt |
BidderSignalProviderPublisherSignalProviderSecureSignalProvidersArray
|
| Typ |
SecureSignalProvider
|
| Zmienna |
googletag.secureSignalProviders
|
Tydzień zaczynający się 30 stycznia 2023 r.
Działanie Service.addEventListener() zostało zmienione tak, że po wystąpieniu zdarzenia wszystkie powiązane detektory są wykonywane przed przetworzeniem późniejszego zdarzenia. Przed tą zmianą słuchający zdarzenia rozpoczęcia i zakończenia renderowania slotu w przypadku tego samego slotu mogli się wykonywać w nieporządku.
Tydzień zaczynający się 15 sierpnia 2022 r.
Zmieniono typ zwracanej wartości funkcji Service.removeEventListener() z boolean na void.
Tydzień zaczynający się 25 lipca 2022 r.
Dodaliśmy eksperymentalną obsługę aukcji komponentów FLEDGE, aby umożliwić wczesny test FLEDGE z udziałem wielu sprzedawców.
| Nowości w GPT | |
|---|---|
| Metoda |
Slot.setConfig()
|
| Obiekt |
ComponentAuctionConfigSlotSettingsConfig
|
Tydzień 18 lipca 2022 r.
Interfejs API ContentService został wycofany. Wywołanie metody googletag.content().setContent nie ma teraz żadnego efektu poza zapisaniem ostrzeżenia. Właściwość googletag.content zostanie wkrótce całkowicie usunięta. Po tym próba wywołania tej właściwości spowoduje wyjątek. Na potrzeby bezpośredniego dodawania treści do elementów div możesz korzystać z wbudowanych interfejsów DOM API przeglądarki.
Tydzień rozpoczynający się 23 maja 2022 r.
Dodano obsługę konfigurowania źródła ruchu żądania reklamy.
| Obsługa GPT w przypadku źródła wizyt | |
|---|---|
| Typ wyliczeniowy |
TrafficSource.ORGANICTrafficSource.PURCHASED
|
| Właściwość | PrivacySettingsConfig.trafficSource |
Tydzień od 7 marca 2022 r.
Reklamy z nagrodą w internecie są już dostępne. Więcej informacji znajdziesz w Centrum pomocy Ad Managera.
| Obsługa GPT w przypadku reklam z nagrodą w internecie | |
|---|---|
| Typ wyliczeniowy | OutOfPageFormat.REWARDED |
| Zdarzenie | RewardedSlotClosedEvent |
| Zdarzenie | RewardedSlotGrantedEvent |
| Zdarzenie | RewardedSlotReadyEvent |
| Obiekt | RewardedPayload |
Tydzień zaczynający się 28 lutego 2022 r.
Funkcja CommandArray.push teraz jawnie łączy podane funkcje z globalThis zamiast z własnym obiektem arguments.
Tydzień zaczynający się 8 grudnia 2021 r.
Enum udostępnia też teraz odwrotne mapowanie wartości na klucze, aby zapewnić zgodność z zachowaniem wyliczeń TypeScript. Interfejsy API, które przyjmują wartości wyliczane, pozostają bez zmian. Nie należy używać nowych odwrotnych mapowań.
Tydzień zaczynający się 9 sierpnia 2021 r.
Dodano metodę removeEventListener.
Wywoływanie addEventListener wiele razy z tym samym eventType i tą samą instancją funkcji wywołania jest teraz bezczynne. Innymi słowy, jeśli ta sama instancja funkcji wywołania zostanie zarejestrowana n razy dla tego samego typu zdarzenia, zostanie wykonana tylko raz, gdy zdarzenie wystąpi, a nie n razy.
Tydzień zaczynający się 29 lipca 2021 r.
Zdarzenia widoczności GPT: ImpressionViewableEvent
i SlotVisibilityChangedEvent
będą nadal wywoływane w przypadku długich sesji na stronie. Wcześniej były one wyłączane po upływie 1 godziny od załadowania strony.
Tydzień od 3 maja 2021 r.
GPT nie ustawia już miejsca na boksy przed pobieraniem reklam. Ta zmiana zmniejsza skumulowany przesunięcie układu (CLS) w witrynach, które nie zarezerwowały miejsca za pomocą kodu CSS. Aby jeszcze bardziej zmniejszyć CLS w witrynie, zalecamy zarezerwowanie dla reklamy obszaru o niezerowym rozmiarze za pomocą CSS. Więcej informacji
Tydzień od 22 marca 2021 r.
Zmieniliśmy działanie enableLazyLoad(), aby opóźniać renderowanie slotów poniżej składanego ekranu na kartach w tle.
Tydzień od 23 lutego 2021 r.
Metody googletag.pubads().set i Slot.set mogą być teraz wywoływane w dowolnym momencie przed metodą display lub refresh. Wcześniej funkcja set była stosowana tylko wtedy, gdy została wywołana przed funkcją googletag.enableServices.
Tydzień zaczynający się 16 lutego 2021 r.
Interfejs API googletag.pubads().setPublisherProvidedId może być teraz wywoływany w dowolnym momencie. Wcześniej działało to tylko wtedy, gdy wywołanie nastąpiło przed googletag.enableServices.
Tydzień od 4 stycznia 2021 r.
Interfejs googletag.pubads().collapseEmptyDivs API może być teraz wywoływany wielokrotnie w celu zmiany ustawień. Wcześniej powtarzane połączenia były ignorowane.
Tydzień od 12 października 2020 r.
Rozpoczęliśmy otwarte testy beta reklam pełnoekranowych w internecie. Więcej informacji znajdziesz w Centrum pomocy.
Tydzień 31 sierpnia 2020 r.
Wycofane: definePassback() i defineOutOfPagePassback(). Aby dowiedzieć się, jak prawidłowo utworzyć przekazywanie, zapoznaj się z dokumentacją przekazywania.
Tydzień od 15 czerwca 2020 r.
Zaktualizowaliśmy działanie enableLazyLoad(), aby było zgodne z collapseEmptyDivs(true).
Tydzień od 25 maja 2020 r.
GPT nie będzie już obsługiwać dokładnej lokalizacji GPS ustawionej przez wydawców. W szczególności googletag.pubads().setLocation() nie będzie już obsługiwać parametrów szerokości i długości geograficznej ani promienia, ale będzie przyjmować adres w dowolnej formie.
Tydzień od 27 kwietnia 2020 r.
Logika renderowania GPT nie jest już modyfikowana w oddzielne pliki. Oznacza to, że GPT będzie pobierać mniej plików podczas wykonywania, co nieco zmniejszy opóźnienie, ale nie będzie miało wpływu na przepustowość użytkownika.
Gdy żądanie zostanie wywołane w GPT (poprzez wywołanie funkcji googletag.display() lub googletag.pubads().refresh()), wewnętrznie zamrozimy wszystkie stany podawane przez wydawcę, aby nie mogły ulec zmianie przed wysłaniem żądania. Dlatego, gdy żądanie zostanie wywołane, do tego żądania zostanie użyty tylko stan dodany do tego czasu. Każdy stan, który zostanie zmieniony po tym czasie, będzie obowiązywał tylko w przypadku kolejnych żądań.
Tydzień od 11 listopada 2019 r.
Wprowadziliśmy nowy zalecany fragment kodu do tworzenia przebiegów zwrotnych GPT. Odradzamy używanie funkcji definePassback() i defineOutOfPagePassback(), ponieważ działają one synchronicznie i mogą być blokowane przez niektóre przeglądarki. Więcej informacji
Dodano metodę Slot.updateTargetingFromMap().
Dodaliśmy PubAdsService.setPrivacySettings() jako nową metodę włączania ustawień prywatności. W przyszłości udostępnimy tu więcej ustawień.
Tydzień od 25 marca 2019 r.
Usługa Pubads jest teraz w pełni funkcjonalna od razu po wywołaniu narzędzia googletag.enableServices(), a nie asynchronicznie. Oznacza to, że zasada googletag.pubadsReady jest teraz gwarantowana po wywołaniu googletag.enableServices(). Nie powinno być już konieczne sprawdzanie wartości parametru googletag.pubadsReady.
Tydzień zaczynający się 4 lutego 2019 r.
Zmieniliśmy działanie funkcji enableLazyLoad(), aby umożliwić wprowadzanie zmian w konfiguracji opóźnionego ładowania po wywołaniu funkcji enableServices(). Konfiguracja opóźnionego ładowania jest zamrożona dla każdego slotu, gdy jest wyświetlany.
Tydzień od 21 stycznia 2019 r.
Dodano nowe obsługiwane zdarzenie SlotResponseReceived, które uruchamia się, gdy dla danego slotu zostanie otrzymana odpowiedź reklamy.
Dodano nowe pole creativeTemplateId do pola googleTag.ResponseInformation.
Tydzień od 14 stycznia 2019 r.
Dodano nowe obsługiwane zdarzenie SlotRequestedEvent, które jest wywoływane, gdy wysyłane jest żądanie reklamy dla slotu.
W ciągu tygodnia od 27 sierpnia 2018 r.
Zmodyfikowano funkcję googletag.display(), aby przyjmowała jako argument wartość googletag.Slot.
Tydzień 6 sierpnia 2018 r.
Dodaje googletag.PubAdsService.enableLazyLoad() do leniwego ładowania reklam w tagu GPT.
Tydzień od 18 czerwca 2018 r.
Naprawiliśmy błąd, który powodował, że googletag.events.SlotOnloadEvent nie był uruchamiany.
Tydzień zaczynający się 30 kwietnia 2018 r.
Dodano googletag.PubAdsService.setTagForUnderAgeOfConsent() do kontrolowania wyświetlania reklam użytkownikom, którzy nie osiągnęli wieku świadomego wyrażenia zgody, oraz googletag.PassbackSlot.setTagForUnderAgeOfConsent() do oznaczania boksu przebiegu zwrotnego jako pochodzącego od użytkownika, który nie osiągnął wieku świadomego wyrażenia zgody.
Tydzień zaczynający się 23 kwietnia 2018 r.
Dodaje googletag.PubAdsService.setRequestNonPersonalizedAds() do zarządzania personalizacją reklam.
Tydzień zaczynający się 12 marca 2018 r.
Przywrócono zmianę, która uniemożliwiała usuwanie istniejących treści w miejscach przed odświeżeniem, jeśli te treści nie zostały umieszczone przez GPT. Treści zostaną teraz wyczyszczone.
Tydzień zaczynający się 19 lutego 2018 r.
Gdy używany jest tryb renderowania asynchronicznego: wysyłaj żądania reklam za pomocą metody XMLHttpRequest HTTP GET (w miarę możliwości) we wszystkich żądaniach reklam (do 8192 znaków). Wcześniej metoda HTTP POST była używana w przypadku żądań reklamy o długości przekraczającej 4096 znaków, aż do limitu 8192 znaków.
Zatrzymano usuwanie istniejących treści z boksów przed odświeżeniem, jeśli treści nie zostały tam umieszczone przez GPT. Ta uwaga jest nieprawidłowa. Zobacz wpis dotyczący tygodnia od 12 marca 2018 r.
Tydzień zaczynający się 8 stycznia 2018 r.
Obsługa alternatywnej składni [..., ['fluid'], ...] jako NamedSized w tablicy wielu rozmiarów. Wcześniej za prawidłowe uważany był tylko format [..., 'fluid', ...].
Tydzień zaczynający się 10 lipca 2017 r.
Usunięto pole labelIds z googleTag.ResponseInformation.
Tydzień zaczynający się 5 czerwca 2017 r.
Zmodyfikowano googletag.display() i googletag.pubads().display, aby akceptowały element div oraz identyfikator div. Umożliwia to renderowanie slotów w elementach div w modelu Shadow DOM.
Tydzień od 27 lutego 2017 r.
Tydzień zaczynający się 7 listopada 2016 r.
Udostępniliśmy w usłudze interfejs API getSlots() służący do pobierania listy przedziałów powiązanych z usługą.
Tydzień zaczynający się 17 października 2016 r.
Zmodyfikowano zarówno parametr Slot.clearTargeting(), jak i PubAdsService.clearTargeting(), aby przyjmowały opcjonalny parametr klucza.
Tydzień zaczynający się 5 września 2016 r.
Błędy zarejestrowane w usłudze googletag.cmd.push() nie są już niewidoczne i zostaną wydrukowane w konsoli.
Tydzień 8 sierpnia 2016 r.
Udostępniliśmy interfejs API SlotOnloadEvent, który umożliwia zakończenie wczytywania kreacji przez nasłuchiwanie.
Tydzień zaczynający się 25 lipca 2016 r.
Udostępniliśmy interfejsy API getTargeting() i getTargetingKeys() w PubAdsService do pobierania niestandardowych parametrów kierowania na poziomie usługi.
Tydzień od 20 czerwca 2016 r.
Udostępniliśmy interfejs API openConsole(), aby otwierać Konsolę Google dla wydawcy bez konieczności odświeżania strony.
Tydzień zaczynający się 6 czerwca 2016 r.
Udostępniliśmy interfejsy API getTargeting() i getTargetingKeys() do pobierania niestandardowych parametrów kierowania.
Dodano opcję konfiguracji, w której SafeFrame powinno być możliwe rozwijanie przez przekazanie treści: allowPushExpansion.
Tydzień zaczynający się 16 maja 2016 r.
Obsługa rozmiaru elastycznego w żądaniach reklam o wielu rozmiarach.
Tydzień zaczynający się 18 kwietnia 2016 r.
Udostępniliśmy interfejs API getResponseInformation, który zwraca informacje o odpowiedziach na reklamy w przypadku tego boksu reklamowego.
Udostępniliśmy interfejs API setAdIframeTitle, który ustawia podany tekst jako tytuł wszystkich utworzonych później iframe’ów kontenera reklamowego.
Tydzień zaczynający się 4 kwietnia 2016 r.
Zwiększono maksymalną długość żądania reklamy HTTP GET do 4096 znaków.
Tydzień od 28 marca 2016 r.
Dodanie opcji konfiguracji, w której Safeframe ma zezwalać na rozszerzanie przez nakładanie treści: allowOverlayExpansion.
Dodanie opcji konfiguracji, w której SafeFrame ma używać atrybutu sandbox HTML5, aby zapobiec nawigacji na najwyższym poziomie: sandbox.
Tydzień zaczynający się 22 lutego 2016 r.
Dodanie możliwości ustawiania tytułów elementów iframe kontenera reklam: setAdIframeTitle().
Dodanie interfejsu API w celu skonfigurowania właściwości SafeFrame na poziomie strony i boksu: setSafeFrameConfig().
Tydzień zaczynający się 15 lutego 2016 r.
Dodawanie możliwości usunięcia boksu i ponownego użycia elementu div: destroySlots().
Dodanie interfejsu API, aby wymusić stosowanie SafeFrame w miejscach na reklamy z dokładnymi ustawieniami: setForceSafeFrame().
Tydzień zaczynający się 7 grudnia 2015 r.
Dodawanie zdarzeń widoczności boksu (SlotVisibilityChangedEvent).
Tydzień zaczynający się 26 października 2015 r.
Dodawanie widoczności wyświetleń (ImpressionViewableEvent).
Zaktualizuj kierowanie na podstawie mapy danych w formacie JSON (Passback.updateTargetingFromMap()).
Tydzień zaczynający się 12 października 2015 r.
Obsługa przekierowania poza stronę.
W ciągu tygodnia od 31 sierpnia 2015 r.
Przekształcenie architektury GPT w bardziej wydajną implementację i większą implementację.
Obsługa rozmiaru elastycznego w GPT.