Jenis penempatan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Semua panggilan ke adBreak() harus menentukan jenis penempatan. Ini adalah string yang
menjelaskan status game Anda saat iklan akan ditampilkan. Apakah game Anda baru
dimuat? Apakah pemain telah menjeda gameplay? Atau apakah mereka telah mencapai titik tertentu dalam game Anda yang dapat membuat mereka menerima reward?
Jenis persis yang Anda gunakan sangatlah penting. Karena hal ini dapat secara langsung memengaruhi jenis
pengalaman iklan yang akan ditampilkan (interstisial dibandingkan iklan reward). Namun, tindakan ini juga dapat memiliki efek lain yang kurang terlihat pada perilaku API. Anda
harus menentukan jenis penempatan dengan benar agar API dapat berfungsi
secara optimal.
| Jenis penempatan |
Deskripsi |
'preroll' |
Game Anda belum memuat UI dan tidak memutar suara. Hanya boleh ada satu penempatan ‘preroll’ dalam game untuk setiap pemuatan halaman.
Contoh: pemain mengklik game Anda dalam katalog game. Kanvas game akan ditampilkan dan sebelum game Anda merender UI-nya atau mengaktifkan suara, iklan akan ditampilkan. Pemain dapat mengklik iklan atau menutupnya pada saat game akan dimulai. |
'start' |
Game Anda telah dimuat, UI terlihat, dan suara diaktifkan, pemain dapat berinteraksi dengan game, tetapi permainan belum dimulai.
Contoh: Anda menampilkan layar pemuatan singkat "Memuat..." dan iklan interstisial ditampilkan. Pemain dapat mengklik iklan atau menutupnya untuk melanjutkan ke game.
CATATAN: preroll melakukan sedikit lebih banyak pekerjaan bagi Anda daripada penempatan start. preroll menunggu API menginisialisasi dan melakukan pramuat iklan secara otomatis. Anda harus menggunakan preroll, bukan start, untuk iklan pertama yang ditampilkan saat game dimuat, sebelum UI dirender. start adalah penempatan yang lebih baik setelah UI Anda dirender dan pemain dapat berinteraksi dengan game tersebut.
start juga dapat digunakan saat game dimulai ulang—dapat terdapat beberapa penempatan start per pemuatan halaman. Jika penempatan start adalah penempatan pertama dalam game Anda (yaitu Anda tidak menggunakan penempatan preroll), Anda mungkin perlu meminta secara manual bahwa iklan telah dimuat sebelumnya. |
'pause' |
Pemain menjeda game.
Contoh: pemain menjeda game dan iklan interstisial ditampilkan. Iklan tetap ditampilkan di layar hingga pemutar menutupnya. Saat perangkat dikembalikan, game masih dijeda. Lalu, pemain dapat melanjutkan game dan terus bermain. |
'next' |
Pemain menavigasi ke level berikutnya.
Contoh: Pemain baru saja menyelesaikan level. Mereka mengetuk tombol "Tingkat berikutnya..." iklan interstisial ditampilkan. Mereka melihat iklan tersebut, menutupnya, dan melanjutkan ke langkah berikutnya. |
'browse' |
Pemain menjelajahi opsi di luar gameplay.
Contoh: Pemain ingin mengubah gaya karakternya. Mereka mengetuk tombol "Opsi..." iklan interstisial ditampilkan. Mereka melihat iklan tersebut, menutupnya, dan melanjutkan ke editor karakter. |
'reward' |
Pemain akan mencapai satu titik dalam game tempat mereka dapat menerima reward.
Contoh: Pemain baru saja meninggal dan kehabisan nyawa. Mereka ditawari masa pakai bonus pada tahap ini jika mereka menonton iklan. Ad Placement API memanggil kode Anda untuk menawarkan reward kepada pemain. Mereka mengetuk tombol reward dan menonton semua iklan video. Mereka kemudian menerima kehidupan baru dan terus bermain. |
Catatan: kumpulan jenis penempatan ini adalah
area pengembangan aktif.
Jika ada penempatan dalam game yang tidak cocok dengan salah satu kategori ini, beri tahu Account Manager Google Anda, dan kami akan menggunakan masukan ini dari waktu ke waktu untuk memperbaiki kategori ini.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
