Types d'emplacement
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Tous les appels à adBreak() doivent spécifier un type d'emplacement. Il s'agit d'une chaîne qui décrit l'état de votre jeu lorsque l'annonce sera diffusée. Votre jeu se charge-t-il ? Le joueur a-t-il mis le jeu en pause ? Ou ont-ils atteint un niveau
dans votre jeu où ils pourraient recevoir une récompense ?
Le type précis que vous utilisez est important. Étant donné que cela peut avoir un impact direct sur le type d'expérience publicitaire qui sera diffusé (annonces interstitielles et avec récompense). Cependant, il peut également avoir d'autres effets moins visibles sur le comportement de l'API. Il est important de spécifier le type d'emplacement correctement afin que l'API fonctionne de manière optimale.
| Type d'emplacement |
Description |
'preroll' |
Votre jeu n'a pas chargé son interface utilisateur et n'émet aucun son. Il ne peut y avoir qu'un seul emplacement "pré-roll" dans votre jeu par chargement de page.
Exemple:Un joueur clique sur votre jeu dans un catalogue de jeux. La toile du jeu s'affiche. Elle est affichée avant l'affichage de l'interface utilisateur ou l'activation du son. Le joueur peut cliquer sur l'annonce ou l'ignorer à quel moment le jeu commence. |
'start' |
Votre jeu est chargé, l'interface utilisateur est visible et le son est activé, le joueur peut interagir avec le jeu, mais la partie n'a pas encore commencé.
Exemple:Vous affichez un bref écran de chargement en cours de chargement, et une annonce interstitielle s'affiche. Le joueur peut cliquer sur l'annonce ou l'ignorer pour continuer à jouer.
REMARQUE : preroll vous aide beaucoup plus qu'un emplacement start. preroll attend que l'API s'initialise et précharge automatiquement les annonces. Vous devez utiliser preroll au lieu de start pour la toute première annonce diffusée pendant le chargement du jeu, avant l'affichage de l'interface utilisateur. start est un meilleur emplacement une fois que l'interface utilisateur est affichée et que le lecteur peut interagir avec le jeu.
start peut également être utilisé au redémarrage du jeu. Plusieurs emplacements start peuvent être chargés par page. Si l'emplacement start est le tout premier dans votre jeu (c'est-à-dire que vous n'utilisez pas l'emplacement preroll), vous devrez peut-être demander manuellement que les annonces soient préchargées. |
'pause' |
Le joueur met la partie en pause.
Exemple : il interrompt la partie, et une annonce interstitielle est diffusée. L'annonce reste à l'écran jusqu'à ce que le lecteur la ferme. À leur retour, le jeu est toujours en pause. Le joueur peut alors reprendre la partie et continuer à jouer. |
'next' |
Le joueur passe au niveau suivant.
Exemple : Le joueur vient de terminer un niveau. Il appuie sur un bouton "Niveau suivant...", et une annonce interstitielle s'affiche. Il voit l'annonce, l'ignore et passe au niveau suivant. |
'browse' |
Le joueur explore des options en dehors du jeu.
Exemple : Le joueur souhaite modifier le style de son personnage. Il appuie sur le bouton "Options" pour afficher une annonce interstitielle. Il voit l'annonce, l'ignore et accède à l'éditeur de caractères. |
'reward' |
Le joueur atteint un point où il peut recevoir une récompense.
Exemple : Le joueur vient de mourir, car sa vie est épuisée. Ils bénéficient d'une durée de vie supplémentaire s'ils regardent une annonce. L'API Ad Placement appelle votre code pour offrir la récompense au joueur. Ils appuient sur le bouton de récompense et regardent toutes les annonces vidéo. Ils rejouent et prennent une nouvelle vie. |
Remarque: Cet ensemble de types d'emplacements est un domaine de développement actif.
Si certains de vos emplacements ne correspondent pas naturellement à l'une de ces catégories, informez-en votre responsable de compte Google. Nous utiliserons ces commentaires au fil du temps afin d'affiner ces catégories.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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."]]
