Hiển thị quảng cáo xen kẽ trong trò chơi H5

Ví dụ này hiển thị quảng cáo xen kẽ trong trò chơi 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 đang chơi trò chơi trên web dựa trên trình kích hoạt thủ công. Để biết thêm thông tin về quảng cáo xen kẽ trong trò chơi, hãy xem phần Hiển thị quảng cáo xen kẽ trong trò chơi H5.

Để hiển thị và tương tác với quảng cáo xen kẽ trong trò chơi, hãy sử dụng các sự kiện GPT sau:

Sự kiện Được kích hoạt khi...
GamingInterstitialSlotReady Quảng cáo xen kẽ trong trò chơi đã sẵn sàng hiển thị cho người dùng.

Để hiển thị quảng cáo xen kẽ, hãy gọi makeGameManualInterstitialVisible() trên đối tượng sự kiện đã cung cấp.
GamingInterstitialSlotClosed Người dùng đã đóng một quảng cáo xen kẽ trong trò chơi đã hiển thị trước đó.

Sử dụng sự kiện này để chạy logic tuỳ chỉnh bất cứ khi nào quảng cáo xen kẽ trong trò chơi bị đóng.

Cấu trúc trò chơi

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ấu trúc của trò chơi. Để biết thêm thông tin chi tiết, hãy xem phần Cấu trúc trò chơi H5.

Cách triển khai mẫu giả định rằng trò chơi H5 hiển thị trực tiếp vào cửa sổ trên cùng, sử dụng cấu trúc Toàn màn hình. Trong trường hợp này, quảng cáo xen kẽ trong trò chơi cũng hiển thị ở chế độ 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, hãy đặt trò chơi trong iFrame, như trong ví dụ sau:

<!doctype html>
<html>
  <head>
    <!-- The Google Publisher Tag here, if any, will only be responsible for serving ads outside of the H5 game. -->
    <title>Page for this example H5 game</title>
    <!-- Your <head> content here. -->
  </head>
  <body>
    <span id="example-text">Example H5 game</span>

    <!-- Sample code is served here. The Google Publisher Tag loaded in this frame will only be used within the H5 game. -->
    <iframe src="https://www.example.com" title="Example game" allow="autoplay"></iframe>
  </body>
</html>

Lưu ý về cách sử dụng

  • Để đả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 quy định hạn chế này, defineOutOfPageSlot() có thể trả về giá trị rỗng. Bạn phải kiểm tra trường hợp này để đảm bảo không thực hiện bất kỳ công việc nào không cần thiết.

  • 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ẽ 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 <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.

  • Quảng cáo xen kẽ trong trò chơi chỉ có thể sử dụng một lần. Bạn không thể làm mới vị trí quảng cáo xen kẽ trong trò chơi. Thay vào đó, bạn phải huỷ và tạo lại khe, như minh hoạ trong phần triển khai mẫu.

  • Quảng cáo xen kẽ trong trò chơi có giới hạn tần suất cố định. Giới hạn tần suất này ngăn sự kiện gamingInterstitialSlotReady kích hoạt nhiều hơn một lần mỗi 120 giâ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ới display() yêu cầu mọi vùng 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> được xác định trước, nhưng vị trí quảng cáo tĩnh thì có. Việc gọi display() 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. Bạn nên trì hoãn lệnh gọi ban đầu cho đến khi xác định được các vùng tĩnh.

Triển khai mẫu

Xem bản minh hoạ