MobileAds

Kotlin |Java

class MobileAds

Lớp này 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 tạo.

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`	`disableMediationAdapterInitialization(context: Context!)` Gọi trước `initialize` hoặc yêu cầu quảng cáo đầu tiên để tắt quá trình khởi chạy bộ chuyển đổi dàn xếp.
`java-static InitializationStatus?`	`getInitializationStatus()` Lấy trạng thái khởi chạy SDK.
`java-static RequestConfiguration`	`getRequestConfiguration()` Lấy `RequestConfiguration` chung.
`java-static VersionInfo!`	`getVersion()` 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`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` Khởi chạy SDK Quảng cáo của Google trên thiết bị di động.
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` 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`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` Kiểm soát việc có bật mã nhận dạng bên thứ nhất của nhà xuất bản Google Mobile Ads SDK hay không (trước đây gọi là khoá cho cùng ứng dụng).
`java-static CustomTabsSession?`	`registerCustomTabsSession( context: Context, client: CustomTabsClient, origin: String, callback: CustomTabsCallback? )` Đăng ký một `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`	`registerWebView(webview: WebView)` Đăng ký một `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`	`setAppMuted(muted: Boolean)` Cho biết liệu âm thanh của ứng dụng có bị tắt tiếng hay không.
`java-static Unit`	`setAppVolume(volume: Float)` Đặt âm lượng âm thanh của ứng dụng.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` Đặ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 quá trình khởi chạy bộ chuyển đổi dàn xếp. Phương thức này là một noop 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 của bạn. Bạn chỉ nên gọi phương thức này nếu đưa bộ chuyển đổi dàn xếp vào ứng dụng của mình, nhưng không có ý định sử dụng tính năng dàn xếp của Google trong phiên hoạt động này của ứng dụng (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 chung.

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 khi gọi hàm này.

khởi động

@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.

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ễ cho 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 động

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.

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ễ cho 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!`	Một 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 có bật mã nhận dạng bên thứ nhất của nhà xuất bản Google Mobile Ads SDK hay không (trước đây gọi là khoá cho cùng ứng dụng).

Mã nhận dạng được bật theo mặc định. Khi bị vô hiệu hoá, chế độ cài đặt sẽ được duy trì trong các phiên sử dụng ứ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 duy trì thành công. Sai nếu không duy trì được.

registerCustomTabsSession

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

Đăng ký một 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 phiên bản của CustomTabsSession và việc chạy lại thao tác này 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 Digital Asset Link để xác minh.
`callback: CustomTabsCallback?`	không bắt buộc `CustomTabsCallback` để nhận cuộc gọi lại từ `CustomTabsSession`.

Giá trị trả về
`CustomTabsSession?`	`CustomTabsSession` sẽ được dùng cho Custom Tabs Intent khi mở trang Custom Tabs.

registerWebView

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

Đăng ký một 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 tiếng 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à false.

setAppVolume

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

Đặt âm lượng âm thanh của ứng dụng. Ảnh hưởng đến âm lượng của tất cả quảng cáo so với các đầu ra âm thanh 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 dấu phẩy động từ 0 (tắt tiếng) đến 1,0 (âm lượng tối đa 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.

Các 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`	Một lệnh gọi lại sẽ được gọi khi trạng thái sẵn có của quảng cáo thay đổi cho từng cấu hình tải trước.