Placement-Typen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Bei allen Aufrufen von adBreak() muss ein Placement-Typ angegeben werden. Das ist ein String, der den Status Ihres Spiels beschreibt, wenn die Anzeige ausgeliefert wird. Wird dein Spiel gerade geladen? Hat der Spieler das Spiel pausiert? Oder haben sie einen Punkt in deinem Spiel erreicht,
an dem sie eine Prämie erhalten können?
Dabei kommt es darauf an, welchen Typ Sie genau verwenden. Sie kann sich direkt darauf auswirken, welche Art von Anzeige präsentiert wird (Interstitial-Anzeige und Anzeige mit Prämie). Es kann jedoch auch andere weniger sichtbare Auswirkungen auf das Verhalten der API haben. Es ist wichtig, dass Sie den Placement-Typ korrekt angeben, damit die API optimal funktioniert.
| Placement-Typ |
Beschreibung |
'preroll' |
Die Benutzeroberfläche des Spiels wurde nicht geladen und es wird kein Ton abgespielt. Pro Seitenaufbau kann es nur ein „Pre-Roll“-Placement in deinem Spiel geben.
Beispiel: Ein Spieler klickt in einem Spielkatalog auf dein Spiel. Der Spiele-Canvas wird angezeigt. Bevor in Ihrem Spiel die UI gerendert oder der Ton aktiviert wird, wird eine Anzeige eingeblendet. Der Spieler kann auf die Anzeige klicken oder sie schließen, wenn das Spiel beginnt. |
'start' |
Ihr Spiel wurde geladen, die Benutzeroberfläche ist sichtbar und der Ton ist aktiviert. Der Spieler kann mit dem Spiel interagieren, aber das Spiel hat noch nicht begonnen.
Beispiel:Sie zeigen einen kurzen Ladebildschirm an und eine Interstitial-Anzeige wird eingeblendet. Der Spieler kann auf die Anzeige klicken oder sie schließen, um mit dem Spiel fortzufahren.
HINWEIS:preroll ist viel aufwendiger als start-Placements. preroll wartet auf die Initialisierung der API und lädt Anzeigen automatisch vorab. Verwende preroll statt start, damit die erste Anzeige zu sehen ist, während das Spiel geladen wird, bevor die UI gerendert wird. start ist ein besseres Placement, wenn die Benutzeroberfläche gerendert wird und der Spieler mit dem Spiel interagieren kann.
start kann auch beim Neustart des Spiels verwendet werden. Pro Seitenaufbau sind dann mehrere start-Placements möglich. Wenn ein start-Placement das erste Placement in Ihrem Spiel ist, Sie also das preroll-Placement nicht verwenden, müssen Sie möglicherweise manuell das Vorabladen von Anzeigen anfordern. |
'pause' |
Der Spieler pausiert das Spiel.
Beispiel: Der Spieler pausiert das Spiel und eine Interstitial-Anzeige wird ausgeliefert. Die Anzeige bleibt auf dem Bildschirm, bis sie vom Player geschlossen wird. Wenn sie zurückkehren, ist das Spiel immer noch pausiert. Der Spieler kann das Spiel dann fortsetzen und weiterspielen. |
'next' |
Der Spieler springt zur nächsten Stufe.
Beispiel:Der Spieler hat gerade ein Level abgeschlossen. Er tippt auf eine Schaltfläche „Nächstes Level...“. Eine Interstitial-Anzeige wird eingeblendet. Sie sehen die Anzeige, schließen sie und fahren mit dem nächsten Level fort. |
'browse' |
Der Spieler erkundet die Optionen außerhalb des Spiels.
Beispiel:Der Spieler möchte den Stil seiner Figur ändern. Er tippt auf die Schaltfläche „Optionen...“. Daraufhin wird eine Interstitial-Anzeige eingeblendet. Sie sehen die Anzeige, schließen sie und fahren mit dem Zeicheneditor fort. |
'reward' |
Der Spieler erreicht einen Punkt im Spiel, an dem eine Prämie angeboten werden kann.
Beispiel: Der Spieler ist gestorben und hat kein Leben mehr. Wenn sie sich eine Anzeige ansehen, erhalten sie ein zusätzliches Bonusangebot. Die Ad Placement API ruft Ihren Code auf, um dem Spieler die Prämie anzubieten. Sie tippen auf die Schaltfläche „Prämie“ und sehen sich eine Videoanzeige vollständig an. Sie bekommen dann ein neues Leben und spielen weiter. |
Hinweis: Diese Gruppe von Placement-Typen ist ein Bereich aktiver Entwicklung.
Wenn es in Ihrem Spiel Placements gibt, die nicht in eine dieser Kategorien passen, informieren Sie Ihren Google Account Manager. Wir nutzen dieses Feedback im Laufe der Zeit, um diese Kategorien zu verfeinern.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
