Ta strona zawiera informacje o aktualizacjach produkcyjnych biblioteki tagów wydawcy Google (GPT). Sprawdzaj ją okresowo, by dowiadywać się o nowych lub zaktualizowanych funkcjach, poprawkach błędów, znanych problemach i wycofanych funkcjach.
Aby otrzymywać aktualizacje, dodaj adres URL tej strony do wybranego czytnika kanałów lub skorzystaj z bezpośredniego linku do kanału z informacjami o wersji w formacie Atom 1.0
lub RSS 2.0.
Omówienie dat premiery
Wszystkie zmiany w bibliotece GPT są dokładnie testowane przed wprowadzeniem. Dodatkowo wersje są udostępniane użytkownikom stopniowo, aby lepiej chronić się przed nieoczekiwanymi regresjami. Jeśli w dowolnym momencie podczas wdrażania zostanie zauważona regresja, można szybko porzucić całą wersję, zanim dotrze do wszystkich użytkowników.
Z tego powodu daty premiery nie są dokładne – wdrożenie wersji może zająć od kilku dni do kilku tygodni. Oznacza to, że użytkownicy zobaczą zmiany w różnych momentach. Podane poniżej daty to początek tygodnia, w którym zmiana została wprowadzona wszystkim użytkownikom.
Tydzień zaczynający się 19 lutego 2024 r.
Dodano regułę reklamy pełnoekranowej navBar, która może wyświetlać reklamę pełnoekranową zarządzaną przez GPT, gdy użytkownik wejdzie w interakcję z paskiem nawigacyjnym przeglądarki. Ta funkcja działa tylko na komputerach.
Przykład znajdziesz w sekcji Wyświetlanie reklamy pełnoekranowej w internecie.
Tydzień zaczynający się 12 lutego 2024 r.
Dodaliśmy obsługę konfigurowania sygnałów dostarczanych przez wydawcę.
Naprawiliśmy błąd, przez który właściwość SlotRenderEndedEvent.slotContentChanged była zawsze wartością true. Od tej pory ta właściwość będzie miała wartość true tylko wtedy, gdy zmieniła się zawartość boksu, lub false w innym przypadku (np. jeśli reklama się nie wypełniła).
Tydzień zaczynający się 29 stycznia 2024 r.
Awarie sieci w przypadku żądań reklam będą imitować brak wypełnienia, uruchamiając element googletag.events.SlotRenderEndedEvent z wartością isEmpty ustawioną na true. Informacje o tym, jak nasłuchiwać tego zdarzenia, znajdziesz w sekcji Detektory zdarzeń reklamy. Zmiana obejmuje automatyczne zwijanie boksu podczas korzystania z funkcji collapseEmptyDivs.
Dodaliśmy obsługę konfigurowania rozwijania reklam na komputerach i tabletach i w przeglądarce mobilnej (części ekranu).
Tydzień zaczynający się 11 grudnia 2023 r.
Dodaliśmy obsługę reklam zakotwiczonych w kolumnie bocznej.
| Nowość w GPT | |
|---|---|
| Typ wyliczeniowy |
OutOfPageFormat.LEFT_SIDE_RAILOutOfPageFormat.RIGHT_SIDE_RAIL
|
Tydzień zaczynający się 13 listopada 2023 r.
Dodano obsługę konfigurowania zasad ochrony prywatności wydawcy.
Dodaliśmy obsługę wstępnego renderowania Chrome. Gdy GPT wykryje, że strona jest w stanie renderowania wstępnego, żądanie reklamy będzie 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ł reklam pełnoekranowych w przeglądarce.
| Nowość 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.
Interfejs Protected Audience API (dawniej FLEDGE) stanie się ogólnie dostępny w lipcu w wersji Chrome. W związku z tym funkcje związane z aukcjami w GPT są obecnie uważane za stabilne.
| Zmieniono z eksperymentalnego na stabilny | |
|---|---|
| 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. lub później tag GPT nie będzie już wyświetlać nieaktualnych wersji biblioteki JavaScriptu i nie będzie w nich wyświetlać reklam. Aby dowiedzieć się więcej, przeczytaj poprzednie ogłoszenie.
Wydawcy wyświetlający treści 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ść i wyświetlanie kodu gpt.js w witrynie www.googletagservices.com w przyszłości.
Tydzień zaczynający się 6 czerwca 2023 r.
Od 5 lipca 2023 r. lub później tag GPT nie będzie już wyświetlać nieaktualnych wersji swojej biblioteki JavaScript. Nie ma to wpływu na to, czy wydawcy wczytują GPT z oficjalnego adresu URL. Wydawcy, którzy udostępniają w pamięci podręcznej wersję pliku gpt.js, pubads_impl.js lub jakieś wczytane przez nich biblioteki, muszą zaktualizować swoje strony, aby korzystały z oficjalnych adresów URL. Więcej informacji znajdziesz w przewodniku Pierwsze kroki.
Tydzień zaczynający się 22 maja 2023 r.
Ujemne i zerowe wartości podane w atrybutach googletag.defineSlot() i SizeMappingBuilder.addSize() są teraz automatycznie usuwane, ponieważ są nieprawidłowe. W efekcie istniejące integracje, które podają takie nieprawidłowe wartości, mogą spowodować wzrost liczby komunikatów w konsoli wydawcy.
Nie będzie to jednak miało wpływu na istniejące, prawidłowe żądania reklamy.
Tydzień zaczynający się 18 maja 2023 r.
Instalacja skryptów licytującego Bezpieczne sygnały przez GPT zostanie teraz przeprowadzona wcześniej w ramach wykonywania GPT. Może to poprawić zasięg sygnałów w żądaniach reklamy.
Tydzień zaczynający się 1 maja 2023 r.
Naprawiono błąd polegający na tym, że podczas odświeżania boksów zakotwiczonych o wielu rozmiarach kreacja mogła być obcięta.
Tydzień zaczynający się 27 marca 2023 r.
GPT nie obsługuje już funkcji opartych na widoczności w przeglądarkach, które nie obsługują natywnie Intersection Observer API. Pamiętaj, że wszystkie obsługiwane przeglądarki natywnie obsługują ten interfejs API.
| 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ść w GPT | |
|---|---|
| Obiekt |
BidderSignalProviderPublisherSignalProviderSecureSignalProvidersArray
|
| Typ |
SecureSignalProvider
|
| Zmienna |
googletag.secureSignalProviders
|
Tydzień zaczynający się 30 stycznia 2023 r.
Działanie funkcji 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ą detektory zdarzeń rozpoczęcia i zakończenia renderowania przedziałów dla tego samego przedziału mogły działać w nieprawidłowej kolejności.
Tydzień zaczynający się 15 sierpnia 2022 r.
Typ zwrotu Service.removeEventListener() został zmieniony z boolean na void.
Tydzień zaczynający się 25 lipca 2022 r.
Dodaliśmy eksperymentalną obsługę aukcji komponentów FLEDGE, aby umożliwić wstępne testowanie FLEDGE z udziałem wielu sprzedawców.
| Nowość w GPT | |
|---|---|
| Metoda |
Slot.setConfig()
|
| Obiekt |
ComponentAuctionConfigSlotSettingsConfig
|
Tydzień zaczynający się 18 lipca 2022 r.
Interfejs ContentService API został wycofany. Połączenie z numerem googletag.content().setContent nie ma teraz żadnego efektu poza zarejestrowaniem ostrzeżenia. Właściwość googletag.content zostanie wkrótce całkowicie usunięta. Późniejsza próba wywołania jej będzie skutkować wystąpieniem wyjątku. Aby bezpośrednio dodawać zawartość do elementów div, użyj wbudowanych w przeglądarce interfejsów DOM API.
Tydzień zaczynający się 23 maja 2022 r.
Dodaliśmy obsługę konfigurowania źródła wizyt w żądaniu reklamy.
| Obsługa tagów GPT w przypadku źródła wizyt | |
|---|---|
| Typ wyliczeniowy |
TrafficSource.ORGANICTrafficSource.PURCHASED
|
| Właściwość | PrivacySettingsConfig.trafficSource |
Tydzień zaczynający się 7 marca 2022 r.
Dodaliśmy reklamy z nagrodą w internecie. 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.
Metoda CommandArray.push teraz wyraźnie wiąże podane funkcje z obiektem globalThis, a nie z własnym obiektem arguments.
Tydzień zaczynający się 8 grudnia 2021 r.
Wyliczenia udostępniają teraz także odwrotne mapowanie wartości na klucze w celu dopasowania działania wyliczeń TypeScript. Interfejsy API, które przyjmują wartości enum, pozostają niezmienione i nie należy używać nowych odwrotnych mapowań.
Tydzień zaczynający się 9 sierpnia 2021 r.
Dodano metodę removeEventListener.
Wywołanie funkcji addEventListener wielokrotnie z tym samym zdarzeniem eventType i instancji funkcji wywołania zwrotnego jest teraz nieaktywne. Inaczej mówiąc, jeśli pojedyncza instancja funkcji wywołania zwrotnego jest zarejestrowana n razy dla tego samego typu zdarzenia, zostanie wykonana tylko raz po wystąpieniu zdarzenia, a nie tylko raz.
Tydzień zaczynający się 29 lipca 2021 r.
Zdarzenia widoczności GPT: ImpressionViewableEvent i SlotVisibilityChangedEvent będą teraz nadal uruchamiane w przypadku długich sesji stron. Wcześniej były wyłączane po godzinie od wczytania strony.
Tydzień zaczynający się 3 maja 2021 r.
GPT nie ustawia już miejsca na boksy przed pobraniem reklam. Ta zmiana ogranicza skumulowane przesunięcie układu (CLS) w witrynach, które nie mają zarezerwowanego miejsca za pomocą CSS. Aby jeszcze bardziej ograniczyć CLS w witrynie, zalecamy zarezerwowanie dla reklamy obszaru o innej wartości niż zero, korzystając z CSS. Więcej informacji
Tydzień zaczynający się 22 marca 2021 r.
Zaktualizowano działanie elementu enableLazyLoad(), by opóźniać renderowanie boksów w części strony widocznej po przewinięciu na kartach w tle.
Tydzień zaczynający się 23 lutego 2021 r.
Metody googletag.pubads().set i Slot.set można teraz wywołać w dowolnym momencie przed display lub refresh. Poprzednio ustawienie set było stosowane tylko w przypadku wywołania przed googletag.enableServices.
Tydzień zaczynający się 16 lutego 2021 r.
Interfejs googletag.pubads().setPublisherProvidedId API może być teraz wywoływany w dowolnym momencie. Wcześniej działało tylko wtedy, gdy funkcja została wywołana przed googletag.enableServices.
Tydzień zaczynający się 4 stycznia 2021 r.
Interfejs googletag.pubads().collapseEmptyDivs API może być teraz wywoływany wielokrotnie w celu zmiany ustawień. Wcześniej powtarzające się wywołania będą ignorowane.
Tydzień zaczynający się 12 października 2020 r.
Wprowadziliśmy otwartą wersję beta reklam pełnoekranowych w przeglądarce. Więcej informacji znajdziesz w Centrum pomocy.
Tydzień zaczynający się 31 sierpnia 2020 r.
Wycofano zasady definePassback() i defineOutOfPagePassback(). Informacje o poprawnym tworzeniu przebiegu zwrotnego znajdziesz w dokumentacji przebiegu zwrotnego.
Tydzień zaczynający się 15 czerwca 2020 r.
Zaktualizowano działanie elementu enableLazyLoad(), aby był zgodny z collapseEmptyDivs(true).
Tydzień zaczynający się 25 maja 2020 r.
GPT nie będzie już obsługiwać dokładnej lokalizacji GPS określonej przez wydawców. Oznacza to, że googletag.pubads().setLocation() nie będzie już obsługiwać parametrów szerokości i długości geograficznej ani promienia, a zamiast tego przyjmuje dowolny adres.
Tydzień zaczynający się 27 kwietnia 2020 r.
Logika renderowania GPT nie jest już modułowa w oddzielne pliki. Oznacza to, że podczas wykonywania kodu GPT będzie pobierać mniej plików, a przez to nieco zmniejszyć czas oczekiwania, ale nie będzie to miało żadnego wpływu na przepustowość użytkownika.
Gdy żądanie zostanie wywołane w GPT (przez wywołanie googletag.display() lub googletag.pubads().refresh()), wewnętrzne zablokujemy wszystkie stany podane przez wydawcę, aby nie można było go zmodyfikować przed wysłaniem żądania. Dlatego po wywołaniu żądania używany będzie tylko stan dodany do tego momentu. Każdy zmodyfikowany stan będzie mieć zastosowanie tylko do następujących żądań.
Tydzień zaczynający się 11 listopada 2019 r.
Wprowadziliśmy nowy zalecany fragment kodu do tworzenia przebiegów zwrotnych GPT. Odradzamy używanie funkcji definePassback() i defineOutOfPagePassback(), ponieważ te funkcje działają 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 dodatkowe ustawienia.
Tydzień zaczynający się 25 marca 2019 r.
Usługa Pubads jest teraz w pełni działająca od razu po wywołaniu metody googletag.enableServices(). Nie była inicjowana asynchronicznie. Oznacza to, że działanie googletag.pubadsReady jest gwarantowane od razu po wywołaniu funkcji googletag.enableServices(). Odpytywanie w celu sprawdzenia wartości googletag.pubadsReady nie powinno już być konieczne.
Tydzień zaczynający się 4 lutego 2019 r.
Zaktualizowaliśmy działanie komponentu enableLazyLoad(), aby umożliwić zmiany w konfiguracji leniwego ładowania po wywołaniu enableServices(), z zablokowaną konfiguracją leniwego ładowania dla każdego przedziału, gdy ten przedział jest wyświetlany.
Tydzień zaczynający się 21 stycznia 2019 r.
Dodaliśmy nowe obsługiwane zdarzenie SlotResponseReceived, które jest uruchamiane, gdy dla danego boksu zostanie przyjęta odpowiedź na reklamę.
Do listy googleTag.ResponseInformation dodano nowe pole: creativeTemplateId.
Tydzień zaczynający się 14 stycznia 2019 r.
Dodaliśmy nowe obsługiwane zdarzenie SlotRequestedEvent, które jest uruchamiane, gdy dla boksu zostanie wysłane żądanie reklamy.
Tydzień zaczynający się 27 sierpnia 2018 r.
Zmieniono element googletag.display(), aby akceptował googletag.Slot jako argument.
Tydzień zaczynający się 6 sierpnia 2018 r.
Dodaje googletag.PubAdsService.enableLazyLoad() na potrzeby leniwego ładowania reklam w GPT.
Tydzień zaczynający się 18 czerwca 2018 r.
Naprawiono błąd, który powodował, że googletag.events.SlotOnloadEvent nie uruchamiał się.
Tydzień zaczynający się 30 kwietnia 2018 r.
Dodaje googletag.PubAdsService.setTagForUnderAgeOfConsent() w przypadku kontrolowania reklam w przypadku użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody, i 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(), który umożliwia kontrolowanie personalizacji reklam.
Tydzień zaczynający się 12 marca 2018 r.
Cofnięto zmianę, która przed odświeżeniem przestała usuwać istniejącą treść z boksów, jeśli ta treść nie została w nim umieszczona przez GPT. Zawartość zostanie wyczyszczona.
Tydzień zaczynający się 19 lutego 2018 r.
Gdy używany jest tryb renderowania asynchronicznego: w miarę możliwości wysyłaj żądania reklam za pomocą XMLHttpRequest z metodą HTTP GET w przypadku wszystkich żądań reklamy (maksymalnie 8192 znaki). Wcześniej metoda HTTP POST była używana w przypadku żądań reklam o długości przekraczającej 4096 znaków (maksymalnie 8192 znaki).
Zatrzymano usuwanie istniejącej treści z boksów przed odświeżeniem, jeśli ta treść nie została tam umieszczona przez GPT. Ta notatka jest nieprawidłowa – zobacz wpis dotyczący tygodnia zaczynającego się od 12 marca 2018 r.
Tydzień zaczynający się 8 stycznia 2018 r.
Obsługuj alternatywną składnię funkcji [..., ['fluid'], ...] jako element NamedSized w tablicy o wielu rozmiarach. Wcześniej tylko wartość [..., 'fluid', ...] była uznawana za prawidłową.
Tydzień zaczynający się 10 lipca 2017 r.
Usunięto pole labelIds z parametru googleTag.ResponseInformation.
Tydzień zaczynający się 5 czerwca 2017 r.
Zmodyfikowano googletag.display() i googletag.pubads().display, tak aby akceptowały zarówno element div, jak i identyfikator div. Umożliwia to renderowanie boksów wewnątrz elementów div w modelu DOM.
Tydzień zaczynający się 27 lutego 2017 r.
Tydzień zaczynający się 7 listopada 2016 r.
Udostępniliśmy interfejs getSlots() API on Service, który służy do pobierania listy przedziałów powiązanych z usługą.
Tydzień zaczynający się 17 października 2016 r.
Zmieniono parametry Slot.clearTargeting() i PubAdsService.clearTargeting(), aby przyjmowały opcjonalny parametr klucza.
Tydzień zaczynający się 5 września 2016 r.
Błędy przechwycone w trybie googletag.cmd.push() nie są już niewidoczne i zostaną wydrukowane w konsoli.
Tydzień zaczynający się 8 sierpnia 2016 r.
Udostępniliśmy interfejs API SlotOnloadEvent, który umożliwia nasłuchiwanie zakończenia wczytywania kreacji.
Tydzień zaczynający się 25 lipca 2016 r.
Udostępniliśmy w PuAdsService interfejsy API getTargeting() i getTargetingKeys() do pobierania niestandardowych parametrów kierowania na poziomie usługi.
Tydzień zaczynający się 20 czerwca 2016 r.
Udostępniliśmy interfejs API openConsole(), który umożliwia otwieranie Konsoli 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 powinna zezwalać na rozwijanie przez przekazywanie treści: allowPushExpansion.
Tydzień zaczynający się 16 maja 2016 r.
obsługiwać rozmiary elastyczne 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 reklamę w przypadku danego boksu reklamowego.
Udostępniliśmy interfejs API setAdIframeTitle, który ustawia dane wejściowe jako tytuł wszystkich utworzonych później elementów iframe kontenera reklam.
Tydzień zaczynający się 4 kwietnia 2016 r.
Zwiększono maksymalną długość żądania reklamy HTTP GET do 4096 znaków.
Tydzień zaczynający się 28 marca 2016 r.
Dodano opcję konfiguracji, w której SafeFrame powinna zezwalać na rozwijanie przez nakładanie treści: allowOverlayExpansion.
Dodano opcję konfiguracji, w której element SafeFrame powinien używać atrybutu piaskownicy HTML5, aby uniemożliwić nawigację na najwyższym poziomie: sandbox.
Tydzień zaczynający się 22 lutego 2016 r.
Dodano możliwość 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.
Dodano możliwość niszczenia boksu i ponownego użycia elementu div: destroySlots().
Dodanie interfejsu API w celu wymuszania użycia SafeFrame w boksach reklamowych za pomocą szczegółowych ustawień: setForceSafeFrame().
Tydzień zaczynający się 7 grudnia 2015 r.
Dodawanie zdarzeń widoczności przedziałów (SlotVisibilityChangedEvent).
Tydzień zaczynający się 26 października 2015 r.
Dodaję widoczność wyświetlenia (ImpressionViewableEvent).
Aktualizowanie kierowania na przebieg zwrotny z poziomu mapy JSON (Passback.updateTargetingFromMap()).
Tydzień zaczynający się 12 października 2015 r.
Obsługa przebiegu zwrotnego poza stroną.
Tydzień zaczynający się 31 sierpnia 2015 r.
Przekształcenie architektury GPT w cieńszy program wczytujący i większą implementację.
Obsługa rozmiaru elastycznego w GPT.