MobileAds

class MobileAds

Lớp chứa logic áp dụng cho toàn bộ SDK Quảng cáo của Google trên thiết bị di động. Hiện tại, các phương thức duy nhất trong đó được dùng để khởi chạy.

Tóm tắt

Hằng số
const String!
ERROR_DOMAIN = "com.google.android.gms.ads"

Tên miền lỗi mặc định cho SDK quảng cáo của Google trên thiết bị di động.

Hàm công khai
java-static Unit

Gọi trước initialize hoặc yêu cầu quảng cáo đầu tiên để tắt tính năng khởi chạy bộ chuyển đổi dàn xếp.
java-static InitializationStatus?

Lấy trạng thái khởi chạy SDK.
java-static RequestConfiguration

Lấy RequestConfiguration toàn cục.
java-static VersionInfo!

Lấy phiên bản bên ngoài (ví dụ: 20.6.0) của SDK quảng cáo của Google trên thiết bị di động.
java-static Unit
@RequiresPermission(value = Manifest.permission.INTERNET)
initialize(context: Context!)

Khởi chạy SDK quảng cáo của Google trên thiết bị di động.
java-static Unit

Khởi chạy SDK quảng cáo của Google trên thiết bị di động.
java-static Unit

Mở giao diện người dùng của công cụ kiểm tra quảng cáo.
java-static Unit
openDebugMenu(context: Context!, adUnitId: String!)

Mở trình đơn gỡ lỗi.
java-static Boolean

Kiểm soát việc liệu mã nhận dạng bên thứ nhất của nhà xuất bản SDK Quảng cáo của Google trên thiết bị di động (trước đây gọi là khoá cho cùng ứng dụng) có được bật hay không.
java-static CustomTabsSession?
registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
)

Đăng ký CustomTabsClient bằng SDK Quảng cáo của Google trên thiết bị di động để cải thiện khả năng kiếm tiền từ quảng cáo trong ứng dụng của quảng cáo trong CustomTabsSession này.
java-static Unit

Đăng ký WebView bằng SDK Quảng cáo của Google trên thiết bị di động để cải thiện khả năng kiếm tiền từ quảng cáo trong ứng dụng của quảng cáo trong WebView này.
java-static Unit

Cho biết liệu âm thanh của ứng dụng có bị tắt hay không.
java-static Unit

Đặt âm lượng của ứng dụng.
java-static Unit

Đặt RequestConfiguration chung sẽ được dùng cho mọi AdRequest trong phiên của ứng dụng.
java-static Unit
startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
)

Hàm này không còn được dùng nữa.

Thay vào đó, hãy sử dụng start hoặc start.

Hằng số

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

Tên miền lỗi mặc định cho SDK quảng cáo của Google trên thiết bị di động.

Hàm công khai

disableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

Gọi trước initialize hoặc yêu cầu quảng cáo đầu tiên để tắt tính năng khởi chạy bộ chuyển đổi dàn xếp. Phương thức này là một phương thức rỗng sau khi initialize hoặc yêu cầu quảng cáo đầu tiên được thực hiện.

Cảnh báo: Việc gọi phương thức này có thể ảnh hưởng tiêu cực đến hiệu suất dàn xếp. Bạn chỉ nên gọi phương thức này nếu đưa trình chuyển đổi dàn xếp vào ứng dụng nhưng không có kế hoạch sử dụng tính năng dàn xếp của Google trong phiên ứng dụng này (ví dụ: bạn đang chạy thử nghiệm A/B).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

Lấy trạng thái khởi chạy SDK.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Lấy RequestConfiguration toàn cục.

getVersion

java-static fun getVersion(): VersionInfo!

Lấy phiên bản bên ngoài (ví dụ: 20.6.0) của SDK quảng cáo của Google trên thiết bị di động.

Bạn không cần gọi initialize trước hàm này.

khởi chạy

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

Khởi chạy SDK quảng cáo của Google trên thiết bị di động.

Hãy gọi phương thức này càng sớm càng tốt sau khi ứng dụng khởi chạy để giảm độ trễ trên yêu cầu quảng cáo đầu tiên của phiên.

Nếu phương thức này không được gọi, yêu cầu quảng cáo đầu tiên sẽ tự động khởi chạy SDK Quảng cáo của Google trên thiết bị di động.

Thông số
context: Context!

Context mà SDK đang chạy.

khởi chạy

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

Khởi chạy SDK quảng cáo của Google trên thiết bị di động.

Hãy gọi phương thức này càng sớm càng tốt sau khi ứng dụng khởi chạy để giảm độ trễ trên yêu cầu quảng cáo đầu tiên của phiên.

Nếu phương thức này không được gọi, yêu cầu quảng cáo đầu tiên sẽ tự động khởi chạy SDK Quảng cáo của Google trên thiết bị di động.

Thông số
context: Context!

Hoạt động Context mà SDK đang chạy.
listener: OnInitializationCompleteListener!

Lệnh gọi lại sẽ được gọi khi quá trình khởi chạy hoàn tất.

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

Mở giao diện người dùng của công cụ kiểm tra quảng cáo.

openDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

Mở trình đơn gỡ lỗi. Bạn phải gọi initialize trước hàm này.

Thông số
context: Context!

Hoạt động Context mà SDK đang chạy.
adUnitId: String!

Mọi mã đơn vị quảng cáo Ad Manager được liên kết với ứng dụng của bạn.

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

Kiểm soát việc liệu mã nhận dạng bên thứ nhất của nhà xuất bản SDK Quảng cáo của Google trên thiết bị di động (trước đây gọi là khoá cho cùng ứng dụng) có được bật hay không.

Mã nhận dạng được bật theo mặc định. Khi bị tắt, chế độ cài đặt này sẽ được duy trì trên các phiên ứng dụng và mã nhận dạng sẽ bị xoá.

Bạn phải gọi initialize trước hàm này.

Thông số
enabled: Boolean

boolean true nếu mã nhận dạng bên thứ nhất của nhà xuất bản được bật, false nếu không.
Giá trị trả về
Boolean

true nếu quyết định được lưu trữ thành công. Sai nếu không thể duy trì.

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

Đăng ký CustomTabsClient bằng SDK Quảng cáo của Google trên thiết bị di động để cải thiện khả năng kiếm tiền từ quảng cáo trong ứng dụng của quảng cáo trong CustomTabsSession này. Thao tác này sẽ chỉ tạo một thực thể của CustomTabsSession và việc chạy lại sẽ ghi đè phiên hiện có.

Thông số
context: Context

Context mà SDK đang chạy.
client: CustomTabsClient

CustomTabsClient dùng để tạo thực thể CustomTabsSession.
origin: String

Chuỗi được dùng làm nguồn gốc trên Đường liên kết đến tài sản kỹ thuật số để xác minh.
callback: CustomTabsCallback?

CustomTabsCallback không bắt buộc để nhận lệnh gọi lại từ .
Giá trị trả về
CustomTabsSession?

Phiên bản CustomTabsSession sẽ được dùng cho Ý định thẻ tuỳ chỉnh khi mở trang Thẻ tuỳ chỉnh.

registerWebView

java-static fun registerWebView(webview: WebView): Unit

Đăng ký WebView bằng SDK Quảng cáo của Google trên thiết bị di động để cải thiện khả năng kiếm tiền từ quảng cáo trong ứng dụng của quảng cáo trong WebView này.

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

Cho biết liệu âm thanh của ứng dụng có bị tắt hay không. Ảnh hưởng đến trạng thái tắt tiếng ban đầu của tất cả quảng cáo.

Cảnh báo: Việc tắt tiếng ứng dụng sẽ làm giảm khả năng đủ điều kiện của quảng cáo dạng video và có thể làm giảm doanh thu từ quảng cáo của ứng dụng. Bạn chỉ nên sử dụng API này nếu ứng dụng của bạn cung cấp chế độ kiểm soát tắt tiếng tuỳ chỉnh cho người dùng và bạn nên phản ánh quyết định tắt tiếng của người dùng trong API này.

Thông số
muted: Boolean

true nếu ứng dụng bị tắt tiếng, false nếu không. Giá trị mặc định là sai.

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

Đặt âm lượng của ứng dụng. Ảnh hưởng đến âm lượng của tất cả quảng cáo so với âm thanh đầu ra khác.

Cảnh báo: Việc giảm âm lượng của ứng dụng sẽ làm giảm khả năng đủ điều kiện của quảng cáo dạng video và có thể làm giảm doanh thu từ quảng cáo của ứng dụng. Bạn chỉ nên sử dụng API này nếu ứng dụng của bạn cung cấp các chế độ kiểm soát âm lượng tuỳ chỉnh cho người dùng và bạn nên phản ánh lựa chọn âm lượng của người dùng trong API này.

Thông số
volume: Float

âm lượng dưới dạng số thực từ 0 (tắt tiếng) đến 1.0 (âm lượng đầy đủ của nội dung nghe nhìn). Giá trị mặc định là 1.0
Gửi
java.lang.IllegalArgumentException

nếu âm lượng nằm ngoài phạm vi hợp lệ

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

Đặt RequestConfiguration chung sẽ được dùng cho mọi AdRequest trong phiên của ứng dụng.

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

Bắt đầu tải trước quảng cáo cho các cấu hình đã cho.

API tải trước quảng cáo đang ở giai đoạn thử nghiệm alpha có giới hạn. Vui lòng liên hệ với người quản lý tài khoản của bạn để biết thêm thông tin.

Thông số
context: Context

Context mà SDK đang chạy.
preloadConfigurations: (Mutable)List<PreloadConfiguration!>

Cấu hình để tải trước quảng cáo.
preloadCallback: PreloadCallback

Lệnh gọi lại được gọi khi tình trạng có quảng cáo thay đổi cho từng cấu hình tải trước.