Notas da versão da GPT

Nesta página, documentamos as atualizações de produção da biblioteca da tag do Google Publisher (GPT). É possível acessá-la periodicamente para consultar avisos sobre recursos novos ou atualizados, correções de bugs, problemas conhecidos e funcionalidades suspensas.

Para receber atualizações, adicione o URL desta página ao seu leitor de feeds preferido ou use um link direto para o feed de notas da versão no formato Atom 1.0ícone do feed ou RSS 2.0ícone do feed.

Sobre datas de lançamento

Todas as mudanças na biblioteca GPT são testadas antes do lançamento. Além disso, os lançamentos são disponibilizados aos usuários gradualmente para aumentar a proteção contra regressões inesperadas. Se uma regressão for detectada em qualquer ponto durante um lançamento, toda a versão poderá ser rapidamente abandonada antes de chegar a todos os usuários.

Por isso, as datas de lançamento não são exatas. Um lançamento pode levar de alguns dias a algumas semanas para ser concluído. Isso significa que os usuários vão encontrar mudanças em momentos diferentes. As datas fornecidas nestas notas da versão refletem o início da semana em que uma mudança foi disponibilizada para todos os usuários.

Semana de 28 de julho de 2025

Várias configurações atuais no nível da página e do slot foram migradas para a nova API unificada de configuração do GPT. Essa migração traz várias melhorias:

  • Melhoria na descoberta: as configurações são agrupadas na documentação e nas definições de tipo.
  • Mais intuitivo: é possível configurar as opções individualmente ou todas de uma só vez usando uma única interface.
  • Erros mais claros: os erros de configuração fornecem mais detalhes e usam uma linguagem padronizada para facilitar a solução de problemas.

Os métodos de configuração legados continuam funcionando, mas são atualizados para usar o novo framework de configuração internamente. Como resultado, você pode encontrar mensagens de erro que fazem referência a propriedades da nova API de configuração, mesmo ao usar métodos legados.

O objeto SafeFrameConfig foi movido do namespace googletag para o namespace googletag.config.

A tabela a seguir lista os métodos de configuração legados que foram descontinuados, além das alternativas recomendadas da API de configuração.

Métodos de configuração legados Substituição da API de configuração da GPT
PubAdsService.set() PageSettingsConfig.adsenseAttributes
PubAdsService.clearCategoryExclusions()
PubAdsService.setCategoryExclusion()
PageSettingsConfig.categoryExclusion
PubAdsService.setCentering() PageSettingsConfig.centering
PubAdsService.collapseEmptyDivs() PageSettingsConfig.collapseDiv
PubAdsService.disableInitialLoad() PageSettingsConfig.disableInitialLoad
PubAdsService.enableLazyLoad() PageSettingsConfig.lazyLoad
PubAdsService.setLocation() PageSettingsConfig.location
PubAdsService.setForceSafeFrame()
PubAdsService.setSafeFrameConfig()
PageSettingsConfig.safeFrame
PubAdsService.enableSingleRequest() PageSettingsConfig.singleRequest
PubAdsService.clearTargeting()
PubAdsService.setTargeting()
PageSettingsConfig.targeting
PubAdsService.enableVideoAds()
PubAdsService.setVideoContent()
PageSettingsConfig.videoAds
PubAdsService.isInitialLoadDisabled()
PubAdsService.get()
PubAdsService.getAttributeKeys()
PubAdsService.getTargeting()
PubAdsService.getTargetingKeys()
googletag.getConfig()
Slot.set() SlotSettingsConfig.adsenseAttributes
Slot.clearCategoryExclusions()
Slot.setCategoryExclusion()
SlotSettingsConfig.categoryExclusion
Slot.setClickUrl() SlotSettingsConfig.clickUrl
Slot.setCollapseEmptyDiv() SlotSettingsConfig.collapseDiv
Slot.setForceSafeFrame()
Slot.setSafeFrameConfig()
SlotSettingsConfig.safeFrame
Slot.clearTargeting()
Slot.setTargeting()
Slot.updateTargetingFromMap()
SlotSettingsConfig.targeting
Slot.get()
Slot.getAttributeKeys()
Slot.getCategoryExclusions()
Slot.getTargeting()
Slot.getTargetingKeys()
Slot.getConfig()

Semana de 21 de julho de 2025

O recurso threadYield foi atualizado para também gerar a linha de execução JS antes de gerar um URL de solicitação de anúncio, para solicitações que contêm apenas slots abaixo da dobra. Isso demonstrou afetar positivamente as Core Web Vitals, sem impacto negativo nas impressões.

Atualizado na GPT
Propriedade googletag.config.PageSettingsConfig.threadYield

Semana de 2 de junho de 2025

Os intersticiais da Web agora são totalmente compatíveis com aplicativos de página única (SPA)

Agora os usuários da GPT podem exibir anúncios intersticiais da Web em sites com SPA sem precisar recarregar a página inteira. Essa melhoria pode:

  • Aprimorar a experiência do usuário: veicule anúncios em pontos de pausas naturais no SPA, resultando em transições suaves e menos interrupções.
  • Aumentar a monetização: aproveite novas oportunidades de receita veiculando anúncios intersticiais em conteúdo dinâmico com base em SPA.
  • Manter os Better Ads Standards: continue oferecendo experiências de anúncio de alta qualidade com opções de saída claras e limites de frequência configuráveis, seguindo as práticas recomendadas do setor.

Nenhuma mudança é necessária na sua implementação atual de SPA. A GPT vai detectar e gerenciar automaticamente a exibição de intersticiais para mudanças de página no SPA. Para mais detalhes sobre a implementação de intersticiais da Web gerenciados pela GPT e gatilhos opcionais de intersticiais, consulte o exemplo Mostrar um anúncio intersticial da Web .

Semana de 26 de maio de 2025

O limite de frequência para anúncios intersticiais de jogos H5 foi reduzido de 120 para 30 segundos.

Semana de 28 de abril de 2025

Novidades na GPT
Propriedade SlotRenderEndedEvent.responseIdentifier

Semana de 27 de janeiro de 2025

As seguintes propriedades ComponentAuctionConfig.auctionConfig foram renomeadas para se alinhar à especificação da API Protected Audience .

Nome antigo da propriedade Novo nome da propriedade
decisionLogicUrl decisionLogicURL
trustedScoringSignalsUrl trustedScoringSignalsURL

Semana de 21 de outubro de 2024

Modifique threadYield para usar Scheduler.yield em vez de Scheduler.postTask quando disponível. Consulte a documentação de receita para mais detalhes.

Atualizado na GPT
Propriedade googletag.config.PageSettingsConfig.threadYield

Semana de 2 de setembro de 2024

Semana de 19 de agosto de 2024

A configuração para controlar o comportamento de geração de linhas de execução do GPT foi renomeada de adYield para threadYield para esclarecer que o recurso se concentra na geração da linha de execução JS em vez de otimizar o rendimento de anúncios. O comportamento do recurso e da API associada (além do nome) permanecem inalterados. A propriedade adYield será removida em uma versão futura do GPT.

O comportamento padrão de geração de threads pode ser desativado com googletag.setConfig({threadYield: 'DISABLED'}); ou aplicado a todos os slots, independente da localização deles em relação à janela de visualização com googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'});.

Atualizado na GPT
Propriedade googletag.config.PageSettingsConfig.threadYield

Semana de 29 de julho de 2024

Agora, a GPT gera a linha de execução JS usando Scheduler.postTask (quando disponível) com prioridade: "user-blocking" pouco antes da renderização dos criativos. Isso demonstrou ter um impacto extremamente pequeno nas impressões, beneficiando significativamente as Core Web Vitals. Por padrão, a GPT só vai gerar se o slot estiver fora da janela de visualização.

O comportamento padrão pode ser desativado com googletag.setConfig({adYield: 'DISABLED'}); ou aplicado a todos os slots, independente da localização deles em relação à janela de visualização com googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'});.

Novidades na GPT
Propriedade googletag.config.PageSettingsConfig.adYield

Semana de 12 de fevereiro de 2024

Correção de um bug em que SlotRenderEndedEvent.slotContentChanged era sempre true. Daqui em diante, essa propriedade será true somente se o conteúdo do slot tiver mudado e false caso contrário (por exemplo, se um anúncio não foi preenchido).

Semana de 29 de janeiro de 2024

As falhas de rede para solicitações de anúncios vão simular uma ausência de preenchimento ao acionar um googletag.events.SlotRenderEndedEvent com isEmpty definido como true. Consulte Listeners de eventos de anúncio para ver um exemplo de como detectar esse evento. A mudança inclui o recolhimento automático do slot ao usar collapseEmptyDivs.

Semana de 11 de dezembro de 2023

Adição de compatibilidade com anúncios âncora da coluna lateral.

Novidades na GPT
Enumeração OutOfPageFormat.LEFT_SIDE_RAIL
OutOfPageFormat.RIGHT_SIDE_RAIL

Semana de 13 de novembro de 2023

Adição de suporte para pré-renderização do Chrome. Quando a GPT detecta que a página está em um estado de pré-renderização, a solicitação de anúncio é adiada até que a página fique visível para o usuário.

Semana de 23 de outubro de 2023

Adição de compatibilidade com gatilhos opcionais de intersticiais da Web.

Novidades na GPT
Objeto googletag.config.InterstitialConfig
Propriedade googletag.config.SlotSettingsConfig.interstitial
Tipo googletag.config.InterstitialTrigger

Semana de 24 de julho de 2023

A API Protected Audience (antes conhecida como FLEDGE) está em transição para disponibilidade geral com o lançamento de julho do Chrome. Com isso, a funcionalidade relacionada ao leilão de componentes na GPT agora é considerada estável.

Semana de 19 de junho de 2023

Atualização: a partir de 5 de julho de 2023, a GPT não vai mais veicular versões desatualizadas da biblioteca JavaScript nem anúncios para essas versões. Consulte o aviso anterior para mais detalhes.

Os editores que veiculam conteúdo em www.googletagservices.com/tag/js/gpt.js podem continuar fazendo isso. No entanto, recomendamos a mudança para o domínio preferencial, já que isso pode melhorar a performance, e a veiculação de gpt.js em www.googletagservices.com pode ser descontinuada no futuro.

Semana de 6 de junho de 2023

A partir de 5 de julho de 2023, a GPT não vai mais veicular versões desatualizadas da biblioteca JavaScript. Não há impacto para os editores que carregam a GPT de um URL oficial. Os editores que veiculam uma versão em cache de gpt.js, pubads_impl.js ou qualquer biblioteca carregada precisam atualizar as páginas para usar os URLs oficiais. Para mais informações, consulte o guia Começar.

Semana de 22 de maio de 2023

Valores de tamanho negativos e zero fornecidos para googletag.defineSlot() e SizeMappingBuilder.addSize() agora são removidos automaticamente porque são inválidos. Como resultado, as integrações atuais que fornecem esses valores inválidos podem ter um aumento nas mensagens do console do editor. No entanto, isso não vai afetar as solicitações de anúncios válidas.

Semana de 18 de maio de 2023

A instalação dos scripts de bidder de Indicadores seguros pela GPT agora será feita mais cedo na execução da GPT. Isso pode resultar em uma cobertura de sinal melhorada em todas as solicitações de anúncios.

Semana de 1º de maio de 2023

Correção de um bug em que o criativo podia aparecer truncado ao atualizar slots fixos de vários tamanhos.

Semana de 27 de março de 2023

A GPT não oferece mais suporte a recursos baseados em visibilidade em navegadores que não são compatíveis nativamente com a API Intersection Observer. Todos os navegadores compatíveis oferecem suporte nativo a essa API.

Método ou evento
googletag.events.ImpressionViewableEvent
googletag.events.SlotVisibilityChangedEvent
googletag.pubads().enableLazyLoad()

Semana de 6 de fevereiro de 2023

Semana de 30 de janeiro de 2023

O comportamento de Service.addEventListener() foi alterado para que, quando um evento ocorrer, todos os listeners associados sejam executados antes de processar um evento posterior. Antes dessa mudança, os listeners de eventos de início e fim da renderização de um mesmo slot podiam ser executados fora de ordem.

Semana de 15 de agosto de 2022

O tipo de retorno de Service.removeEventListener() foi mudado de boolean para void.

Semana de 25 de julho de 2022

Adicionamos suporte experimental para leilões de componentes do FLEDGE, permitindo o teste antecipado do FLEDGE com vários vendedores.

Novidades na GPT
Método Slot.setConfig()
Objeto ComponentAuctionConfig
SlotSettingsConfig

Semana de 18 de julho de 2022

A API ContentService foi desativada. Chamar googletag.content().setContent agora não tem efeito além de registrar um aviso. A propriedade googletag.content será removida em breve. Depois disso, tentar chamá-la vai gerar uma exceção. Use as APIs DOM integradas do navegador para adicionar conteúdo diretamente aos elementos div.

Semana de 23 de maio de 2022

Adição de suporte para configurar a origem de tráfego da solicitação de anúncio.

Suporte da GPT para origem do tráfego
Enumeração TrafficSource.ORGANIC
TrafficSource.PURCHASED
Propriedade PrivacySettingsConfig.trafficSource

Semana de 7 de março de 2022

Os anúncios premiados para a Web foram lançados. Acesse a Central de Ajuda do Ad Manager para mais detalhes.

Compatibilidade da GPT com anúncios premiados para a Web
Enumeração OutOfPageFormat.REWARDED
Evento RewardedSlotClosedEvent
Evento RewardedSlotGrantedEvent
Evento RewardedSlotReadyEvent
Objeto RewardedPayload

Semana de 28 de fevereiro de 2022

CommandArray.push agora vincula explicitamente as funções fornecidas a globalThis em vez do próprio objeto arguments.

Semana de 8 de dezembro de 2021

Os enums agora também expõem um mapeamento inverso de valores para chaves para corresponder ao comportamento dos enums do TypeScript. As APIs que aceitam valores de enumeração permanecem inalteradas, e esses novos mapeamentos inversos não devem ser usados.

Semana de 9 de agosto de 2021

Adição do método removeEventListener.

Chamar addEventListener várias vezes com o mesmo eventType e instância de função de callback agora é uma operação nula. Em outras palavras, se uma única instância de função de callback for registrada n vezes para o mesmo tipo de evento, ela será executada apenas uma vez quando o evento ocorrer, em vez de n vezes.

Semana de 29 de julho de 2021

Os eventos de visibilidade da GPT, ImpressionViewableEvent e SlotVisibilityChangedEvent agora vão continuar sendo disparados em sessões longas na página. Antes, eles eram encerrados uma hora após o carregamento da página.

Semana de 3 de maio de 2021

A GPT não define mais espaço para slots antes de buscar anúncios. Essa mudança reduz o Cumulative Layout Shift (CLS) em sites que não reservaram espaço usando CSS. Para reduzir ainda mais o CLS no seu site, recomendamos reservar uma área diferente de zero para o anúncio usando CSS. Saiba mais

Semana de 22 de março de 2021

Atualizamos o comportamento de enableLazyLoad() para também atrasar a renderização de slots abaixo da dobra em guias em segundo plano.

Semana de 23 de fevereiro de 2021

Os métodos googletag.pubads().set e Slot.set agora podem ser chamados a qualquer momento antes de display ou refresh. Antes, set só era aplicado quando chamado antes de googletag.enableServices.

Semana de 16 de fevereiro de 2021

A API googletag.pubads().setPublisherProvidedId pode ser chamada a qualquer momento. Antes, só funcionava se fosse chamado antes de googletag.enableServices.

Semana de 4 de janeiro de 2021

A API googletag.pubads().collapseEmptyDivs pode ser chamada repetidamente agora para mudar as configurações. As chamadas repetidas anteriores eram ignoradas.

Semana de 12 de outubro de 2020

Lançamos a versão Beta aberta de intersticiais da Web. Consulte a Central de Ajuda.

Semana de 31 de agosto de 2020

Os métodos definePassback() e defineOutOfPagePassback() foram suspensos. Consulte a documentação de devolução para saber como criar uma devolução corretamente.

Semana de 15 de junho de 2020

Atualizamos o comportamento de enableLazyLoad() para ser compatível com collapseEmptyDivs(true).

Semana de 25 de maio de 2020

A GPT não vai mais oferecer suporte à localização precisa por GPS definida pelos publishers. Especificamente, googletag.pubads().setLocation() não vai mais oferecer suporte a parâmetros de latitude, longitude ou raio, mas vai aceitar um endereço de formato livre.

Semana de 27 de abril de 2020

A lógica de renderização da GPT não é mais modularizada em arquivos separados. Isso significa que o GPT vai buscar menos arquivos na execução, reduzindo um pouco a latência, mas sem impacto líquido na largura de banda do usuário.

Quando uma solicitação é acionada no GPT (chamando googletag.display() ou googletag.pubads().refresh()), congelamos internamente todo o estado fornecido pelo editor para que ele não possa ser alterado antes do envio da solicitação. Portanto, quando uma solicitação é acionada, apenas o estado adicionado até esse momento é usado para ela. Qualquer estado modificado depois disso será aplicado apenas às solicitações a seguir.

Semana de 11 de novembro de 2019

Agora há um novo snippet recomendado para a criação de passbacks da GPT. Não é recomendável o uso de definePassback() e defineOutOfPagePassback(), porque essas funções se comportam de maneira síncrona e podem ser bloqueadas por certos navegadores. Saiba mais.

Adição do método Slot.updateTargetingFromMap().

Adicionamos o PubAdsService.setPrivacySettings() como um novo método para ativar as configurações de privacidade. Outras configurações vão estar disponíveis aqui no futuro.

Semana de 25 de março de 2019

O serviço Pubads agora está totalmente operacional imediatamente após a chamada de googletag.enableServices(), em vez de ser inicializado de forma assíncrona. Isso significa que googletag.pubadsReady agora tem garantia de ser verdadeiro logo após a chamada de googletag.enableServices(). Não é mais necessário fazer polling para verificar o valor de googletag.pubadsReady.

Semana de 4 de fevereiro de 2019

Atualizamos o comportamento de enableLazyLoad() para permitir mudanças na configuração de carregamento lento depois de chamar enableServices(). A configuração de carregamento lento é congelada para cada slot quando ele é exibido.

Semana de 21 de janeiro de 2019

Adição de um novo evento compatível, SlotResponseReceived, que é disparado quando uma resposta de anúncio é recebida para um slot.

Adicionamos um novo campo, creativeTemplateId, a googleTag.ResponseInformation.

Semana de 14 de janeiro de 2019

Adicionamos um novo evento compatível, SlotRequestedEvent, que é disparado quando uma solicitação de anúncio é feita para um slot.

Semana de 27 de agosto de 2018

O googletag.display() foi modificado para aceitar um googletag.Slot como argumento.

Semana de 6 de agosto de 2018

Adiciona googletag.PubAdsService.enableLazyLoad() para anúncios de carregamento lento na GPT.

Semana de 18 de junho de 2018

Correção de um bug que impedia o acionamento do googletag.events.SlotOnloadEvent.

Semana de 30 de abril de 2018

Adiciona googletag.PubAdsService.setTagForUnderAgeOfConsent() para controlar anúncios para usuários abaixo da idade de consentimento e googletag.PassbackSlot.setTagForUnderAgeOfConsent() para marcar o slot de retorno como proveniente de um usuário abaixo da idade de consentimento.

Semana de 23 de abril de 2018

Adiciona googletag.PubAdsService.setRequestNonPersonalizedAds() para controlar a personalização de anúncios.

Semana de 12 de março de 2018

Reversão da mudança que impedia a remoção de conteúdo em slots antes da atualização, se esse conteúdo não tivesse sido colocado ali pela GPT. O conteúdo será limpo.

Semana de 19 de fevereiro de 2018

Quando o modo de renderização assíncrona é usado: solicite anúncios usando XMLHttpRequest com o método HTTP GET sempre que possível para todas as solicitações de anúncios, até o limite de 8.192 caracteres. Antes, o método HTTP POST era usado para solicitações de anúncios com mais de 4.096 caracteres, até o limite de 8.192 caracteres.

Paramos de remover conteúdo de slots antes da atualização, se ele não foi colocado lá pela GPT. Esta observação está incorreta. Consulte a entrada da Semana de 12 de março de 2018.

Semana de 8 de janeiro de 2018

Suporte a sintaxe alternativa de [..., ['fluid'], ...] como um NamedSized em uma matriz de vários tamanhos. Antes, apenas [..., 'fluid', ...] era considerado válido.

Semana de 10 de julho de 2017

O campo "labelIds" foi removido de googleTag.ResponseInformation.

Semana de 5 de junho de 2017

Modificamos googletag.display() e googletag.pubads().display para aceitar um elemento div e um ID de div. Isso permite renderizar slots dentro de divs que estão em um shadow DOM.

Semana de 27 de fevereiro de 2017

Semana de 7 de novembro de 2016

Lançamento da API getSlots() no serviço para recuperar a lista de slots associados a um serviço.

Semana de 17 de outubro de 2016

Modificamos Slot.clearTargeting() e PubAdsService.clearTargeting() para usar um parâmetro de chave opcional.

Semana de 5 de setembro de 2016

Os erros detectados em googletag.cmd.push() não são mais invisíveis e serão impressos no console.

Semana de 8 de agosto de 2016

Lançamento da API SlotOnloadEvent para permitir a escuta da conclusão do carregamento de um criativo.

Semana de 25 de julho de 2016

Lançamos as APIs getTargeting() e getTargetingKeys() no PubAdsService para recuperar parâmetros de segmentação de nível de serviço personalizados.

Semana de 20 de junho de 2016

Lançamento da API openConsole() para abrir o Google Publisher Console sem precisar atualizar a página.

Semana de 6 de junho de 2016

Lançamento das APIs getTargeting() e getTargetingKeys() para recuperar parâmetros de segmentação personalizada.

Adição da opção de configuração em que o SafeFrame deve permitir a expansão ao enviar conteúdo: allowPushExpansion.

Semana de 16 de maio de 2016

Compatibilidade com tamanho flexível em solicitações de anúncios de vários tamanhos.

Semana de 18 de abril de 2016

Lançamento da API getResponseInformation, que retorna informações de resposta do anúncio para o local do anúncio.

Lançamento da API setAdIframeTitle, que define a entrada como o título de todos os iframes de contêiner de anúncio criados depois.

Semana de 4 de abril de 2016

Aumentamos o tamanho máximo da solicitação de anúncio HTTP GET para 4.096 caracteres.

Semana de 28 de março de 2016

Adição da opção de configuração em que o SafeFrame permite a expansão sobrepondo o conteúdo: allowOverlayExpansion.

Adição da opção de configuração em que o SafeFrame usa o atributo sandbox do HTML5 para impedir a navegação de nível superior: sandbox.

Semana de 22 de fevereiro de 2016

Adição da capacidade de definir títulos para iframes de contêiner de anúncios: setAdIframeTitle().

Adicionar uma API para configurar propriedades do SafeFrame no nível da página e do slot: setSafeFrameConfig().

Semana de 15 de fevereiro de 2016

Adição da capacidade de destruir um slot e reutilizar a div: destroySlots().

Adição de uma API para forçar o uso do SafeFrame em espaços de anúncio com controles granulares: setForceSafeFrame().

Semana de 7 de dezembro de 2015

Adição de eventos de visibilidade do espaço (SlotVisibilityChangedEvent).

Semana de 26 de outubro de 2015

Adição da visibilidade da impressão (ImpressionViewableEvent).

Atualize a segmentação de retorno de chamada de um mapa JSON (Passback.updateTargetingFromMap()).

Compatibilidade com o atributo page_url do AdSense set() e get() para slots de devolução.

Semana de 12 de outubro de 2015

Suporte para retorno fora da página.

Semana de 31 de agosto de 2015

Reestruturação da arquitetura do GPT em um carregador simples e uma implementação maior.

Suporte a tamanho flexível no GPT.