Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Mostrar um anúncio âncora
Neste exemplo, um anúncio âncora usa a biblioteca de Tag do editor do Google (GPT).
Saiba mais sobre os anúncios de âncora na
Central de Ajuda do Google Ad Manager.
Visualizar anúncios âncora
É possível exibir um anúncio âncora de demonstração em qualquer página que mostre anúncios com a GPT adicionando
#gamTopAnchorDemo ou #gamBottomAnchorDemo ao URL. Por exemplo,
https://www.example.com/#gamTopAnchorDemo.
Essa funcionalidade pode ser usada para visualizar anúncios âncora no seu site sem precisar fazer mudanças
no código. Isso é especialmente útil para validar rapidamente como as âncoras vão
aparecer e se comportar em diferentes dispositivos e em diferentes ambientes operacionais.
Notas de uso
Para garantir uma experiência ideal do usuário, os anúncios âncora são solicitados apenas em
páginas que oferecem suporte adequado ao formato. Por isso,
defineOutOfPageSlot() pode retornar nulo. Verifique esse caso para
garantir que você não está fazendo um trabalho desnecessário. No momento, os anúncios de âncora são
aceitas se as seguintes condições forem atendidas:
A GPT está em execução na janela de cima.
Em uma página otimizada para dispositivos móveis em que o zoom é neutro, isso geralmente significa
que o editor tem <meta name="viewport" content="width=device-width,
initial-scale=1"> ou algo semelhante no <head> da página.
A janela de visualização está na orientação retrato com uma largura entre 320px e
1000px.
Solicite anúncios âncora somente em páginas/ambientes onde você quer que uma âncora
apareça. Os anúncios âncora podem ser veiculados em computadores, tablets e dispositivos móveis.
Os anúncios âncora geram o próprio contêiner de anúncios. Ao contrário de outros tipos de anúncios, não é
necessário definir um <div> para anúncios âncora. Os anúncios âncora criam e inserem automaticamente o próprio contêiner na página quando um anúncio é preenchido. Esses
conteineres podem se sobrepor ou obstruir outros elementos usando posicionamento absoluto ou
fixo. Portanto, é recomendável evitar colocar esses elementos em áreas
em que as âncoras devem aparecer.
Se você usar a arquitetura de solicitação única (SRA, na sigla em inglês) em uma página com vários espaços,
não chame display() até que os divs de espaços do anúncio estático sejam criados. Conforme
explicado nas Práticas recomendadas de anúncios, a primeira chamada de display()
solicita todos os espaços de anúncio definidos antes desse ponto. Embora os espaços de anúncios âncora
não exijam um <div> predefinido, os espaços de anúncios estáticos exigem. Chamar display()
antes que esses elementos estejam presentes na página pode resultar em indicadores de qualidade
inferior, reduzindo a monetização. Por isso, recomendamos atrasar a
chamada inicial até que os espaços estáticos sejam definidos.
Somente anúncios âncora visíveis podem ser atualizados. Quando um espaço de anúncio âncora é
recolhido ou ainda não foi rolado para aparecer, todas as chamadas para refresh() são
ignoradas. No entanto, se você estiver usando disableInitialLoad() para
controlar o carregamento e a atualização de anúncios manualmente, a primeira chamada
para refresh() vai acionar uma solicitação de anúncio, seja qual for a visibilidade do espaço.
[null,null,[],[],[],null,["# Display an anchor ad\n====================\n\nThis example displays an anchor ad using the Google Publisher Tag (GPT) library.\nLearn more about anchor ads in the\n[Google Ad Manager help center](//support.google.com/admanager/answer/10452255).\n\nPreview anchor ads\n------------------\n\nYou can display a demo anchor ad on any page that shows ads with GPT by adding\n`#gamTopAnchorDemo` or `#gamBottomAnchorDemo` to the URL. For example,\n`https://www.example.com/#gamTopAnchorDemo`.\n\nThis functionality can be used to preview anchor ads on your site with no code\nchanges required. This is especially useful to quickly validate how anchors will\nlook and behave on different devices and in different operating environments.\n\nUsage notes\n-----------\n\n- **To ensure an optimal user experience, anchor ads are only requested on\n pages that properly support the format.** Because of this,\n `defineOutOfPageSlot()` may return null; you should check for this case to\n ensure you're not doing any unnecessary work. Currently, anchor ads are\n supported if the following conditions are met:\n\n - GPT is running in the top window.\n - On a mobile optimized page where zoom is neutral; typically this means the publisher has `\u003cmeta name=\"viewport\" content=\"width=device-width,\n initial-scale=1\"\u003e` or similar in the `\u003chead\u003e` of the page.\n - Viewport is in a portrait orientation with a width between `320px` and `1000px`.\n- **Only request anchor ads on pages/environments where you want an anchor to\n appear.** Anchor ads are eligible to serve to desktop, tablet, and mobile\n devices.\n\n | **Note:** You can use Chrome DevTools [mobile simulation](//developers.google.com/web/tools/chrome-devtools/device-mode#viewport) to test anchor ads on mobile from a desktop environment.\n- **Anchor ads generate their own ad container.** Unlike other ad types, it's\n not necessary to define a `\u003cdiv\u003e` for anchor ads. Anchor ads automatically\n create and insert their own container into the page when an ad fills. These\n containers may overlap or occlude other elements using absolute or fixed\n positioning, so it's recommended to avoid placing such elements in areas\n where anchors are meant to appear.\n\n- **If using single-request architecture (SRA) on a page with multiple slots,\n don't call `display()` until static ad slots divs are created.** As\n explained in [Ad Best Practices](//developers.google.com/publisher-tag/guides/ad-best-practices#use_single_request_architecture_correctly), the first call to `display()`\n requests every ad slot defined prior to that point. Although anchor ad slots\n do not require a predefined `\u003cdiv\u003e`, static ad slots do. Calling `display()`\n before these elements are present on the page can result in lower quality\n signals, reducing monetization. Because of this, we recommend delaying the\n initial call until after the static slots are defined.\n\n- **Only visible anchor ads may be refreshed.** When an anchor ad slot is\n collapsed or not yet scrolled into view, all calls to `refresh()` are\n ignored. If you're using `googletag.setConfig({ disableInitialLoad: true })`\n to manually [control ad loading and refresh](//developers.google.com/publisher-tag/guides/control-ad-loading), however, the\n first call to `refresh()` will trigger an ad request regardless of the slot\n visibility.\n\nSample implementation\n---------------------\n\n[View demo](https://googleads.github.io/google-publisher-tag-samples/display-anchor-ad/js/demo.html) This sample makes use of library features that are not fully supported when running in an iframe. To view a demo of this sample in a new window, click the **View demo** button above. \n\n### JavaScript\n\nLoading...\n----------\n\nLoading...\n----------\n\n[Improve this sample](https://github.com/googleads/google-publisher-tag-samples/tree/main/dist/display-anchor-ad/js) [Report an issue](https://github.com/googleads/google-publisher-tag-samples/issues/new?labels=documentation&template=sample-feedback.md&title=Sample+feedback%3A+display-anchor-ad/js)\n\n### TypeScript\n\nLoading...\n----------\n\nLoading...\n----------\n\n[Improve this sample](https://github.com/googleads/google-publisher-tag-samples/tree/main/dist/display-anchor-ad/ts) [Report an issue](https://github.com/googleads/google-publisher-tag-samples/issues/new?labels=documentation&template=sample-feedback.md&title=Sample+feedback%3A+display-anchor-ad/ts)"]]
