Loại vị trí
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tất cả lệnh gọi đến adBreak() phải chỉ định một loại vị trí. Đây là một chuỗi mô tả trạng thái của trò chơi khi quảng cáo hiển thị. Trò chơi của bạn có đang chỉ tải không? Người chơi có tạm dừng chơi trò chơi không? Hay họ đã đạt đến điểm trong trò chơi của bạn, nơi họ có thể được tặng phần thưởng chưa?
Loại chính xác mà bạn sử dụng rất quan trọng. vì loại quảng cáo này có thể ảnh hưởng trực tiếp đến loại trải nghiệm quảng cáo sẽ hiển thị (quảng cáo xen kẽ so với quảng cáo có tặng thưởng). Tuy nhiên, điều này cũng có thể có những tác động ít thấy hơn đến hành vi của API. Điều quan trọng là bạn phải chỉ định đúng loại vị trí để API có thể hoạt động tối ưu.
| Loại vị trí |
Mô tả |
'preroll' |
Trò chơi của bạn chưa tải giao diện người dùng và không phát âm thanh. Mỗi trò chơi chỉ được có một vị trí "trước video" cho mỗi lượt tải trang.
Ví dụ: người chơi nhấp vào trò chơi của bạn trong danh mục trò chơi. Canvas trò chơi xuất hiện và trước khi trò chơi của bạn hiển thị giao diện người dùng hoặc bật âm thanh mà quảng cáo hiển thị. Người chơi có thể nhấp vào quảng cáo đó hoặc đóng quảng cáo tại thời điểm trò chơi bắt đầu. |
'start' |
Trò chơi đã tải, giao diện người dùng đang hiển thị và âm thanh đã được bật, người chơi có thể tương tác với trò chơi nhưng trò chơi chưa bắt đầu.
Ví dụ: Bạn sẽ thấy một màn hình tải ngắn gọn "Loading..." và một quảng cáo xen kẽ xuất hiện. Người chơi có thể nhấp vào quảng cáo hoặc đóng quảng cáo đó để tiếp tục chơi trò chơi.
LƯU Ý: preroll phù hợp với bạn hơn nhiều so với vị trí start. preroll đợi API khởi chạy và tự động tải trước quảng cáo. Bạn nên sử dụng preroll thay vì start cho quảng cáo đầu tiên xuất hiện khi trò chơi đang tải, trước khi giao diện người dùng hiển thị. start là vị trí tốt hơn sau khi giao diện người dùng được hiển thị và người chơi có thể tương tác với trò chơi.
start cũng có thể được sử dụng khi trò chơi khởi động lại—có thể có nhiều vị trí start trên mỗi lượt tải trang. Nếu vị trí start là vị trí đầu tiên trong trò chơi của bạn (nghĩa là bạn không sử dụng vị trí preroll), bạn có thể cần phải yêu cầu tải trước quảng cáo theo cách thủ công. |
'pause' |
Người chơi tạm dừng trò chơi.
Ví dụ: người chơi tạm dừng trò chơi và một quảng cáo xen kẽ xuất hiện. Quảng cáo này vẫn còn trên màn hình cho đến khi người chơi đóng quảng cáo đó. Khi họ quay lại, trò chơi vẫn bị tạm dừng. Sau đó, người chơi có thể tiếp tục trò chơi và tiếp tục chơi. |
'next' |
Người chơi chuyển đến cấp tiếp theo.
Ví dụ: Người chơi vừa hoàn thành một cấp độ. Họ nhấn vào nút "Cấp tiếp theo..." quảng cáo xen kẽ được hiển thị. Họ xem quảng cáo, đóng quảng cáo và chuyển sang cấp tiếp theo. |
'browse' |
Người chơi khám phá các lựa chọn bên ngoài lối chơi.
Ví dụ: Người chơi muốn thay đổi phong cách của nhân vật của họ. Họ nhấn vào nút "Tuỳ chọn..." một quảng cáo xen kẽ được hiển thị. Họ xem quảng cáo, đóng quảng cáo và chuyển đến trình chỉnh sửa ký tự. |
'reward' |
Người chơi đạt đến một điểm trong trò chơi để có thể nhận phần thưởng.
Ví dụ: Người chơi vừa chết vừa hết lượt. Tại thời điểm này, họ được thưởng thêm mạng nếu xem quảng cáo. API Vị trí đặt quảng cáo gọi mã của bạn để cung cấp phần thưởng cho người chơi. Họ nhấn vào nút phần thưởng và xem tất cả quảng cáo dạng video. Sau đó, họ nhận được một lượt chơi mới và tiếp tục chơi. |
Lưu ý: nhóm các loại vị trí này là khu vực phát triển đang hoạt động.
Nếu bạn có các vị trí trong trò chơi vốn không phù hợp với một trong các danh mục này, hãy cho Người quản lý tài khoản của Google biết và chúng tôi sẽ sử dụng phản hồi này theo thời gian để tinh chỉnh các danh mục này.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
