게재위치 유형
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
모든 adBreak() 호출은 게재위치 유형을 지정해야 합니다. 광고가 게재될 때
게임의 상태를 나타내는 문자열입니다. 게임이
로드 중인가요? 플레이어가 게임 플레이를 일시중지했나요? 아니면 게임에서
보상을 제공받을 수 있는 지점에 도달했나요?
정확한 유형을 사용하는 것이 중요합니다. 전면 광고인지 보상형 광고인지에 따라
게재되는 광고 경험의 종류에 직접적인 영향을 줄 수 있습니다. 뿐만 아니라
API의 동작에 다른 눈에 띄는 영향을 줄 수도 있습니다. API가
최적으로 작동할 수 있도록
게재위치 유형을 올바르게 지정하는 것이 중요합니다.
| 게재위치 유형 |
설명 |
'preroll' |
게임이 UI를 로드하지 않았으며 소리가 재생되고 있지 않습니다. 각 페이지 로드마다 게임에 '프리롤' 게재위치 하나만 있을 수 있습니다.
예: 플레이어가 게임 카탈로그 내에서 게임을 클릭합니다. 게임 캔버스가 표시되며, 게임이 UI를 렌더링하거나 소리를 켜기 전에 광고가 표시됩니다. 플레이어는 게임이 시작될 때 광고를 클릭하거나 닫을 수 있습니다. |
'start' |
게임이 로드되고, UI가 표시되고, 사운드가 켜지고, 플레이어가 게임과 상호작용할 수 있지만, 게임플레이가 아직 시작되지 않았습니다.
예: 간단한 로드 화면인 '로드 중...'이 표시되고 전면 광고가 표시됩니다. 플레이어는 광고를 클릭하거나 광고를 닫아 게임을 계속 진행할 수 있습니다.
참고:preroll은 start 게재위치보다 상당히 많은 작업을 할 수 있습니다. preroll는 API가 초기화될 때까지 기다린 후 광고를 자동으로 미리 로드합니다. UI가 렌더링되기 전에 게임이 로드되는 동안 표시되는 첫 번째 광고에는 start 대신 preroll을 사용해야 합니다. UI가 렌더링되고 플레이어가 게임과 상호작용할 수 있게 되면 start가 더 나은 게재위치입니다.
게임을 다시 시작할 때도 start를 사용할 수 있습니다. 페이지 로드에 따라 여러 start 게재위치가 있을 수 있습니다. 게임에서 start 게재위치가 가장 첫 번째 게재위치인 경우(즉 preroll 게재위치를 사용하지 않는 경우) 광고가 미리 로드되도록 수동으로 요청해야 할 수 있습니다. |
'pause' |
플레이어가 게임을 일시중지합니다.
예: 플레이어가 게임을 일시중지하면 전면 광고가 게재됩니다. 플레이어가 광고를 닫을 때까지 광고가 화면에 남아 있습니다. 돌아오면 게임이 계속 일시중지됩니다. 그러면 플레이어가 게임을 다시 시작하고 계속 플레이할 수 있습니다. |
'next' |
플레이어가 다음 레벨로 이동합니다.
예: 플레이어가 방금 레벨을 완료했습니다. '다음 레벨' 버튼을 탭하면 전면 광고가 표시됩니다. 플레이어는 광고를 보고 닫은 후 다음 레벨로 진행합니다. |
'browse' |
플레이어가 게임플레이 외부의 옵션을 탐색합니다.
예: 플레이어가 캐릭터의 스타일을 변경하려고 합니다. '옵션...' 버튼을 탭하면 전면 광고가 표시됩니다. 광고를 보고 닫은 후 캐릭터 에디터로 진행합니다. |
'reward' |
플레이어가 게임 내에서 보상을 받을 수 있는 지점에 도달합니다.
예: 플레이어가 방금 사망하여 사용할 수 있는 생명이 없습니다. 광고를 시청하는 사용자에게는 보너스가 지급됩니다. Ad Placement API는 플레이어에게 보상을 제공하는 코드를 호출합니다. 리워드 버튼을 탭하고 동영상 광고를 모두 시청합니다. 그런 다음 새로운 생명을 받아 게임을 계속합니다. |
참고: 게재위치 유형은
아직 개발 단계에 있습니다.
내 게임에 위 카테고리에 해당하지 않는 게재위치가 있으면
Google 계정 관리자에게 알려 주세요. 이를 통해 수집한 의견을 참고하여
필요할 때마다 카테고리를 조정합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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."]]