プレースメント タイプ
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
adBreak() の呼び出しでは必ず、プレースメント タイプを指定する必要があります。これは、広告が表示されるときのゲームの状態を説明する文字列です。ゲームが読み込み中か、プレーヤーがゲームプレイを一時停止したか、またはゲーム内で報酬を獲得できるポイントに達したかなど、
正確なタイプを使用することが重要です。これは、表示される広告の種類（インタースティシャル広告かリワード広告か）に直接影響する可能性があるためです。ただし、API の動作に対して、あまり目に見えない他の影響を与える場合もあります。API が適切に機能するように、プレースメント タイプを正しく指定することが重要です。
| プレースメント タイプ |
説明 |
'preroll' |
ゲームの UI が読み込まれておらず、音声が再生されていない。ゲームに設定できる「プレロール」プレースメントは、ページの読み込みごとに 1 つのみです。
例: プレーヤーがゲームカタログ内でゲームをクリックします。ゲーム キャンバスが表示され、ゲームが UI をレンダリングする前、または音声が有効になる前に広告が表示されます。プレーヤーは広告をクリックするか、閉じることができ、この時点でゲームが開始されます。 |
'start' |
ゲームが読み込まれ、UI が表示されて音声が有効になっている。プレーヤーはゲームを操作できるが、ゲームプレイはまだ開始していない。
例: 「読み込み中...」という読み込み画面が短い間表示され、インタースティシャル広告が表示されます。プレーヤーは広告をクリックするか、広告を閉じてゲームを続行できます。
注: preroll は、start プレースメントよりもかなり多くの作業を要します。preroll は、API が初期化されるのを待ってから、広告を自動的にプリロードします。ゲームの読み込み中に UI がレンダリングされる前に表示される最初の広告では、start ではなく preroll を使用することをおすすめします。UI がレンダリングされ、プレーヤーがゲームを操作できるようになった後は、start の方が適しています。
start は、ゲームの再起動時に使用することもでき、ページの読み込みごとに複数の start プレースメントを使用できます。start プレースメントがゲームの最初のプレースメントである場合（つまり、preroll プレースメントを使用しない場合）、広告のプリロードを手動でリクエストする必要が生じる場合があります。 |
'pause' |
プレーヤーがゲームを一時停止した。
例: プレーヤーがゲームを一時停止し、インタースティシャル広告が表示されます。広告は、プレーヤーが閉じるまで画面に表示され続けます。ゲームに戻ると、ゲームは一時停止されたままになっています。プレーヤーはゲームを再開してプレイを続けることができます。 |
'next' |
プレーヤーが次のレベルに移動した。
例: プレーヤーがレベルをクリアし、[次のレベル] ボタンをタップすると、インタースティシャル広告が表示されます。ユーザーは広告を閲覧して閉じ、次のレベルに進みます。 |
'browse' |
プレーヤーがゲームプレイの外でオプションを操作する。
例: プレーヤーがキャラクターのスタイルを変更しようと [オプション] をタップすると、インタースティシャル広告が表示されます。ユーザーは広告を閲覧して閉じ、キャラクター設定メニューに移動します。 |
'reward' |
プレーヤーがゲーム内で報酬を獲得できるポイントに到達した。
例: プレーヤーがゲーム内で死んで、ライフもなくなりました。ここで広告を見ると、プレーヤーはボーナスのライフがもらえます。Ad Placement API は、プレーヤーに報酬を提供するためにコードを呼び出します。ユーザーが特典ボタンをタップして、動画広告を最後まで視聴すると、新しいライフを受け取り、ゲームを続行できます。 |
注: このプレースメント タイプのセットについては、現在も開発が行われています。
このどのカテゴリにもうまく当てはまらないプレースメントがゲームにある場合は、Google アカウント マネージャーにお知らせください。Google では、お寄せいただいたフィードバックをもとにカテゴリを追加していきます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 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."]]