Tipos de ubicaciones
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Todas las llamadas a adBreak() deben especificar un tipo de posición. Es una string que describe el estado del juego cuando se mostrará el anuncio. ¿El juego se está cargando? ¿El jugador detuvo el juego? ¿Llegaron a un punto del juego en el que se les podría ofrecer una recompensa?
El tipo preciso que use es importante. ya que puede afectar directamente el tipo de experiencia del anuncio que se mostrará (anuncios intersticiales y anuncios recompensados). Sin embargo, también puede tener otros efectos menos visibles en el comportamiento de la API. Es importante que especifiques el tipo de posición correctamente para que la API funcione de manera óptima.
| Tipo de posición |
Descripción |
'preroll' |
El juego no cargó su IU y no está reproduciendo sonido. Solo puede haber una posición de "preroll" en el juego para cada carga de página.
Ejemplo: un jugador hace clic en el juego dentro de un catálogo de juegos. Se muestra el lienzo del juego y, antes de que el juego renderice su IU o habilite el sonido, se muestra un anuncio. El jugador puede hacer clic en el anuncio o descartarlo cuando comience el juego. |
'start' |
Se cargó el juego, se ve la IU y se habilita el sonido, el jugador puede interactuar con el juego, pero todavía no comenzó.
Ejemplo: Se muestra una breve pantalla de carga (Cargando...) y se muestra un anuncio intersticial. El jugador puede hacer clic en el anuncio o descartarlo para continuar con el juego.
NOTA: Un preroll hace un poco más de trabajo que una posición de start. preroll espera a que se inicie la API y precarga los anuncios automáticamente. Debes usar preroll en lugar de start para el primer anuncio que se muestra mientras se carga el juego antes de que se renderice la IU. start es una mejor posición una vez que se renderiza la IU y el jugador puede interactuar con el juego.
start también se puede usar cuando se reinicia el juego: puede haber varias posiciones de start por carga de página. Si una ubicación de start es la primera posición de tu juego (es decir, no utilizas la posición de preroll), es posible que debas solicitar manualmente que los anuncios se carguen previamente. |
'pause' |
El jugador pausa el juego.
Ejemplo: el jugador pausa el juego y se muestra un anuncio intersticial. El anuncio permanece en la pantalla hasta que el reproductor lo descarta. Cuando regresen, el juego estará pausado. El jugador podrá reanudar el juego y seguir jugando. |
'next' |
El jugador navega al siguiente nivel.
Ejemplo: El jugador acaba de completar un nivel. Si presionan un botón (el siguiente nivel), se muestra un anuncio intersticial. Verán el anuncio, lo descartarán y pasarán al siguiente nivel. |
'browse' |
El jugador explora las opciones fuera del juego.
Ejemplo: El jugador desea alterar el estilo de su personaje. Si presionan el botón “Opciones...”, se muestra un anuncio intersticial. Verán el anuncio, lo descartarán y pasarán al editor de caracteres. |
'reward' |
El jugador llega a un punto del juego en el que se le puede ofrecer una recompensa.
Ejemplo: El jugador acaba de morir y no tiene vidas. Se le ofrece una vida extra en este punto si mira un anuncio. La API de Ad Placement llama a tu código para ofrecer la recompensa al jugador. Luego, presionan el botón de recompensa y miran todo el anuncio de video. Luego, reciben una nueva vida y siguen jugando. |
Nota: Este conjunto de tipos de posiciones es un área de desarrollo activo.
Si el juego incluye posiciones que no encajan naturalmente en ninguna de estas categorías, avísale a tu administrador de Cuentas de Google y con el tiempo usaremos estos comentarios para definirlas mejor.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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."]]
