Tipos de canal
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Todas as chamadas para adBreak() precisam especificar um tipo de posição. Essa é uma string que descreve o estado do jogo quando o anúncio será exibido. Seu jogo está
só carregando? O jogador pausou o jogo? Ele já alcançou um ponto no
jogo onde poderia receber uma recompensa?
O tipo exato que você usa é importante. Isso pode afetar diretamente o tipo
de experiência do anúncio que será exibido (intersticial ou anúncio premiado). Mas ele também pode ter outros efeitos menos visíveis no comportamento da API. É
importante especificar o tipo de posição corretamente para que a API funcione
de maneira ideal.
| Tipo de canal |
Descrição |
'preroll' |
O jogo não carregou a IU e não está tocando som. Só pode haver uma posição de "precedente" no jogo para cada carregamento de página.
Exemplo: um jogador clica no seu jogo dentro de um catálogo. A tela do jogo é exibida e, antes da renderização da IU, ou da ativação do som de um anúncio. O jogador pode clicar no anúncio ou dispensá-lo nesse momento. |
'start' |
O jogo foi carregado, a IU está visível, e o som está ativado, mas o jogador pode interagir com o jogo, mas o jogo ainda não começou.
Exemplo:você exibirá uma breve tela de carregamento "Carregando..." e um anúncio intersticial será exibido. O jogador pode clicar no anúncio ou dispensá-lo para continuar no jogo.
OBSERVAÇÃO:uma preroll faz muito mais trabalho para você do que uma posição start. O preroll aguarda a inicialização da API e pré-carrega os anúncios automaticamente. Use preroll em vez de start no primeiro anúncio que aparece durante o carregamento do jogo antes da renderização da IU. A start é uma posição melhor quando a IU é renderizada e o jogador pode interagir com o jogo.
start também pode ser usado quando o jogo é reiniciado. Pode haver várias start posições por carregamento de página. Caso uma posição start seja a primeira posição do jogo (ou seja, você não usa a posição preroll), talvez seja necessário solicitar manualmente que os anúncios sejam pré-carregados. |
'pause' |
O jogador pausa o jogo.
Exemplo: o jogador pausa o jogo, e um anúncio intersticial é exibido. O anúncio permanece na tela até que o jogador o dispense. Quando eles retornam, o jogo ainda está pausado. O jogador poderá retomar o jogo e continuar jogando. |
'next' |
O jogador navega para o próximo nível.
Exemplo:o jogador acabou de concluir um nível. Ele toca em um botão "Próximo nível..." um anúncio intersticial é exibido. Eles veem o anúncio, o dispensam e prosseguem para o próximo nível. |
'browse' |
O jogador vê opções fora do jogo.
Exemplo: o jogador quer mudar o estilo do personagem. Ele toca no botão "Opções..." um anúncio intersticial é exibido. Eles veem o anúncio, dispensam e seguem para o editor de caracteres. |
'reward' |
O jogador atinge um ponto do jogo em que pode receber uma recompensa.
Exemplo: o jogador morreu e ficou sem vidas. Nesse caso, os usuários terão uma vida útil extra se assistirem a um anúncio. A API Ad Placement chama seu código para oferecer a recompensa ao jogador. Ele toca no botão de recompensa e assiste a um anúncio em vídeo. Eles recebem uma nova vida e continuam jogando. |
Observação: esse conjunto de tipos de posições é uma
área de desenvolvimento ativo.
Se você tem posições no seu jogo que não se encaixam naturalmente em uma dessas
categorias, informe seu gerente de contas do Google. Usaremos esse
feedback ao longo do tempo para refinar essas categorias.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eAll calls to \u003ccode\u003eadBreak()\u003c/code\u003e require a placement type string describing the game's state when the ad is shown (e.g., loading, paused, reward offered).\u003c/p\u003e\n"],["\u003cp\u003eThe placement type impacts the ad experience (interstitial or rewarded) and the API's behavior, so accurate specification is crucial for optimal performance.\u003c/p\u003e\n"],["\u003cp\u003ePlacement types include \u003ccode\u003epreroll\u003c/code\u003e (before UI loads), \u003ccode\u003estart\u003c/code\u003e (after UI loads), \u003ccode\u003epause\u003c/code\u003e, \u003ccode\u003enext\u003c/code\u003e, \u003ccode\u003ebrowse\u003c/code\u003e, and \u003ccode\u003ereward\u003c/code\u003e, each with specific use cases.\u003c/p\u003e\n"],["\u003cp\u003eWhile the current placement types cover common scenarios, developers with unique placements should inform their Google Account Manager for potential refinements to the categories.\u003c/p\u003e\n"]]],["The `adBreak()` function requires a placement type string, which defines the game's state when an ad appears. Placement types include `'preroll'` (game loading, before UI), `'start'` (game loaded, UI visible), `'pause'` (game paused), `'next'` (level transition), `'browse'` (exploring non-gameplay options), and `'reward'` (player offered an in-game reward for watching an ad). The selected placement directly impacts ad type and API behavior. `'preroll'` preloads ads and is preferable for the first ad.\n"],null,["# Placement types\n\nAll calls to `adBreak()` must specify a placement type. This is a string that\ndescribes the state of your game when the ad will be shown. Is your game just\nloading? Has the player paused the game play? Or have they reached a point in\nyour game where they could be offered a reward?\n\nThe precise type that you use is important. As it can directly affect the kind\nof ad experience that will be shown (an interstitial versus a rewarded ad). But\nit can also have other less visible effects on behaviour of the API. It's\nimportant that you specify the placement type correctly so the API can work\noptimally.\n\n| Placement type | Description |\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `'preroll'` | Your game has not loaded its UI and is not playing sound. There can only be one 'preroll' placement in your game for each page load. **Example:** a player clicks on your game within a game catalogue. The game canvas is displayed, and before your game renders its UI or enables sound an ad is shown. The player can click on the ad or dismiss it at which point the game will start. |\n| `'start'` | Your game has loaded, the UI is visible and sound is enabled, the player can interact with the game, but the game play has not started yet. **Example:** You display a brief loading screen \"Loading...\" and an interstitial ad is shown. The player can click on the ad or dismiss it to continue to the game. **NOTE:** A `preroll` does quite a bit more work for you than a `start` placement. `preroll` waits for the API to initialise and automatically preloads ads. You should use `preroll` instead of `start` for the very first ad that's shown while your game is loading, before the UI has rendered. `start` is a better placement once your UI has rendered and the player is able to interact with the game. `start` can also be used when the game restarts---there can be multiple `start` placements per page load. If a `start` placement is the very first placement in your game (i.e. you don't use the `preroll` placement), you may need to [manually request that ads are preloaded](/ad-placement/docs/preload-ads). |\n| `'pause'` | The player pauses the game. **Example:** the player pauses the game and an interstitial ad is shown. The ad remains on the screen until the player dismisses it. When they return the game is still paused. The player can then resume the game and keep playing. |\n| `'next'` | The player navigates to the next level. **Example:** The player has just completed a level. They tap a button \"Next level...\" an interstitial ad is shown. They view the ad, dismiss it, and proceed to the next level. |\n| `'browse'` | The player explores options outside of the gameplay. **Example:** The player wants to alter the style of their character. They tap the button \"Options...\" an interstitial ad is shown. They view the ad, dismiss it, and proceed to the character editor. |\n| `'reward'` | The player reaches a point in the game where they can be offered a reward. **Example:** The player has just died and run out of lives. They are offered a bonus life at this point if they watch an ad. The Ad Placement API calls your code to offer the reward to the player. They tap the reward button and watch all of a video ad. They then receive a new life and keep playing. |\n\n**Note**: this set of placement types is an\narea of active development.\n\nIf you have placements in your game that don't naturally fit into one of\nthese categories, let your Google Account Manager know, and we will use this\nfeedback over time to refine these categories."]]
