Quản lý quảng cáo

Bạn có thể tạo doanh thu từ việc đặt đơn vị quảng cáo trong trò chơi của mình. Để làm việc này:

1. Tìm hiểu về các mẹo và đề xuất cho vị trí hiển thị quảng cáo.
2. Thiết lập lệnh gọi quảng cáo thông qua SDK.
3. Bật chế độ kiếm tiền trong Bảng điều khiển Yandex Games.

Mẹo và đề xuất cho vị trí hiển thị quảng cáo

• Lệnh gọi quảng cáo nên được hiển thị theo cách mà người dùng nhận thức rõ ràng chúng là quảng cáo, không phải là một phần tử thực của trò chơi.
• Thời gian đề xuất cho lệnh gọi quảng cáo trong trò chơi: trước khi trò chơi bắt đầu, trong quá trình chuyển cấp và sau khi thua.
• Bạn có thể gọi quảng cáo video có thưởng ở mức độ thường xuyên như bạn muốn.
• Tần suất gọi một đơn vị quảng cáo xen kẽ sẽ thuộc sự kiểm soát của Yandex Games.

Đặt cấu hình lệnh gọi quảng cáo

Quảng cáo xen kẽ

Đơn vị quảng cáo xen kẽ sẽ che phủ hoàn toàn nền ứng dụng và được hiển thị sau một số yêu cầu dữ liệu nhất định từ người dùng (ví dụ: khi chuyển sang cấp độ trò chơi tiếp theo) nhưng trước khi dữ liệu này được trả về.

Để gọi quảng cáo, hãy sử dụng phương thức ysdk.adv.show_fullscreen_adv().

ysdk.adv.show_fullscreen_adv(callbacks: table)

callbacks: table — các hàm lệnh gọi trở lại tùy chọn. Những hàm này được đặt cấu hình riêng cho từng đơn vị quảng cáo.

• on_close — được gọi khi quảng cáo đóng lại, sau khi có lỗi hoặc sau khi quảng cáo không mở được do lệnh gọi quá thường xuyên. Hàm này được sử dụng với đối số wasShown (loại dữ liệu boolean), là giá trị cho biết quảng cáo có được hiển thị hay không.

• on_open — được gọi khi quảng cáo được mở thành công.

• on_error — được gọi khi xảy ra lỗi. Đối tượng lỗi được truyền vào hàm lệnh gọi trở lại.

• on_offline — được gọi khi mất kết nối mạng (chuyển sang chế độ ngoại tuyến).

Ví dụ

ysdk.adv.show_fullscreen_adv({
  on_close = function (self, was_shown)
    -- Hành động khi đóng quảng cáo.
  end,
  on_error = function (self, error)
    -- Hành động khi có lỗi.
  end
})

Video có thưởng

Video có thưởng là đơn vị quảng cáo để kiếm tiền trong trò chơi mà người dùng có thể xem để đổi lấy một số phần thưởng hoặc tiền trong trò chơi.

Để gọi quảng cáo, hãy sử dụng phương thức ysdk.adv.show_rewarded_video().

ysdk.adv.show_rewarded_video(callbacks: table)

callbacks: table — các hàm lệnh gọi trở lại tùy chọn. Những hàm này được đặt cấu hình riêng cho từng đơn vị quảng cáo.

• on_close — được gọi khi quảng cáo video đóng lại.

• on_open — được gọi khi quảng cáo video được hiển thị trên màn hình.

• on_error — được gọi khi xảy ra lỗi. Đối tượng lỗi được truyền vào hàm lệnh gọi trở lại.

• on_rewarded — được gọi khi lượt hiển thị quảng cáo video được tính. Chức năng này phải chỉ định phần thưởng cho việc xem quảng cáo.

Ví dụ

ysdk.adv.show_rewarded_video({
  on_open = function (self)
    print("Video ad open")
  end,
  on_close = function (self)
    print("Rewarded!")
  end,
  on_rewarded = function (self)
    print("Video ad closed.")
  end,
  on_error = function (self, error)
    print("Error while open video ad: " .. error)
  end
})

Biểu ngữ bám dính

Để bật biểu ngữ bám dính:

1. Mở Bảng điều khiển trò chơi và chuyển đến Advertising.
2. Vào Sticky banners và thiết lập việc hiển thị các biểu ngữ:

   • Đối với thiết bị di động:

     • Sticky banner in portrait orientation: Chọn vị trí của banner — At the bottom hoặc At the top.
     • Sticky banner in landscape orientation: Chọn vị trí của banner — At the bottom, At the top, hoặc On the right.

   • Đối với máy tính: Bật Sticky banner on the desktop. Biểu ngữ sẽ được hiển thị ở bên phải.

Theo mặc định, biểu ngữ bám dính sẽ xuất hiện khi khởi động và vẫn hiển thị trong toàn bộ phiên. Để đặt cấu hình thời gian hiển thị biểu ngữ:

1. Trong Sticky banners, kích hoạt Use the API to display a sticky-banner.
2. Thiết lập việc hiển thị biểu ngữ bằng các phương thức sau:
   • ysdk.adv.get_banner_adv_status() — hiển thị trạng thái của biểu ngữ.
   • ysdk.adv.show_banner_adv() — gọi biểu ngữ.
   • ysdk.adv.hide_banner_adv() — ần biểu ngữ.

Phương thức ysdk.adv.get_banner_adv_status() trả về giá trị sticky_adv_is_showing: boolean. Nếu sticky_adv_is_showing = false, phương thức ysdk.adv.get_banner_adv_status() có thể trả về trường tùy chọn reason với các nguyên nhân có thể:

• ADV_IS_NOT_CONNECTED — biểu ngữ không được bật.
• UNKNOWN — lỗi hiển thị quảng cáo ở phía Yandex.

Ví dụ

ysdk.adv.get_banner_adv_status(
  function (self, sticky_adv_is_showing, reason)
    if sticky_adv_is_showing then
      -- Biểu ngữ bám dính được hiển thị.
    elseif reason then
      -- Biểu ngữ dính không được hiển thị.
      print(reason)
    else
      ysdk.adv.show_banner_adv()
    end
  end
)