Bài viết này cung cấp các ghi chú và ví dụ minh hoạ cách hiển thị quảng cáo xen kẽ trong trò chơi H5 bằng cách sử dụng thư viện Thẻ nhà xuất bản của Google (GPT).
Quảng cáo xen kẽ trong trò chơi là quảng cáo toàn trang, do GPT quản lý và hiển thị cho người dùng thông qua trình kích hoạt thủ công trên các trò chơi chạy trên trang web.
Nội dung trong bài viết này
- Yêu cầu và đề xuất
- Bắt đầu sử dụng tính năng gắn thẻ
- Quản lý quảng cáo
- Loạt video về quản lý quảng cáo: Quảng cáo xen kẽ trong trò chơi H5 | Quảng cáo có tặng thưởng cho trò chơi H5
- Báo cáo
Yêu cầu và đề xuất
- Nhà xuất bản không được phép sử dụng quảng cáo xen kẽ trong trò chơi H5 trên khoảng không quảng cáo không dành cho trò chơi. Bằng việc áp dụng định dạng này, nhà xuất bản tự động đồng ý với điều kiện này. Bạn cũng phải tuân thủ Nguyên tắc dành cho đối tác Google Ad Manager và Các chính sách dành cho nhà xuất bản của Google.
- Google giữ quyền phê duyệt hoặc từ chối nhà xuất bản tại bất kỳ thời điểm nào. Sau đó, những nhà xuất bản bị phát hiện vi phạm sẽ bị xoá khỏi danh sách cho phép.
- Quảng cáo xen kẽ trong trò chơi tạo ra vị trí quảng cáo riêng. Không giống như các loại quảng cáo khác, bạn không cần phải xác định phần tử <div> cho quảng cáo xen kẽ trong trò chơi. Những quảng cáo này sẽ tự động tạo và chèn vùng chứa riêng vào trang khi quảng cáo được lấp đầy.
- Nếu sử dụng cấu trúc yêu cầu duy nhất (SRA) trên một trang có nhiều vị trí, đừng gọi
display()cho đến khi div vị trí quảng cáo tĩnh được tạo. Như đã giải thích trong Các phương pháp hay nhất về quảng cáo, lệnh gọi đầu tiên tớidisplay()yêu cầu mọi vị trí quảng cáo được xác định trước điểm đó. Mặc dù vị trí quảng cáo xen kẽ trong trò chơi không yêu cầu <div> xác định trước, nhưng vị trí quảng cáo tĩnh thì có. Việc gọidisplay()trước khi các phần tử này xuất hiện trên trang có thể làm các tín hiệu có chất lượng thấp hơn. Vì vậy, bạn nên trì hoãn lệnh gọi ban đầu cho đến khi xác định được các vị trí tĩnh. - Việc quản lý quảng cáo xen kẽ thủ công yêu cầu thiết lập đơn vị quảng cáo và mục hàng giống như với quảng cáo xen kẽ trên webchuẩn.
Bắt đầu sử dụng tính năng gắn thẻ
- Tạo một vị trí GPT bằng cách sử dụng
googletag.defineOutOfPageSlot()và đặt Định dạng OutOfPage thànhgoogletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL.
Vui lòng xem hướng dẫn về quảng cáo xen kẽ trong trò chơi H5 dành cho nhà phát triển kỹ thuật GPT. - Sau khi xác định vị trí, hãy thêm trình nghe sự kiện để theo dõi sự kiện
gameManualInterstitialSlotReady. Trong lệnh gọi lại trình nghe sự kiện, hãy gọi phương thứcmakeGameManualInterstitialVisible()trên đối tượng sự kiện đã cung cấp để hiển thị quảng cáo. - Sau khi bạn khai báo tất cả các vị trí quảng cáo tĩnh khác, lệnh gọi đến
googletag.displaysẽ kích hoạt yêu cầu lấp đầy vị trí quảng cáo xen kẽ trong trò chơi.
Ví dụ
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Ví dụ về quảng cáo xen kẽ thủ công trong trò chơi</title>
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script>
window.googletag = window.googletag || { cmd: [] };
let gameManualInterstitialSlot;
googletag.cmd.push(function () {
// Xác định vị trí quảng cáo xen kẽ thủ công trong trò chơi.
defineGameManualInterstitialSlot();
// Xác định vị trí quảng cáo tĩnh.
staticSlot = googletag.defineSlot(
'/6355419/Travel/Europe', [100, 100], 'static-ad-1')
.addService(googletag.pubads());
// Bật SRA và dịch vụ.
googletag.pubads().enableSingleRequest();
googletag.enableServices();
});
function defineGameManualInterstitialSlot() {
gameManualInterstitialSlot = googletag.defineOutOfPageSlot(
'/6355419/Travel/Europe/France/Paris',
googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL);
// Vị trí trả về giá trị rỗng nếu trang hoặc thiết bị không hỗ trợ quảng cáo xen kẽ.
if (gameManualInterstitialSlot) {
gameManualInterstitialSlot.addService(googletag.pubads());
printStatus('Đang chờ quảng cáo xen kẽ sẵn sàng...');
// Thêm trình nghe sự kiện để đăng ký trình xử lý lượt nhấp khi quảng cáo xen kẽ tải.
// Nếu sự kiện này không kích hoạt, hãy thử xoá bộ nhớ cục bộ và làm mới
// trang.
googletag.pubads().addEventListener('gameManualInterstitialSlotReady',
(slotReadyEvent) => {
if (gameManualInterstitialSlot === slotReadyEvent.slot) {
printStatus('Quảng cáo xen kẽ sẵn sàng.');
const button = document.getElementById('trigger');
button.style.display = 'block';
button.addEventListener('click', () => {
slotReadyEvent.makeGameManualInterstitialVisible();
printStatus('Quảng cáo xen kẽ đang hoạt động.');
}, { once: true });
}
});
googletag.pubads().addEventListener('gameManualInterstitialSlotClosed',
resumeGame);
}
}
function resumeGame() {
document.getElementById('trigger').style.display = 'none';
// Các vị trí quảng cáo xen kẽ thủ công trong trò chơi chỉ có thể sử dụng một lần, vì vậy hãy huỷ bỏ vị trí cũ và tạo một vị trí mới.
googletag.destroySlots([gameManualInterstitialSlot]);
defineGameManualInterstitialSlot();
googletag.display(gameManualInterstitialSlot);
}
function printStatus(status) {
document.getElementById('status').innerText = status;
}
</script>
<style>
nút {
display: none;
}
div.content {
position: fixed;
top: 50%;
}
</style>
</head>
<body>
<div id="static-ad-1" style="width: 100px; height: 100px;"></div>
<div class="content">
<span id="status">Quảng cáo xen kẽ thủ công trong trò chơi không được hỗ trợ trên trang này.</span>
<p>
<button id="trigger">KÍCH HOẠT QUẢNG CÁO XEN KẼ</button>
</p>
</div>
<script>
googletag.cmd.push(function () {
// Đảm bảo lệnh gọi hiển thị đầu tiên xuất hiện sau vị trí quảng cáo tĩnh
// div được xác định.
googletag.display(staticSlot);
});
</script>
</body>
</html>
Sự kiện GPT
Sau đây là các sự kiện GPT được dùng để hiển thị và tương tác với quảng cáo xen kẽ trong trò chơi:
| Sự kiện | Được kích hoạt khi... |
|---|---|
|
|
Vị trí quảng cáo xen kẽ trong trò chơi đã sẵn sàng để hiển thị. Để hiển thị quảng cáo xen kẽ, hãy gọi |
|
|
Vị trí quảng cáo xen kẽ trong trò chơi đang hiển thị hiện đã đóng. Dùng để thực thi logic tuỳ chỉnh bất cứ khi nào quảng cáo xen kẽ trong trò chơi bị đóng. |
Quảng cáo xen kẽ trong trò chơi có thể hiển thị ở chế độ toàn màn hình hoặc bên trong khung hình của trò chơi, tuỳ thuộc vào cách trò chơi hiển thị. Tìm hiểu thêm về cấu trúc Quảng cáo trong trò chơi H5.
Mã mẫu sau đây giả định rằng trò chơi H5 được đặt trực tiếp trên cùng một khung trên cùng như trang (sử dụng cấu trúc "Toàn màn hình"). Nếu trường hợp đó xảy ra, quảng cáo xen kẽ trong trò chơi cũng sẽ hiển thị toàn màn hình.
Tuy nhiên, mã này cũng hoạt động khi được đặt bên trong khung con (sử dụng cấu trúc "iFrame/WebView"). Để giới hạn quảng cáo xen kẽ trong trò chơi với canvas trò chơi H5, bạn cần đặt trò chơi trong iFrame.
Ví dụ
<!doctype html>
<html>
<head>
<!-- Thẻ nhà xuất bản của Google ở đây (nếu có) sẽ chỉ chịu trách nhiệm phân phát quảng cáo bên ngoài trò chơi H5. -->
<title>Trang cho trò chơi H5 ví dụ này</title>
<!-- Nội dung <head> của bạn ở đây. -->
</head>
<body>
<span id="example-text">Trò chơi H5 ví dụ</span>
<iframe src="https://www.example-game.com" title="Trò chơi ví dụ" allow="autoplay">
<!-- Mã mẫu được phân phát tại đây. Thẻ nhà xuất bản của Google được tải trong khung này sẽ chỉ được dùng trong trò chơi H5. -->
</iframe>
</body>
</html>
Ghi chú về việc sử dụng GPT
- Để đảm bảo trải nghiệm người dùng tối ưu, GPT chỉ yêu cầu quảng cáo xen kẽ trong trò chơi trên những trang hỗ trợ định dạng chính xác. Do đó,
defineOutOfPageSlot()có thể trả về giá trị rỗng. Chỉ yêu cầu quảng cáo xen kẽ trong trò chơi trên những trang hoặc môi trường mà bạn muốn quảng cáo xen kẽ xuất hiện. Quảng cáo xen kẽ trong trò chơi đủ điều kiện để phân phát đến máy tính, máy tính bảng và thiết bị di động. - Quảng cáo xen kẽ xuất hiện khi bạn gọi
makeGameManualInterstitialVisibletừgameManualInterstitialSlotReady event. - Quảng cáo xen kẽ trong trò chơi có giới hạn tần suất cố định. Điều này ngăn sự kiện
gameManualInterstitialSlotReadykích hoạt nhiều hơn một lần mỗi 30 giây.
Quản lý quảng cáo
- Tạo một đơn vị quảng cáo mới hoặc sử dụng lại một đơn vị quảng cáo hiện có. Chọn 320x480, 300x250 và 336x280 làm kích thước đơn vị quảng cáo.
- Tạo mục hàng Chọn chế độ cài đặt mục hàng phù hợp dựa trên trường hợp sử dụng của bạn:
| Chế độ cài đặt mục hàng | ||||
|---|---|---|---|---|
| Trường hợp sử dụng | Loại quảng cáo | Loại mục hàng | Mẫu quảng cáo dự kiến | Nhắm mục tiêu > Khoảng không quảng cáo |
| Cách phân phát quảng cáo hiển thị đặt trước | Hiển thị |
|
320x480, 300x250 hoặc 336x280 |
Đơn vị quảng cáo đã tạo hoặc đã chọn ở bước trước |
| Cách phân phát quảng cáo không được đặt trước | Hiển thị |
|
||
| Cách phân phát quảng cáo video đặt trước (ví dụ: thẻ VAST hoặc tệp MP4) | Video hoặc âm thanh |
|
300x250v hoặc 320x480v | |
| Cách phân phát quảng cáo thay thế/phiên đấu giá mở | Hiển thị | Ad Exchange | Mọi kích thước theo yêu cầu | |
Loạt video về quản lý quảng cáo: Bắt đầu sử dụng quảng cáo xen kẽ trong trò chơi H5
Xem các video trong loạt video gồm 2 phần này để giúp bạn nhanh chóng làm quen với quảng cáo xen kẽ trong trò chơi H5
| Phần 1: Quảng cáo xen kẽ trong trò chơi H5 trên Ad Manager |
| H5 Gaming Interstitial Ads on Ad Manager |
| Phần 2: Quảng cáo có tặng thưởng cho trò chơi H5 trên Ad Manager |
| Rewarded Ads for H5 Gaming on Ad Manager |